Adom Desktop - KiCad Bridge
Public Made by Adomby adom
Reference implementation of the KiCad bridge — multi-instance Python server, forward path via kicad-cli, reverse path via in-process plugin. Most complex of the three bundled bridges.
kicad-tour hero collage
A single PNG that explains the kicad-bridge tour in one image. Used as the
wiki page header for apps/adom-desktop-kicad-bridge.
Files
| Path | What |
|---|---|
hero.png |
The rendered 1568×980 collage |
hero_builder.py |
The Python build script (re-runnable) |
tiles/01-symbol.png .. 06-3d-board.png |
The 6 source KiCad window captures |
fonts/FamiljenGrotesk-{Bold,Medium,Regular}.ttf |
Adom headline font (OFL) |
fonts/Satoshi-{Regular,Medium}.ttf |
Adom body font (Fontshare free license) |
All paths in hero_builder.py are resolved relative to the script's own
location — re-rendering needs no environment setup beyond Pillow.
Re-render
cd plugins/kicad/skills/kicad-tour/hero
python hero_builder.py
# wrote hero.png (~330 KB, 1568x980)
Requires Python 3.10+ with Pillow.
Re-capture the tile screenshots
The tiles are captured from running tour_runner.py --pack tour-pack-rp2040
in the parent skill directory, then renaming the output frames:
cd plugins/kicad/skills/kicad-tour
python tour_runner.py --pack tour-pack-rp2040 --output /tmp/rp-shots
# Rename + copy to hero/tiles/
cp /tmp/rp-shots/02-symbol-editor.png hero/tiles/01-symbol.png
cp /tmp/rp-shots/03-footprint-editor.png hero/tiles/02-footprint.png
cp /tmp/rp-shots/07-board-3d.png hero/tiles/03-3d-chip.png # cropped on chip
cp /tmp/rp-shots/05-schematic.png hero/tiles/04-schematic.png
cp /tmp/rp-shots/06-board.png hero/tiles/05-board.png
cp /tmp/rp-shots/07-board-3d.png hero/tiles/06-3d-board.png
Note: tile 03 ("3D Chip") is the same source as tile 06 — hero_builder.py
center-crops it tight on the chip via the crop_chip flag. If you ever
capture a real footprint-editor 3D view (the v0.8.5 bridge tries via
kicad_open_3d_viewer editor=fp but KiCad 10's WM_COMMAND ID isn't
matched yet), drop that capture in as 03-3d-chip.png and remove the
"crop_chip" flag in hero_builder.py:TILES_DEF.
Brand tokens
The teal / dark teal / muted greys are pulled from
gallia/brand/logos/SKILL.md. If the brand palette shifts, swap the
constants at the top of hero_builder.py — they're all RGB tuples.
Font licenses
- Familjen Grotesk — SIL Open Font License v1.1 (Martin Sommaruga & Iza Bargmann). Free to ship in any context.
- Satoshi — Fontshare free license (Indian Type Foundry). Free for personal + commercial use, including in apps and websites; no attribution required.
Both TTFs were converted on-host from the gallia woff2 sources via fontTools +
brotli (one-time). The source woff2 lives at gallia/brand/fonts/ if you
need other weights.
# kicad-tour hero collage
A single PNG that explains the kicad-bridge tour in one image. Used as the
wiki page header for `apps/adom-desktop-kicad-bridge`.
## Files
| Path | What |
|---|---|
| `hero.png` | The rendered 1568×980 collage |
| `hero_builder.py` | The Python build script (re-runnable) |
| `tiles/01-symbol.png` .. `06-3d-board.png` | The 6 source KiCad window captures |
| `fonts/FamiljenGrotesk-{Bold,Medium,Regular}.ttf` | Adom headline font (OFL) |
| `fonts/Satoshi-{Regular,Medium}.ttf` | Adom body font (Fontshare free license) |
All paths in `hero_builder.py` are resolved relative to the script's own
location — re-rendering needs no environment setup beyond Pillow.
## Re-render
```bash
cd plugins/kicad/skills/kicad-tour/hero
python hero_builder.py
# wrote hero.png (~330 KB, 1568x980)
```
Requires Python 3.10+ with Pillow.
## Re-capture the tile screenshots
The tiles are captured from running `tour_runner.py --pack tour-pack-rp2040`
in the parent skill directory, then renaming the output frames:
```bash
cd plugins/kicad/skills/kicad-tour
python tour_runner.py --pack tour-pack-rp2040 --output /tmp/rp-shots
# Rename + copy to hero/tiles/
cp /tmp/rp-shots/02-symbol-editor.png hero/tiles/01-symbol.png
cp /tmp/rp-shots/03-footprint-editor.png hero/tiles/02-footprint.png
cp /tmp/rp-shots/07-board-3d.png hero/tiles/03-3d-chip.png # cropped on chip
cp /tmp/rp-shots/05-schematic.png hero/tiles/04-schematic.png
cp /tmp/rp-shots/06-board.png hero/tiles/05-board.png
cp /tmp/rp-shots/07-board-3d.png hero/tiles/06-3d-board.png
```
Note: tile 03 ("3D Chip") is the same source as tile 06 — `hero_builder.py`
center-crops it tight on the chip via the `crop_chip` flag. If you ever
capture a real footprint-editor 3D view (the v0.8.5 bridge tries via
`kicad_open_3d_viewer editor=fp` but KiCad 10's WM_COMMAND ID isn't
matched yet), drop that capture in as `03-3d-chip.png` and remove the
`"crop_chip"` flag in `hero_builder.py:TILES_DEF`.
## Brand tokens
The teal / dark teal / muted greys are pulled from
`gallia/brand/logos/SKILL.md`. If the brand palette shifts, swap the
constants at the top of `hero_builder.py` — they're all RGB tuples.
## Font licenses
- **Familjen Grotesk** — SIL Open Font License v1.1 (Martin Sommaruga & Iza Bargmann). Free to ship in any context.
- **Satoshi** — Fontshare free license (Indian Type Foundry). Free for personal + commercial use, including in apps and websites; no attribution required.
Both TTFs were converted on-host from the gallia woff2 sources via `fontTools` +
`brotli` (one-time). The source woff2 lives at `gallia/brand/fonts/` if you
need other weights.