Skip to content
Projects

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.

How these counts are measured

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 & Media

README.en.md

Original

LCSC3D

简体中文 | English

LCSC3D: Embedded 3D Models and AD / KiCad Library Export

Release Windows build Windows License: AGPL-3.0 Support LCSC3D

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

LCSC3D workspace: Type-C 3D preview, enabled footprint model binding, Messages navigation and download progress

Quick start

  1. Download LCSC3D.exe from Releases and run it on Windows 10/11 x64.
  2. 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, C456013 and click Load list.
  3. Click a part to preview it, check the parts to export, and choose an output folder.
  4. Choose Altium Designer / KiCad under Export to and select model and library formats. Enable Lib → Merge to combine libraries and set their names independently.
  5. 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

Product search, inline quantities and price tiers

Official category browser

Official category browser

Product filters and component parameters

Product filters and component parameters

Native cart, quantity increments and batch results

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
User validation: Type-C 3D model and footprint in an AD PcbLib User validation: another Type-C model and pads in AD
KiCad PCB 3D view KiCad underside and pads
User validation: Type-C model and PCB in KiCad User validation: Type-C underside pads and mounting pins in KiCad

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
User-provided KiCad IC symbol with pins and solid body-background fill User-provided KiCad MOSFET symbol with pin numbers
Footprint with vias Custom pad footprint
User-provided KiCad footprint with nine pads and four vias User-provided KiCad footprint with custom pads and silkscreen

Footprint with a thermal pad

User-provided KiCad footprint with thermal pad 15 and two rows of pins

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
User-provided AD screenshot showing a SchLib symbol and pins User-provided AD screenshot showing a 20-pad PcbLib footprint

User-provided AD PCB project with SchLib and PcbLib references

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
Multi-unit schematic symbol in AD BGA footprint in AD
Pads and copper regions Custom pad geometry
Pad and copper-region details in AD Custom pads and footprint copper regions in AD
Connector footprint 3D view after importing STEP
2D connector footprint in AD AD 3D view after manually importing STEP
Connector 3D view Another connector view
Connector with a manually added STEP model in AD Another view of the manually added connector STEP model in AD
Type-C 3D view Type-C underside
Type-C connector after manually adding STEP in AD Underside of the manually added Type-C STEP model in AD

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.