Travelerrrrrr/LCSC3D
Travelerrrrrr/LCSC3D has 140 GitHub stars and 18 forks. GitHot measured 0 stars in 24 hours, +1 in 7 days, and +14 in 15 days. Last checked 2026-11-18 03:37 UTC. Last push 2026-10-31.
Measured star growth
- in 24h
- 0
- in 7 days
- +1
- in 15 days
- +14
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Windows 便携工具:按立创 C 编号批量下载 STEP/OBJ 3D 模型,导出 Altium Designer SchLib/PcbLib 元件库,预览 3D、符号与封装,支持自更新。
Creative & MediaREADME.en.md
Original
简体中文 | English
LCSC3D: Embedded 3D Models and AD / KiCad Library Export
Find parts through LCSC search, mainland account favorites or C-numbers, and export AD / KiCad symbols and footprints with attached 3D models in batches. Download original STEP / OBJ files separately when needed.
LCSC3D is a portable Windows tool for hardware development, PCB design and mechanical fit checks. Download and run LCSC3D.exe; no Python installation is required. Generating libraries does not require the target EDA software to be installed.
3D models are attached to footprints by default. AD PcbLib and KiCad 9/10 footprints embed STEP models, keeping the model with the library file. KiCad 8 uses portable external models. The original STEP size is preserved and the source placement anchor is converted before applying the official pose.
Download for Windows · Full source package · User guide (Chinese) · Report an issue

