Easy-ECAD-Downloader

KO | EN

gitlite — search

#javascript #ai #golang #rust #deep-learning #nodejs #cli #awesome-list #vue #security #ios #mcp #openai #open-source

Easy-ECAD-Downloader

(★ 16)

Chrome extension to download EasyEDA part data (symbols, footprints, 3D models) from JLCPCB & LCSC and export for KiCad

Easy-ECAD-Downloader 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<a href="https://chromewebstore.google.com/detail/easyeda-downloader/egbkokdcahpjimldjjaobimnofbdnncb">Install for Chrome</a>
 &nbsp;|&nbsp;
 <a href="https://addons.mozilla.org/en-GB/firefox/addon/easy-ecad-downloader/">Install for Firefox</a>
 &nbsp;|&nbsp;
 <a href="#quick-start">Quick start</a>
 &nbsp;|&nbsp;
 <a href="#faq">FAQ</a>

Easy ECAD Downloader is a browser extension for exporting KiCad-compatible CAD assets from supported distributor product pages.

It works on supported JLCPCB, LCSC, Mouser, Farnell, element14, and Newark part pages, and can download the available KiCad files for you: symbols, footprints, 3D models, and datasheets.

<img src="docs/assets/readme/important-bar.svg" alt="" width="4" height="58" align="left" hspace="12">
 Important: Generated library files should always be reviewed before manufacturing. Verify pin mapping, footprint dimensions, 3D model alignment, and datasheet accuracy before using exported files in production designs.

## <img src="docs/assets/readme/icon-contents.svg" alt="" width="20" height="20" align="absmiddle"> Contents

