Skip to main content

JLC2KiCad_lib is a python script that generate a component library (symbol, footprint and 3D model) for KiCad from the JLCPCB/easyEDA library.

Project description

JLC2KiCadLib

PyPI version Python versions Downloads Code style: black License: MIT

JLC2KiCadLib is a python script that generate a component library (symbol, footprint and 3D model) for KiCad from the JLCPCB/easyEDA library. This script requires Python 3.6 or higher.

Exemple

easyEDA origin KiCad result
JLCSymbol KiCadSymbol
JLCFootprint KiCadFootprint
JLC3Dmodel KiCad3Dmodel

Installation

Install using pip:

pip install JLC2KiCadLib

Install from source:

git clone https://github.com/TousstNicolas/JLC2KiCad_lib.git
cd JLC2KiCad_lib 
pip install . 

Usage

usage: JLC2KiCadLib [-h] [-dir OUTPUT_DIR] [--no_footprint] [--no_symbol] [-symbol_lib SYMBOL_LIB] [-footprint_lib FOOTPRINT_LIB]
                    [-models [{STEP,WRL} ...]] [--skip_existing] [-model_base_variable MODEL_BASE_VARIABLE]
                    [-logging_level {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [--log_file] [--version]
                    JLCPCB_part_# [JLCPCB_part_# ...]

take a JLCPCB part # and create the according component's kicad's library

positional arguments:
  JLCPCB_part_#         list of JLCPCB part # from the components you want to create

options:
  -h, --help            show this help message and exit
  -dir OUTPUT_DIR       base directory for output library files
  --no_footprint        use --no_footprint if you do not want to create the footprint
  --no_symbol           use --no_symbol if you do not want to create the symbol
  -symbol_lib SYMBOL_LIB
                        set symbol library name, default is "default_lib"
  -footprint_lib FOOTPRINT_LIB
                        set footprint library name, default is "footprint"
  -models [{STEP,WRL} ...]
                        Select the model you want to create. Default is STEP. If both are selected, only the STEP model will be added to the footprint
                        (the WRL model will still be generated alongside the STEP model). 
                        If you do not want any model to be generated, use the --models without arguments
  --skip_existing       use --skip_existing if you want do not want to replace already existing footprints and symbols
  -model_base_variable MODEL_BASE_VARIABLE
                        use -model_base_variable if you want to specifie the base path of the 3D model using a path variable
  -logging_level {DEBUG,INFO,WARNING,ERROR,CRITICAL}
                        set logging level. If DEBUG is used, the debug logs are only written in the log file if the option --log_file is set
  --log_file            use --log_file if you want logs to be written in a file
  --version             Print versin number and exit

exemple use : 
        python3 JLC2KiCad_lib.py C1337258 C24112 -dir My_lib -symbol_lib My_Symbol_lib --no_footprint

The only required arguments are the JLCPCP_part number (e.g. Cxxxxx)

Example usage : JLC2KiCadLib C1337258 C24112 -dir My_lib -symbol_lib My_symbol_lib

This example will create the symbol, footprint and 3D model for the two components specified and will output the symbol in the ./My_lib/symbol/My_symbol_lib.lib file, the footprint and 3D model will be created in the ./My_lib/Footprint. This will result in the following tree to be created :

My_lib
├── footprint
│   ├── packages3d
│   │   ├── QFN-24_L4.0-W4.0-P0.50-BL-EP2.7.step
│   │   └── VQFN-48_L7.0-W7.0-P0.50-BL-EP5.5.step
│   ├── QFN-24_L4.0-W4.0-P0.50-BL-EP2.7.kicad_mod
│   └── VQFN-48_L7.0-W7.0-P0.50-BL-EP5.5.kicad_mod
└── symbol
    └── My_symbol_lib.kicad_sym

The JLCPCB part # is found in the part info section of every component in the JLCPCB part library.

By default, the library folder will be created in the execution directory. You can specify an absolute path with the -dir option.

Dependencies

JLC2KiCadLib relies on the KicadModTree framework to generate the footprints.

Notes

  • Even so I tested the script on a lot of components, be careful and always check the output footprint and symbol.
  • I consider this project completed. I will continue to maintain it if a bug report is filed, but I will not develop new functionality in the near future. If you feel that an important feature is missing, please open an issue to discuss it, then you can fork this project with a new branch before submitting a PR.

License

Copyright © 2021 TousstNicolas

The code is released under the MIT license

Project details


Download files

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

Source Distribution

JLC2KiCadLib-1.0.24.tar.gz (16.9 kB view details)

Uploaded Source

Built Distribution

JLC2KiCadLib-1.0.24-py3-none-any.whl (20.0 kB view details)

Uploaded Python 3

File details

Details for the file JLC2KiCadLib-1.0.24.tar.gz.

File metadata

  • Download URL: JLC2KiCadLib-1.0.24.tar.gz
  • Upload date:
  • Size: 16.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for JLC2KiCadLib-1.0.24.tar.gz
Algorithm Hash digest
SHA256 2ca307c3fd57eec95dd8f4a88533f3d8d231abad78120e296faf1be7daaeb9f1
MD5 faa46547cd6dcd1a6e4834aba4bcc6a4
BLAKE2b-256 0bbdf6a75db903b6abc53f469214188d64a9ada98a2f64dd23083da75e2dc20b

See more details on using hashes here.

File details

Details for the file JLC2KiCadLib-1.0.24-py3-none-any.whl.

File metadata

File hashes

Hashes for JLC2KiCadLib-1.0.24-py3-none-any.whl
Algorithm Hash digest
SHA256 77f2214e8ca8e48537a08503f1a2bb6c67d5de0c56b2ac380cf0cdb595d27839
MD5 5c4fc4f27eb3f46c59c508d5b831b162
BLAKE2b-256 1e764bb82e5fd2341e03cd36e5d6da8a0e328f73fe82e27f71da993abc383101

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