{
  "schema_version": 1,
  "type": "app",
  "slug": "adom-kicad-library-importer",
  "title": "adom-kicad-library-importer",
  "brief": "Import KiCad libraries from zip files (SamacSys, SnapEDA, etc.) into KiCad 9 via adom-desktop",
  "version": "1.0.0",
  "tags": [],
  "license": "MIT",
  "discovery_triggers": [
    "kicad library import",
    "import kicad zip",
    "install kicad library",
    "samacys library",
    "snapeda library",
    "ultra librarian",
    "kicad_sym install",
    "kicad_mod install",
    "footprint import",
    "symbol import",
    "3d model import kicad",
    "component library zip",
    "kicad library importer"
  ],
  "discovery_pitch": "Import KiCad component libraries from manufacturer zip files (SamacSys, SnapEDA, Ultra Librarian) into KiCad 9 — handles symbols, footprints, 3D models, legacy format conversion, and lib-table registration via adom-desktop.",
  "sample_prompts": [
    {
      "label": "Install library",
      "prompt": "Install this KiCad library zip into my KiCad"
    },
    {
      "label": "Import parts",
      "prompt": "Import the component zip I downloaded from SamacSys into KiCad"
    },
    {
      "label": "List contents",
      "prompt": "Show me what KiCad files are in this zip"
    },
    {
      "label": "Uninstall library",
      "prompt": "Remove the LAN9370 library from my KiCad"
    },
    {
      "label": "Verify install",
      "prompt": "Check if my installed KiCad library is set up correctly"
    }
  ],
  "install": {
    "binary_name": "adom-kicad-library-importer",
    "install_dir": "",
    "install_hint": "",
    "version_cmd": ""
  },
  "readme": "# adom-kicad-library-importer\n\nRust 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.\n\nRuns inside the Adom Docker container, sends files and commands to the user's Windows desktop through the adom-desktop relay.\n\n## What it does\n\n- **Extracts** zip files and auto-detects KiCad files (`.kicad_sym`, `.kicad_mod`, `.step`, `.wrl`)\n- **Converts** legacy KiCad 4/5 footprint format to KiCad 9 (module→footprint, stroke syntax, arc conversion, quoted layers)\n- **Patches** symbol footprint references to include library prefix (`Name` → `Library:Name`)\n- **Patches** 3D model paths in footprints to absolute quoted paths\n- **Installs** symbols, footprints, and 3D models to a user-specified Windows directory\n- **Registers** libraries in KiCad's `sym-lib-table` and `fp-lib-table`\n- **Verifies** installation with 8 automated checks (lib-table entries, files on disk, linkages)\n\n## Commands\n\n```\ninstall <ZIP_FILE>     Extract and install all KiCad libraries\n  --library-name       Library name in KiCad (default: zip filename)\n  --library-path       Windows path for footprints/3D models\n  --kicad-version      Target KiCad version [default: 9.0]\n  --dry-run            Show what would be installed\n  --skip-lint          Skip pre-flight validation\n\nuninstall <NAME>       Remove library files and lib-table entries\n  --library-path       Windows path where library was installed\n\nlist <ZIP_FILE>        Show zip contents without installing\n\nstatus                 Check adom-desktop connection and KiCad versions\n\nverify <NAME>          Run 8-point verification on an installed library\n  --library-path       Windows path where library was installed\n```\n\n## Example\n\n```bash\nadom-kicad-library-importer install LIB_LAN9370-I_KCX.zip \\\n  --library-name \"LAN9370\" \\\n  --library-path 'C:\\Users\\noah\\KiCAD Libraries\\hydrogen-library'\n```\n\nInstalls:\n- `hydrogen-library\\LAN9370.kicad_sym` (symbol + sym-lib-table entry)\n- `hydrogen-library\\LAN9370.pretty\\QFN40P800X800X90-65N.kicad_mod` (footprint + fp-lib-table entry)\n- `hydrogen-library\\LAN9370.3dshapes\\LAN9370-I_KCX.stp` (3D model, referenced by footprint)\n\n## Requirements\n\n- `adom-desktop` CLI installed and relay running\n- Adom Desktop app connected on Windows\n- KiCad 9.0 installed on Windows\n\n## Source\n\n- GitHub: [adom-inc/adom-kicad-library-importer](https://github.com/adom-inc/adom-kicad-library-importer) (private)\n",
  "author": {
    "id": "695820315b5f1e4db2fcf602",
    "name": "Kyle Bergstedt",
    "email": "kyle@adom.inc"
  },
  "visibility": {
    "public": true
  },
  "hero": null,
  "metadata": {},
  "created_at": "2026-05-28T05:28:46.019Z",
  "updated_at": "2026-05-28T05:28:46.019Z",
  "skills": []
}