Metadata-Version: 2.4
Name: easylcsc4kicad
Version: 0.1.0
Summary: Search LCSC and EasyEDA for schematics and footprints
Project-URL: Homepage, https://github.com/rakesh/EasyLCSC4KiCAD
Project-URL: Issues, https://github.com/rakesh/EasyLCSC4KiCAD/issues
Author: Rakesh Chowdhury
License-Expression: MIT
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
Requires-Python: >=3.10
Requires-Dist: kicadmodtree>=1.1.2
Requires-Dist: requests>=2.28
Description-Content-Type: text/markdown

# EasyLCSC4KiCad

A CLI tool to search for components on LCSC/EasyEDA and download footprints, symbols, and 3D models directly for KiCad.

## Installation

```bash
pip install easylcsc4kicad
```

Or using uv:

```bash
uv pip install easylcsc4kicad
```

## Usage

### Search

Search for components by keyword.

```bash
# Basic search
easylcsc4kicad search "ESP32-S3"

# Search with pagination
easylcsc4kicad search "STM32F103" --page 1 --page-size 10
```

### Download

Download component footprint, symbol, and 3D models using the LCSC ID.

```bash
# Download a specific component
easylcsc4kicad download C1337258

# Download to a specific directory (default: easylcsc_lib)
easylcsc4kicad download C1337258 -o ./my_libs

# Download multiple components
easylcsc4kicad download C1337258 C2980300

# Download without generating footprint or symbol
easylcsc4kicad download C1337258 --no-footprint --no-symbol
```

## Generated Files

The tool generates KiCad files in the specified output directory:

```
output_dir/
├── footprint/
│   ├── component_name.kicad_mod
│   └── packages3d/
│       └── component_name.step
└── symbol/
    └── component_name.kicad_sym
```