adom-kicad-library-importer
Rust CLI that takes zip files containing KiCad libraries (from SamacSys, SnapEDA, Ultra Librarian, etc.) and installs them into a local KiCad 9 installation via adom-desktop.
Runs inside the Adom Docker container, sends files and commands to the user's Windows desktop through the adom-desktop relay.
What it does
- Extracts zip files and auto-detects KiCad files (
.kicad_sym,.kicad_mod,.step,.wrl) - Converts legacy KiCad 4/5 footprint format to KiCad 9 (module→footprint, stroke syntax, arc conversion, quoted layers)
- Patches symbol footprint references to include library prefix (
Name→Library:Name) - Patches 3D model paths in footprints to absolute quoted paths
- Installs symbols, footprints, and 3D models to a user-specified Windows directory
- Registers libraries in KiCad's
sym-lib-tableandfp-lib-table - Verifies installation with 8 automated checks (lib-table entries, files on disk, linkages)
Commands
install <ZIP_FILE> Extract and install all KiCad libraries
--library-name Library name in KiCad (default: zip filename)
--library-path Windows path for footprints/3D models
--kicad-version Target KiCad version [default: 9.0]
--dry-run Show what would be installed
--skip-lint Skip pre-flight validation
uninstall <NAME> Remove library files and lib-table entries
--library-path Windows path where library was installed
list <ZIP_FILE> Show zip contents without installing
status Check adom-desktop connection and KiCad versions
verify <NAME> Run 8-point verification on an installed library
--library-path Windows path where library was installed
Example
adom-kicad-library-importer install LIB_LAN9370-I_KCX.zip \
--library-name "LAN9370" \
--library-path 'C:\Users\noah\KiCAD Libraries\hydrogen-library'
Installs:
hydrogen-library\LAN9370.kicad_sym(symbol + sym-lib-table entry)hydrogen-library\LAN9370.pretty\QFN40P800X800X90-65N.kicad_mod(footprint + fp-lib-table entry)hydrogen-library\LAN9370.3dshapes\LAN9370-I_KCX.stp(3D model, referenced by footprint)
Requirements
adom-desktopCLI installed and relay running- Adom Desktop app connected on Windows
- KiCad 9.0 installed on Windows
Source
- GitHub: adom-inc/adom-kicad-library-importer (private)
