app

Adom Desktop - KiCad Bridge

Public Made by Adom

by 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.

kicadpcbschematicedabridgeadom-desktop
Overview Files Skills Discover Packages Releases Dependencies Issues4 Breadcrumbs Pull Requests Activity
adom-desktop-kicad-bridge / skills / kicad-tour / hero
Name Last commit message Last updated
hero_builder.py v0.9.0: fix /status health endpoint (bridgeRunning root cause) + capability/version-awareness report 26d ago
README.md v0.9.0: fix /status health endpoint (bridgeRunning root cause) + capability/version-awareness report 26d ago

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.