# easyeda2kicad v0.8.0
_________________
[](https://badge.fury.io/py/easyeda2kicad)
[](https://pypi.org/project/isort/)
[](https://pepy.tech/project/easyeda2kicad)
[](https://github.com/pre-commit/pre-commit)
[](https://github.com/psf/black)
[](https://pycqa.github.io/isort/)
[](https://github.com/PyCQA/bandit)
_________________
A Python script that converts any electronic components from [EasyEDA](https://easyeda.com/) or [LCSC](https://www.lcsc.com/) 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](https://jlcpcb.com/caa). **It supports library formats for both Kicad v6.x and Kicad v5.x.**
<p align="center">
<img src="https://raw.githubusercontent.com/uPesy/easyeda2kicad.py/master/ressources/demo_symbol.png" width="500">
</p>
<div align="center">
<img src="https://raw.githubusercontent.com/uPesy/easyeda2kicad.py/master/ressources/demo_footprint.png" width="500">
</div>
## 🎆 Sponsor and Support
If this tool has saved you a lot of time when designing a PCB, please consider supporting the project by :
- Subscribing to uPesy Premium Membership to have access to high-quality electronics tutorials at https://www.upesy.com/products/subscription
- Buying one of my ESP32 DevKit boards: https://www.upesy.com/pages/store
<div align="center">
<a href="https://www.upesy.com/" target="_blank"><img src="https://raw.githubusercontent.com/uPesy/easyeda2kicad.py/master/ressources/upesy_store.jpg" width="350"/></a>
</div>
## 💾 Installation
```bash
pip install easyeda2kicad
```
## 💻 Usage
```bash
# 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 (in .WRL and .STEP format )
If you want to save components symbol/footprint in your own libs, you can specify the output lib path by using `--output` option.
```bash
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. The 3D models will be saved both in .WRL and .STEP format.
You can use the option `--overwrite` to update a component symbol/footprint that is already in a Kicad library (generated by easyeda2kicad)
```bash
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.
```bash
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 :
```bash
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.
Raw data
{
"_id": null,
"home_page": "https://github.com/uPesy/easyeda2kicad.py",
"name": "easyeda2kicad",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "easyeda kicad library conversion",
"author": "uPesy",
"author_email": "contact@upesy.com",
"download_url": "https://files.pythonhosted.org/packages/f1/78/fde265892294c733590a9089f37cc8ea1478b9c632d76c0a11b8f20fe6f3/easyeda2kicad-0.8.0.tar.gz",
"platform": "any",
"description": "# easyeda2kicad v0.8.0\n\n_________________\n[](https://badge.fury.io/py/easyeda2kicad)\n[](https://pypi.org/project/isort/)\n[](https://pepy.tech/project/easyeda2kicad)\n\n[](https://github.com/pre-commit/pre-commit)\n[](https://github.com/psf/black)\n[](https://pycqa.github.io/isort/)\n[](https://github.com/PyCQA/bandit)\n_________________\n\n\nA Python script that converts any electronic components from [EasyEDA](https://easyeda.com/) or [LCSC](https://www.lcsc.com/) 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](https://jlcpcb.com/caa). **It supports library formats for both Kicad v6.x and Kicad v5.x.**\n\n<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/uPesy/easyeda2kicad.py/master/ressources/demo_symbol.png\" width=\"500\">\n</p>\n<div align=\"center\">\n <img src=\"https://raw.githubusercontent.com/uPesy/easyeda2kicad.py/master/ressources/demo_footprint.png\" width=\"500\">\n</div>\n\n\n## \ud83c\udf86 Sponsor and Support\n\nIf this tool has saved you a lot of time when designing a PCB, please consider supporting the project by :\n- Subscribing to uPesy Premium Membership to have access to high-quality electronics tutorials at https://www.upesy.com/products/subscription\n- Buying one of my ESP32 DevKit boards: https://www.upesy.com/pages/store\n\n<div align=\"center\">\n<a href=\"https://www.upesy.com/\" target=\"_blank\"><img src=\"https://raw.githubusercontent.com/uPesy/easyeda2kicad.py/master/ressources/upesy_store.jpg\" width=\"350\"/></a>\n</div>\n\n## \ud83d\udcbe Installation\n\n```bash\npip install easyeda2kicad\n```\n\n## \ud83d\udcbb Usage\n\n```bash\n# For symbol + footprint + 3d model (with --full argument)\neasyeda2kicad --full --lcsc_id=C2040\n# For symbol + footprint + 3d model\neasyeda2kicad --symbol --footprint --3d --lcsc_id=C2040\n# For symbol + footprint\neasyeda2kicad --symbol --footprint --lcsc_id=C2040\n# For symbol only\neasyeda2kicad --symbol --lcsc_id=C2040\n# For footprint only\neasyeda2kicad --footprint --lcsc_id=C2040\n# For 3d model only\neasyeda2kicad --3d --lcsc_id=C2040\n# For symbol in Kicad v5.x legacy format\neasyeda2kicad --symbol --lcsc_id=C2040 --v5\n```\n\nBy default, all librairies are saved in `C:/Users/your_name/Documents/Kicad/easyeda2kicad/`, with :\n- `easyeda2kicad.kicad_sym` file for Kicad v6.x symbol library\n- `easyeda2kicad.lib` file for Kicad v5.x legacy symbol library\n- `easyeda2kicad.pretty/` folder for footprint libraries\n- `easyeda2kicad.3dshapes/` folder for 3d models (in .WRL and .STEP format )\n\nIf you want to save components symbol/footprint in your own libs, you can specify the output lib path by using `--output` option.\n\n```bash\neasyeda2kicad --full --lcsc_id=C2040 --output ~/libs/my_lib\n```\n\nThis command will save:\n- the symbol in `~/libs/my_lib.kicad_sym` file for symbol library. The file will be created if it doesn't exist.\n- the footprint in `~/libs/my_lib.pretty/` folder for footprint libraries. The folder will be created if it doesn't exist.\n- the 3d models in `~/libs/my_lib.3dshapes/` folder for 3d models. The folder will be created if it doesn't exist. The 3D models will be saved both in .WRL and .STEP format.\n\nYou can use the option `--overwrite` to update a component symbol/footprint that is already in a Kicad library (generated by easyeda2kicad)\n\n```bash\neasyeda2kicad --symbol --footprint --lcsc_id=C2040 --output ~/libs/my_lib --overwrite\n```\n\nBy 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.\n\n```bash\neasyeda2kicad --symbol --lcsc_id=C2040 --v5\n```\n\n## \ud83d\udd17 Add libraries in Kicad\n\n**These are the instructions to add the default easyeda2kicad libraries in Kicad.**\nBefore configuring KiCad, run the script at least once to create lib files. For example :\n\n```bash\neasyeda2kicad --symbol --footprint --lcsc_id=C2040\n```\n\n- In KiCad, Go to Preferences > Configure Paths, and add the environment variables `EASYEDA2KICAD` :\n - Windows : `C:/Users/your_username/Documents/Kicad/easyeda2kicad/`,\n - Linux : `/home/your_username/Documents/Kicad/easyeda2kicad/`\n- Go to Preferences > Manage Symbol Libraries, and Add the global library `easyeda2kicad` : `${EASYEDA2KICAD}/easyeda2kicad.kicad_sym`\n- Go to Preferences > Manage Footprint Libraries, and Add the global library `easyeda2kicad` : `${EASYEDA2KICAD}/easyeda2kicad.pretty`\n- Enjoy :wink:\n\n## \ud83d\udd25 Important Notes\n### WARRANTY\nThe 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.\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": "A Python script that convert any electronic components from LCSC or EasyEDA to a Kicad library",
"version": "0.8.0",
"project_urls": {
"Code": "https://github.com/uPesy/easyeda2kicad.py",
"Homepage": "https://github.com/uPesy/easyeda2kicad.py"
},
"split_keywords": [
"easyeda",
"kicad",
"library",
"conversion"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "791812bb560cfb0d8795f06057617f2df300a7a9c64fe1f7048c2662f26c5489",
"md5": "4fddcb126d890352eca8aaffb53327d9",
"sha256": "9e13757f9bd93752064cb28b85d844113711c31b664cb1df1a60a9ae59599aa8"
},
"downloads": -1,
"filename": "easyeda2kicad-0.8.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4fddcb126d890352eca8aaffb53327d9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 43443,
"upload_time": "2024-06-17T18:32:56",
"upload_time_iso_8601": "2024-06-17T18:32:56.562501Z",
"url": "https://files.pythonhosted.org/packages/79/18/12bb560cfb0d8795f06057617f2df300a7a9c64fe1f7048c2662f26c5489/easyeda2kicad-0.8.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f178fde265892294c733590a9089f37cc8ea1478b9c632d76c0a11b8f20fe6f3",
"md5": "342bd4e2a5a088c9dafcd3ee591c17af",
"sha256": "a781be6d1076f6e06886a4292373eb930c9921de4c709d6dd91bb6ea104f4a4b"
},
"downloads": -1,
"filename": "easyeda2kicad-0.8.0.tar.gz",
"has_sig": false,
"md5_digest": "342bd4e2a5a088c9dafcd3ee591c17af",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 41934,
"upload_time": "2024-06-17T18:33:03",
"upload_time_iso_8601": "2024-06-17T18:33:03.032784Z",
"url": "https://files.pythonhosted.org/packages/f1/78/fde265892294c733590a9089f37cc8ea1478b9c632d76c0a11b8f20fe6f3/easyeda2kicad-0.8.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-17 18:33:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "uPesy",
"github_project": "easyeda2kicad.py",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pre-commit",
"specs": [
[
">=",
"2.17.0"
]
]
},
{
"name": "pydantic",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "requests",
"specs": [
[
">",
"2.0.0"
]
]
}
],
"tox": true,
"lcname": "easyeda2kicad"
}
JSON
