JLCImport

JLCImport is a KiCad action plugin that imports symbols, footprints, and 3D models from 立创商城(szlcsc.com)/JLCPCB into your project or global library.

Features

• Imports symbol, footprint, and 3D model data in one step.
• Works with project libraries or global KiCad libraries.
• Includes searchable part lookup with stock and type filtering.
• Handles modern KiCad formats (8/9/10).
• Ships with plugin, CLI, GUI, and TUI workflows.

Install

1. Open KiCad and go to Tools > Plugin and Content Manager
2. Open repository settings and add: https://github.com/harry10086/kicad_jlcimport/releases/latest/download/repository.json
3. Refresh repositories
4. Install JLCImport

Fallback: install from ZIP using Releases (JLCImport-vX.X.X.zip, not "Source code" ZIP).

For local development, link src/kicad_jlcimport into your KiCad plugin directory and restart KiCad.

Use In KiCad

Open PCB Editor > Tools > External Plugins > JLCImport.

1. Search for a part.
2. Pick Project or Global destination.
3. Set library name if needed.
4. Click Import.

If sym-lib-table or fp-lib-table is created for the first time, reopen the project once.

CLI, GUI, And TUI

This repo also ships standalone tools:

• jlcimport-cli for scripts and batch work.
• jlcimport-gui for a desktop app outside KiCad.
• jlcimport-tui for terminal workflow.

Quick examples:

jlcimport-cli search "100nF 0402" -t basic
jlcimport-cli import C427602 -p /path/to/project
jlcimport-gui -p /path/to/project
jlcimport-tui --kicad-version 9

Create or activate the local environment with:

source install.sh      # macOS/Linux
. .\install.ps1        # Windows PowerShell

Recent Updates

Based on recent git history:

• v1.5.10：修复：在导入元件时使用KiCad已有的相同封装，属性里 datasheets 链接指向新元件的链接，不再是原来封装的链接。
• v1.5.9：增加：导入 3D 封装格式可选。默认选择 wrl 格式，因为文件体积小。
• v1.5.8: 增加：导入元件封装时可以编辑元件值 value，默认是厂家型号，对于电阻电容电感这些就不合适，现在导入界面就可以先手动修改了。
• v1.5.7: 修复：立创商城无法预览图片。因为商品详情页面增加了 阿里云 WAF (Web Application Firewall) 进行反爬虫保护。
• v1.5.6：优化搜索 Package 筛选下拉框显示宽度。
• v1.5.5：合并了上游 v1.6.1、v1.6.2 和 v1.6.3 的修复补丁。修复了网络请求 SSL 问题、修复了包含圆角（SVG Arc）的 EasyEDA 封装解析错误、优化了内部封装解析逻辑，并修复了全局库注册和 3D 模型路径自定义的问题。
• v1.5.4：修复 bug：导入立创库时因为单位转换（mm<->mil）导致尺寸出现小数点后 .0001 这样的尺寸偏移，原理图符号封装会因为对不齐栅格而无法连线，PCB 封装倒是影响不大。 搜索框增加两个按钮，方便输入 Ω 和 μ 两个希腊字母。
• v1.5.3: 修复无法浏览 KiCAD10 内置库的错误，修复了部分用户库封装无法预览的问题，并更新了依赖。
• v1.5.2: 优化搜索结果加载数量（60/30，因为立创每页显示 30 个元器件），放大窗口，清理UI和CI。
• v1.5.1: 基线更新到了1.5.0，并修复了搜索结果和网站数量不一致的问题。 增加了符号图和封装图的预览，3D 预览不好做，暂时不做。
• v1.5.0: jvanderberg#86
• v1.4.1: 把 LCSC 改成了国内 szlcsc.com，速度更快，库存和价格也都是国内的。但每次加载数量减少到100。 修改了加载图标。 修改了预览图片的关闭按钮。 价格都改成了人民币 ¥，库存也都是国内库存。
• v1.4.0: KiCad footprint browser with live preview, footprint/3D model renaming, KiCad library footprint reuse, SpinnerOverlay deadlock fix, multi-unit symbol crash fix, and pinned ruff version.
• v1.2.10: fixed Python 3.9 annotation evaluation in library handling.
• v1.2.9: made the plugin dialog non-modal and added multi-unit symbol support.
• v1.2.8: hardened SVG path parsing for better import reliability.
• v1.2.x: continued fixes for datasheets, rendering, path handling, and KiCad 9 support.

Configuration

The plugin stores settings in jlcimport.json in your KiCad config directory. Right now this is mainly the library name preference, shared across plugin, CLI, and TUI.

Compatibility

The project targets KiCad 8, 9, and 10.

For the plugin inside KiCad, no extra Python packages are required.

For standalone tools:

• GUI needs wxPython (pip install -e '.[gui]')
• TUI needs Python 3.10+ and textual dependencies (pip install -e '.[tui]')

Troubleshooting

On Windows with KiCad 9, symbol preview may fail if wx.svg._nanosvg is missing. Use the fix in fixes/README.md.

Detailed Documentation

• Full usage guide
• 3D model notes
• Architecture overview
• Visual comparison output

License

MIT