## What this is

`adom-sfconvert` converts foreign EDA libraries — **EAGLE / Fusion 360 `.lbr`**
and **Altium `.SchLib` / `.PcbLib` / `.IntLib`** — into standard KiCad symbol +
footprint, and renders each format's **own** geometry as a native SVG. The name
echoes `adom-ds2sf`: **sf** = **s**ymbol + **f**ootprint.

![Same footprint from four sources, each rendered from its own geometry](screenshots/four-source-footprint.png)

*The same part's footprint from four sources — KiCad, Fusion, Altium (native), and
the datasheet — each rendered from its OWN geometry so you can see what disagrees.*

It is **fully native** — pure Rust, runs in your container, **no KiCad install
and no service round-trip**. Each format is read by the right native reader:

![EAGLE/Fusion .lbr rendered natively — symbol + footprint, no KiCad round-trip](screenshots/eagle-native.png)

*An EAGLE/Fusion `.lbr` rendered straight from its own geometry by `eagle.rs` —
symbol and footprint, never round-tripped through KiCad.*

| Input | Read by | Native? |
|---|---|---|
| EAGLE / Fusion `.lbr` (XML) | built-in `eagle.rs` | ✅ |
| Altium `.PcbLib` (footprints) | [`altium-pcblib`](https://wiki.adom.inc/skill/altium-pcblib) | ✅ |
| Altium `.SchLib` (symbols) | [`altium-schlib`](https://wiki.adom.inc/skill/altium-schlib) | ✅ |

## Why native matters

The point of pulling a part's CAD from many sources is to **compare what's right
and what's wrong**. If every format is normalised through KiCad's importer first,
the sources converge — they all become "KiCad's interpretation," and the
disagreements you wanted to catch are erased. `adom-sfconvert` renders each
library from its own bytes, so EAGLE looks like EAGLE and Altium looks like
Altium. Conversion to `.kicad_sym` / `.kicad_mod` happens **only on export**.

## Usage

```bash
adom-sfconvert convert part.lbr     --out-dir ./out --name part   # EAGLE/Fusion
adom-sfconvert convert part.SchLib  --out-dir ./out --name part   # Altium symbol
adom-sfconvert convert part.PcbLib  --out-dir ./out --name part   # Altium footprint
adom-sfconvert version
```

Each `convert` emits, into `--out-dir`:

- `<name>.kicad_sym` / `<name>.kicad_mod` — the **export** files.
- `<name>-symbol.svg` / `<name>-footprint.svg` — the **native thumbnails**,
  drawn straight from the source geometry.

## Where it's used

`chip-fetcher` calls `adom-sfconvert` to turn every downloaded EAGLE/Fusion and
Altium library into a per-source thumbnail, shown side-by-side with the KiCad and
datasheet renders so you can pick what to export to your preferred EDA app. After
this tool went native, **nothing foreign touches the KiCad service** — only
KiCad's own format is rendered remotely.

## Companions

- `adom-ds2sf` — extract symbol + footprint from a datasheet PDF.
- `altium-pcblib` / `altium-schlib` — the native Altium readers this builds on.
- `chip-fetcher` — the consumer that shows every source for comparison.

## License

**MIT** — © 2026 Adom Industries Inc. Open source; see [LICENSE](LICENSE). Modify, fork, and redistribute freely.