Skip to main content

A Python package for converting electronic components from LCSC or EasyEDA to ato files, facilitating integration with Kicad libraries.

Project description

easyeda2kicad v0.6.6


PyPI version License Downloads Python versions Git hook: pre-commit Code style: black Imports: isort security: bandit


A Python script that converts any electronic components from EasyEDA or LCSC to a Kicad library including 3D model in color. This tool will speed up your PCB design workflow especially when using JLCPCB SMT assembly services. It supports library formats for both Kicad v6.x and Kicad v5.x.

🎆 Sponsor and Support

If this tool has saved you a lot of time when designing a PCB, please consider supporting the project by :

💾 Installation

pip install easyeda2kicad

💻 Usage

# For symbol + footprint + 3d model (with --full argument)
easyeda2kicad --full --lcsc_id=C2040
# For symbol + footprint + 3d model
easyeda2kicad --symbol --footprint --3d --lcsc_id=C2040
# For symbol + footprint
easyeda2kicad --symbol --footprint --lcsc_id=C2040
# For symbol only
easyeda2kicad --symbol --lcsc_id=C2040
# For footprint only
easyeda2kicad --footprint --lcsc_id=C2040
# For 3d model only
easyeda2kicad --3d --lcsc_id=C2040
# For symbol in Kicad v5.x legacy format
easyeda2kicad --symbol --lcsc_id=C2040 --v5

By default, all librairies are saved in C:/Users/your_name/Documents/Kicad/easyeda2kicad/, with :

  • easyeda2kicad.kicad_sym file for Kicad v6.x symbol library
  • easyeda2kicad.lib file for Kicad v5.x legacy symbol library
  • easyeda2kicad.pretty/ folder for footprint libraries
  • easyeda2kicad.3dshapes/ folder for 3d models

If you want to save components symbol/footprint in your own libs, you can specify the output lib path by using --output option.

easyeda2kicad --full --lcsc_id=C2040 --output ~/libs/my_lib

This command will save:

  • the symbol in ~/libs/my_lib.kicad_sym file for symbol library. The file will be created if it doesn't exist.
  • the footprint in ~/libs/my_lib.pretty/ folder for footprint libraries. The folder will be created if it doesn't exist.
  • the 3d models in ~/libs/my_lib.3dshapes/ folder for 3d models. The folder will be created if it doesn't exist.

You can use the option --overwrite to update a component symbol/footprint that is already in a Kicad library (generated by easyeda2kicad)

easyeda2kicad --symbol --footprint --lcsc_id=C2040 --output ~/libs/my_lib --overwrite

By default, easyeda2kicad will generate a symbol library for Kicad v6.x (.kicad_sym). You can generate a symbol lib in legacy format for Kicad v5.x (.lib) using --v5 argument.

easyeda2kicad --symbol --lcsc_id=C2040 --v5

🔗 Add libraries in Kicad

These are the instructions to add the default easyeda2kicad libraries in Kicad. Before configuring KiCad, run the script at least once to create lib files. For example :

easyeda2kicad --symbol --footprint --lcsc_id=C2040
  • In KiCad, Go to Preferences > Configure Paths, and add the environment variables EASYEDA2KICAD :
    • Windows : C:/Users/your_username/Documents/Kicad/easyeda2kicad/,
    • Linux : /home/your_username/Documents/Kicad/easyeda2kicad/
  • Go to Preferences > Manage Symbol Libraries, and Add the global library easyeda2kicad : ${EASYEDA2KICAD}/easyeda2kicad.kicad_sym
  • Go to Preferences > Manage Footprint Libraries, and Add the global library easyeda2kicad : ${EASYEDA2KICAD}/easyeda2kicad.pretty
  • Enjoy :wink:

🔥 Important Notes

WARRANTY

The correctness of the symbols and footprints converted by easyeda2kicad can't be guaranteed. Easyeda2kicad speeds up custom library design process, but you should remain careful and always double check the footprints and symbols generated.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

easyeda2ato-0.1.1-py3-none-any.whl (43.2 kB view details)

Uploaded Python 3

File details

Details for the file easyeda2ato-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: easyeda2ato-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 43.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.6

File hashes

Hashes for easyeda2ato-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 961aac2e4e82dfb7ee85dc1928e176068eb92b3d74cd149be44d08203fb8d776
MD5 090857965a7fcb4e65633e563525454c
BLAKE2b-256 43ab6be759453963bbcc7ad9f7c1e6b2f295096050f0fd7da81c857417d20974

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page