- [Installation](#installation)
- [Quick start](#quick-start)
- [Usage walkthrough](#usage-walkthrough)
- [Output structure](#output-structure)
- [Supported sources and outputs](#supported-sources-and-outputs)
- [Settings](#settings)
- [FAQ](#faq)
- [Technical overview](#technical-overview)
- [Contributing](#contributing)
- [Supporting docs](#supporting-docs)
- [License and attribution](#license-and-attribution)

## <img src="docs/assets/readme/icon-installation.svg" alt="" width="20" height="20" align="absmiddle"> Installation

| Browser | Install from | Notes |
|---|---|---|
| Chrome, Edge, Brave, and other Chromium browsers | [Chrome Web Store](https://chromewebstore.google.com/detail/easyeda-downloader/egbkokdcahpjimldjjaobimnofbdnncb) | Full support for EasyEDA-backed pages and SamacSys-backed Mouser/Farnell/element14/Newark downloads. |
| Firefox | [Firefox Add-ons](https://addons.mozilla.org/en-GB/firefox/addon/easy-ecad-downloader/) | Works for EasyEDA-backed pages. SamacSys-backed Mouser/Farnell/element14/Newark downloads need the optional Firefox relay setup. |

## <img src="docs/assets/readme/icon-quick-start.svg" alt="" width="20" height="20" align="absmiddle"> Quick start

1. Open a supported JLCPCB, LCSC, Mouser, Farnell, element14, or Newark component page.
2. Click the Easy ECAD Downloader extension icon.
3. Review the detected manufacturer and source part details.
4. Choose which assets to export.
5. Click `Download`.
6. Open the generated files from KiCad and review them before use.

## <img src="docs/assets/readme/icon-walkthrough.svg" alt="" width="20" height="20" align="absmiddle"> Usage walkthrough

### 1. Open a supported component page

The content script detects supported part contexts from EasyEDA-backed JLCPCB/LCSC pages or SamacSys-backed Mouser/Farnell/element14/Newark pages.

### 2. Preview and download from the popup

The popup shows manufacturer details, source-specific part metadata, symbol and footprint previews, and the available export options.

### 3. Use the generated KiCad files

Library mode creates a KiCad-style symbol library, footprint library, model folder, and datasheet folder under your browser downloads directory.

## <img src="docs/assets/readme/icon-output.svg" alt="" width="20" height="20" align="absmiddle"> Output structure

When `Save each file separately` is disabled, files are grouped under `Downloads/<library root>/`. The default library root is `easyECADDownloader`.

When `Save each file separately` is enabled, selected files are saved as loose downloads instead of being grouped into a shared KiCad library folder. Exact filenames can vary by source.

```text
Downloads/
|-- <component>.kicad_sym
|-- <component>.kicad_mod
|-- <component>.step
|-- <component>.wrl
`-- <component>-datasheet.pdf
```

When a footprint and matching 3D model are exported together, the footprint model reference is rewritten to the generated model path. If no 3D model is exported, stale model references are removed from the generated footprint.

## <img src="docs/assets/readme/icon-support.svg" alt="" width="20" height="20" align="absmiddle"> Supported sources and outputs

| Source flow | Pages | Symbol | Footprint | 3D model | Datasheet | Notes |
|---|---|---:|---:|---:|---:|---|
| EasyEDA-backed | JLCPCB, LCSC | Yes | Yes | When available | When available | Uses the detected LCSC id and upstream EasyEDA payload. |
| SamacSys-backed | Mouser, Farnell, element14, Newark | Yes | Yes | When available | No | Downloads the upstream KiCad ZIP and repackages selected assets. |

## <img src="docs/assets/readme/icon-settings.svg" alt="" width="20" height="20" align="absmiddle"> Settings

| Setting | Purpose |
|---|---|
| `Save each file separately` | Switches between loose downloads and grouped KiCad library output. |
| `KiCad library folder` | Sets the Downloads-relative folder used for library mode, such as `easyECADDownloader` or `KiCad/easyECAD`. |
| `SamacSys username` and `SamacSys password` | Optional upstream sign-in details for Mouser/Farnell/element14/Newark CAD ZIP downloads. |
| `Advanced Firefox settings` | Configures the user-managed Firefox relay URL and helper-service auth when SamacSys export is needed in Firefox. |

Password and token fields are blank when the settings page opens, and each field has a local show/hide button for checking typed values. New values are kept for the current browser session by default. Tick the relevant `Remember ... on this device` box only if you accept the risk of storing that secret in the browser profile.

## <img src="docs/assets/readme/icon-faq.svg" alt="" width="20" height="20" align="absmiddle"> FAQ

<details>
<summary>View frequently asked questions</summary>

<details>
<summary>What does Easy ECAD Downloader do?</summary>

Easy ECAD Downloader is a browser extension for downloading KiCad-compatible ECAD assets from supported distributor pages. It helps export available symbols, footprints, 3D models, and datasheets from JLCPCB, LCSC, Mouser, Farnell, element14, and Newark product pages.

</details>

<details>
<summary>Which websites does Easy ECAD Downloader support?</summary>

Easy ECAD Downloader supports JLCPCB, LCSC, Mouser, Farnell, element14, and Newark product pages. JLCPCB and LCSC use EasyEDA-backed component data, while Mouser, Farnell, element14, and Newark use SamacSys-backed CAD downloads.

</details>

<details>
<summary>What KiCad files can Easy ECAD Downloader create?</summary>

Depending on the part and source data, Easy ECAD Downloader can create KiCad symbol libraries, footprint files, 3D model files, and datasheet PDFs. Common output files include `.kicad_sym`, `.kicad_mod`, `.pretty`, `.step`, `.wrl`, and PDF datasheets.

</details>

<details>
<summary>Where are the downloaded KiCad files saved?</summary>

In library mode, Easy ECAD Downloader saves files into a KiCad-style library folder under your browser Downloads directory. By default, this is `Downloads/easyECADDownloader/`. The output is grouped into a symbol library, a `.pretty` footprint folder, a 3D models folder, and a datasheets folder when applicable. If `Save each file separately` is enabled, selected files are saved directly into the browser downloads folder.

</details>

<details>
<summary>Do I still need to check the downloaded symbol or footprint?</summary>

Yes. Generated CAD assets should always be reviewed before manufacturing. Check pin mapping, pad numbering, footprint dimensions, polarity, orientation, courtyard and clearance assumptions, 3D model placement, and datasheet accuracy before ordering boards.

</details>

<details>
<summary>How do I import JLCPCB or EasyEDA footprints and symbols into KiCad easily?</summary>

Open a supported JLCPCB or LCSC component page, click the Easy ECAD Downloader extension icon, preview the available assets, and download the KiCad output. The extension converts the available EasyEDA-backed component data into KiCad-compatible symbol, footprint, and 3D model files where those assets exist.

</details>

<details>
<summary>Can I download EasyEDA footprints for KiCad?</summary>

Yes. For supported JLCPCB and LCSC pages, Easy ECAD Downloader downloads EasyEDA-backed component data and exports KiCad-compatible footprint files. When available, it can also export the matching symbol, 3D model, and datasheet.

</details>

<details>
<summary>How do I download JLCPCB footprints for KiCad?</summary>

Find the supported JLCPCB or LCSC component page, open Easy ECAD Downloader, and download the available KiCad footprint. This avoids manually redrawing the land pattern when source CAD data is already available.

</details>

<details>
<summary>Can I convert an LCSC part number into a KiCad symbol, footprint, and 3D model?</summary>

Yes, for supported LCSC or JLCPCB parts with available EasyEDA-backed data. Easy ECAD Downloader detects the part from the browser page and exports the available KiCad assets without requiring a command-line workflow.

</details>

<details>
<summary>Is Easy ECAD Downloader an EasyEDA to KiCad converter?</summary>

Yes, for component-level library assets. Easy ECAD Downloader converts supported EasyEDA-backed component data into KiCad-compatible symbols, footprints, and 3D models. It is not a full EasyEDA project, schematic, or PCB-layout migration tool.

</details>

<details>
<summary>Can I download KiCad footprints from Mouser?</summary>

Yes, when the Mouser product page provides supported ECAD data. Easy ECAD Downloader uses the Mouser and SamacSys CAD flow to download the available KiCad files and organize the selected symbol, footprint, and 3D model assets.

</details>

<details>
<summary>Can I download KiCad footprints from Farnell, element14, or Newark?</summary>

Yes, when the Farnell, element14, or Newark product page links to supported SamacSys ECAD data. Easy ECAD Downloader can export the available KiCad symbol, footprint, and 3D model files from the supported download flow.

</details>

<details>
<summary>Is Easy ECAD Downloader a Library Loader alternative for KiCad?</summary>

For supported JLCPCB, LCSC, Mouser, Farnell, element14, and Newark pages, yes. Easy ECAD Downloader can reduce the need for a separate Library Loader workflow by detecting the part page, downloading the available CAD assets, and organizing KiCad-compatible output. Library Loader may still be useful for unsupported distributors, unsupported parts, or non-KiCad workflows.

</details>

<details>
<summary>How do I add downloaded symbols and footprints to KiCad?</summary>

Add the generated `.kicad_sym` file through KiCad's symbol library manager and add the generated `.pretty` folder through KiCad's footprint library manager. KiCad tracks symbol and footprint libraries separately, so add both if you downloaded both asset types.

</details>

<details>
<summary>Why is a KiCad symbol, footprint, 3D model, or datasheet missing?</summary>

Easy ECAD Downloader can only export files that are available from the source page or linked component metadata. Some components have a footprint but no symbol, no 3D model, no datasheet, or incomplete upstream CAD data.

</details>

## <img src="docs/assets/readme/icon-technical.svg" alt="" width="20" height="20" align="absmiddle"> Technical overview

At a high level, the content script detects supported part pages, the popup requests previews and downloads, the service-worker runtime routes provider-specific work, and the source adapters fetch or repackage upstream CAD assets for KiCad.

Key implementation areas:

- `src/content_script.js`: DOM inspection and provider-aware part detection.
- `src/popup.js`: popup UI, settings, preview requests, and export requests.
- `src/service_worker_runtime.js`: provider routing and worker orchestration.
- `src/core/`: shared settings, downloads, preview data, and storage-backed library helpers.
- `src/sources/`: EasyEDA and SamacSys source adapters.
- `src/kicad/`: EasyEDA parsing, KiCad emitters, shared conversion helpers, and OBJ-to-WRL conversion.
- `tests/`: regression suite for behavior, conversion, browser runtime boundaries, and repository hygiene.

## <img src="docs/assets/readme/icon-contributing.svg" alt="" width="20" height="20" align="absmiddle"> Contributing

Read [contributing.md](contributing.md) for development setup, local validation, contribution expectations, and manual extension-loading instructions. Read [AGENTS.md](AGENTS.md) for repository working rules.

Good contributions include parser fixes for real component pages, regression tests for failed exports, output-format corrections, browser compatibility fixes, and documentation that makes the workflow clearer for KiCad users.

## <img src="docs/assets/readme/icon-docs.svg" alt="" width="20" height="20" align="absmiddle"> Supporting docs

- [systemDesign.md](systemDesign.md): design source of truth.
- [CHANGELOG.md](CHANGELOG.md): notable changes by release or branch delta.
- [SECURITY.md](SECURITY.md): vulnerability reporting and credential-handling notes.
- [docs/architecture-notes.md](docs/architecture-notes.md): short implementation notes.
- [docs/firefox-samacsys-proxy.md](docs/firefox-samacsys-proxy.md): Cloudflare Worker relay example for Firefox SamacSys support.

## <img src="docs/assets/readme/icon-license.svg" alt="" width="20" height="20" align="absmiddle"> License and attribution

This project includes and is derived from:

`easyeda2kicad.py`  
Copyright (c) uPesy  
Licensed under the GNU Affero General Public License v3.0

Additional code in this repository remains under the repository license.

See [LICENSE](LICENSE) for details.

Made with <img src="docs/assets/readme/icon-heart.svg" alt="heart" width="20" height="20" align="absmiddle"> for open-source electronics.

Easy-ECAD-Downloader

Easy-ECAD-Downloader 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Easy-ECAD-Downloader

Easy-ECAD-Downloader 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README