Skip to main content
Command Line Interface

tsci search

tsci search finds footprints and packages from across the tscircuit ecosystem.

Options​

  • --kicad – search KiCad footprints
  • --jlcpcb – search JLCPCB components
  • --lcsc – alias for --jlcpcb
  • --tscircuit – search tscircuit registry packages
  • --json – output search results as JSON

When no filter options are provided, all sources are searched.

Usage​

$ tsci search resistor
Found 10 footprint(s) from KiCad:
 1. Resistor_SMD/R_01005_0402Metric_Pad0.57x0.30mm_HandSolder
 2. Resistor_SMD/R_01005_0402Metric
 3. Resistor_SMD/R_0201_0603Metric_Pad0.64x0.40mm_HandSolder
 4. Resistor_SMD/R_0201_0603Metric
 5. Resistor_SMD/R_0402_1005Metric_Pad0.72x0.64mm_HandSolder
 6. Resistor_SMD/R_0402_1005Metric
 7. Resistor_SMD/R_0603_1608Metric_Pad0.98x0.95mm_HandSolder
 8. Resistor_SMD/R_0603_1608Metric
 9. Resistor_SMD/R_0612_1632Metric_Pad1.18x3.40mm_HandSolder
10. Resistor_SMD/R_0612_1632Metric
Found 11 package(s) in the tscircuit registry:
1. seveibar/usb-c-flashlight (vundefined) - Stars: 5 - A compact USB-C powered push button board with a red LED, utilizing a single current-limiting resistor for the LED indicator.
2. ArnavK-09/OPT4048DTSR (vundefined) - Stars: 3 - Sparkfun schematic with an 8-pin SOIC-8 IC (OPT4048) connected to a 3.3V power supply, ground, I2C bus lines (SCL, SDA), an address pin, an interrupt pin, plus a pull-up resistor and a decoupling capacitor.
...

Use any search term to discover related footprints or published projects.

JSON Output Example​

You can output search results as JSON by using the --json flag.

$ tsci search --jlcpcb "RP2040" --json
{
  "query": "RP2040",
  "results": [
    {
      "source": "jlcpcb",
      "lcsc": 2040,
      "mfr": "RP2040",
      "package": "LQFN-56(7x7)",
      "is_basic": false,
      "is_preferred": false,
      "description": "",
      "stock": 42449,
      "price": 0.872857143
    },
    {
      "source": "jlcpcb",
      "lcsc": 5350143,
      "mfr": "RP2040-Zero",
      "package": "-",
      "is_basic": false,
      "is_preferred": false,
      "description": "",
      "stock": 51,
      "price": 5.091428571
    }
  ]
}