Quick start
- Download
LCSC3D.exefrom Releases and run it on Windows 10/11 x64. - For English, open 设置 → 外观 → 语言 / Language, select English, and click 保存 / Save. Search through LCSC International and add checked products to the download list, or enter
C2040, C20197, C456013and click Load list. - Click a part to preview it, check the parts to export, and choose an output folder.
- Choose Altium Designer / KiCad under Export to and select model and library formats. Enable Lib → Merge to combine libraries and set their names independently.
- Click Download, then Part folder. Open SchLib / PcbLib in AD, or add the symbol file and footprint directory through KiCad's library managers.
Merging again uses the current selection. Normal and merged AD / KiCad exports replace same-name libraries after successful generation. KiCad replaces the entire same-name .pretty directory, removing old members. Include every part you want to retain. Both targets offer Lib → Append to preserve existing libraries and add parts, generate project libraries, or import specified libraries directly from the configuration page.
Mainland storefront: selection, information and purchasing
The native storefront brings Search products, My favorites, Cart and My orders into one workspace, connecting part selection and purchasing with library export.
| Page | What it provides |
|---|---|
| Search products | Search by C-number, MPN or keyword, browse official categories, and filter by brand, package, component parameters, price and stock. View photos, specifications, datasheets and price tiers; keep checked parts across pages. |
| My favorites | Read your mainland account favorites, find saved parts, and add or remove favorites. Add checked parts to the download list or cart. |
| Cart | View photos, quantities, unit prices, subtotals and stock status. Edit quantities directly with automatic saving, remove items, or add parts to the download list. Open the official cart in your system browser to confirm the order and pay. |
| My orders | Search orders by keyword and status. Open an order within the same table area to view purchased parts and other items, photos, quantities, prices and amounts. Add checked parts to the download list and return without losing your list position. Full order details can be opened in the external browser. |
Search and favorites support inline purchase quantities with each part's minimum and increment. Search prices follow the entered quantity, with all price tiers still available to inspect. A row's context menu offers Add to download list, Add to favorites and Add to cart; batch cart additions use each row's quantity.
Add checked parts from search, favorites, cart or orders to the download list. C-numbers are deduplicated before preview and AD / KiCad or model export. Drag column borders to resize and double-click product photos to view originals.
Product rows show the model, brand, package, category, description and available key parameters together; hover to read the full introduction. Category submenus start collapsed. Search and orders use numbered pages, ellipses and previous/next arrows, with an outlined current page.
Public search requires no login; favorites, cart and orders use a mainland LCSC account. These account purchasing pages are available in Chinese mode. English mode uses LCSC International search, with international account management on LCSC.com.
User-provided storefront screenshots. Click an image to view the original.
Product search, inline quantities and price tiers
Official category browser
Product filters and component parameters
Native cart, quantity increments and batch results
Embedded 3D models
Select AD PcbLib or KiCad Footprints and leave Attach 3D models to footprints enabled. LCSC3D fetches the required official STEP and writes its placement into the footprint. You do not need to select standalone STEP downloads or attach each model manually in the EDA application.
| Target | Model storage | Moving the library |
|---|---|---|
| Altium Designer | STEP embedded in .PcbLib |
The model stays inside the footprint library |
| KiCad 9 / 10 | STEP embedded in .kicad_mod |
The model stays with the footprint file; keep the .pretty library structure |
| KiCad 8 | External STEP in .pretty/LCSC3D.3dshapes/ |
Keep the entire .pretty folder and model directory |
These user-provided AD and KiCad screenshots show the exported Type-C models. Click an image to view the original.
| AD embedded model example 1 | AD embedded model example 2 |
|---|---|
![]() |
![]() |
| KiCad PCB 3D view | KiCad underside and pads |
|---|---|
![]() |
![]() |
A missing or failed 3D model does not discard an available 2D footprint. A storefront product does not guarantee that official symbol, footprint or model data is available. See the user guide (Chinese) and placement details (Chinese).
Symbol and footprint export
| Feature | Altium Designer | KiCad 8+ |
|---|---|---|
| Formats | Native .SchLib / .PcbLib |
.kicad_sym / .kicad_mod files in .pretty |
| Individual and merged libraries | Independent symbol/footprint merging and names, optional per-part copies | Same workflow, with shared-footprint reuse |
| Pin electrical types | All exported pins are Passive | Source types by default or a uniform override; unsupported types become Unspecified |
| Symbol style | JLC / AD, selected in the preview and applied to export | KiCad style; square rectangles with solid body-background fill |
| Footprint geometry | Pads, holes, slots, copper regions, graphics and native vias | Pads, holes, slots, copper regions and graphics; vias retained as unnumbered plated through-holes |
| Append and projects | Append to libraries, customize project folders/names and import into .PrjPcb |
Same configuration flow; append to .kicad_sym / .pretty and register in .kicad_pro project library tables |
In KiCad, use the exported footprint library name as its nickname, such as LCSC3D, so symbol footprint references resolve. Footprint vias retain their positions, drills and copper rings; confirm their net assignment in the PCB. Conversion approximations appear in export results.
Both targets support multi-unit symbols, string pin numbers and common surface-mount / through-hole footprints, with available 3D models attached by default. AD IntLib generation is not supported.
Detailed operations are in the user guide (Chinese).
KiCad export examples
These user-provided KiCad screenshots show exported symbols and footprints. Click any image to view the original.
| IC symbol | MOSFET symbol |
|---|---|
![]() |
![]() |
| Footprint with vias | Custom pad footprint |
|---|---|
![]() |
![]() |
Footprint with a thermal pad
AD export examples
These previously shared AD screenshots show exported symbols, footprints and library references in a PCB project. Expand the gallery for additional symbol, footprint and 3D examples.
| Schematic library in AD | Footprint library in AD |
|---|---|
![]() |
![]() |
More AD examples: multi-unit symbols, BGA footprints and manually added STEP models
The 3D views below show the result after manually adding a STEP model in AD. These historical examples predate the automatic model binding added in the development build.
| Multi-unit schematic symbol | BGA footprint |
|---|---|
![]() |
![]() |
| Pads and copper regions | Custom pad geometry |
|---|---|
![]() |
![]() |
| Connector footprint | 3D view after importing STEP |
|---|---|
![]() |
![]() |
| Connector 3D view | Another connector view |
|---|---|
![]() |
![]() |
| Type-C 3D view | Type-C underside |
|---|---|
![]() |
![]() |
Intermediate representation and exporters
flowchart LR
A[Official component JSON] --> B[Shared importer]
B --> C[Versioned EDA intermediate representation]
C --> D[AD exporter]
C --> E[KiCad exporter]
D --> F[SchLib / PcbLib]
E --> G[kicad_sym / pretty]
The intermediate representation stores symbols and units, pin names and numbers, connection directions and electrical types, graphics, text, layers, pads, drills, slots, vias and source 3D associations. AD and KiCad exporters read the same data and generate libraries according to each target's format and settings.
It has independent versioning and compatibility rules: new optional fields have defaults, existing fields retain their meaning, and older data remains readable. Critical geometry that cannot be converted reliably produces an explicit error. Future EDA support can reuse the importer and component data while adding an exporter for the target's styling and library rules.
See the architecture and compatibility guide (Chinese) for details.
Previews and batch downloads
| Feature | What it provides |
|---|---|
| Four previews | Switch between 3D models, symbols, footprints and product photos, with zoom, pan and fit-to-window controls. |
| Batch downloads | Combine STEP / OBJ with the selected target's two library formats; track per-part results, stop and retry. |
| Library organization | Reuse identical footprints and optionally retain individual parts. Without per-part copies, models use a shared library-name_3D folder. |
Parts without 3D models may still have exportable symbols and footprints. One format failing does not discard other successful resources. Availability depends on the official data and task results.
Settings, diagnostics and updates
Settings provides Simplified Chinese / English, system / light / dark themes, colors, button text colors and 10–24px text sizes. The interface follows the system font by default, with an option to choose an installed font. English uses LCSC International with English descriptions and USD prices. International sign-in and favorites are managed on LCSC.com; mainland and international account sessions are separate.
Storefront and update requests can independently use the system proxy or direct connections. Diagnostics lets you choose log levels, open, package or clear logs. Logs cover downloads, AD / KiCad conversion, file replacement and recovery. Diagnostic packages exclude credentials, and logging and crash capture continue after clearing. AD / KiCad append and project library table changes support automatic backups, available under Settings → Backups.
Settings, sessions, logs, caches and update data live under %LOCALAPPDATA%/LCSC3D/. Model and library output folders are chosen separately.
Startup checks for stable updates in the background. Use Settings → About & support → Check for updates for a manual check. Download & restart installs an update after SHA-256 verification, retaining settings and exported files. Releases include LCSC3D.exe, full source in LCSC3D.zip, and SHA256SUMS.txt.
Requirements and limitations
Downloads and online previews need internet access. 3D preview needs a graphics driver supporting WebGL. KiCad 8 / 9 / 10 have been verified; see the verification record (Chinese) for scope.
Preview and export assist selection and design. Check pins, electrical types, dimensions and footprints against the datasheet before production use.
Run from source and build
Development environment: Windows x64 and Python 3.12.
git clone https://github.com/Travelerrrrrr/LCSC3D.git
cd LCSC3D
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r app/requirements-test.txt
.\.venv\Scripts\python.exe app/main.py
Run app/build.ps1 to test and build the portable application. See the contribution guide (Chinese) for development and release procedures.
License, data sources and support
Project code uses AGPL-3.0-or-later; dependency attribution is in the third-party notices. Symbols, footprints and models come from the JLCEDA Official Library and the EasyEDA Official Library. The software license does not replace the component data's copyright or usage terms.
Report problems through Issues, including the C-number, version, selected formats, error and screenshots. Stars and voluntary sponsorship are welcome.
Acknowledgments
Thanks to uPesy/easyeda2kicad.py for ideas and reference material on converting EasyEDA / LCSC components to KiCad.

























