← Commit history

Initial commit: app/kicad-library-manager

barrett-land ·46ebc893e3 ·3mo ago
2 files changed +107
README.mdadded+54
@@ -0,0 +1,54 @@+# KiCad Library Manager++**Organize your personal KiCad libraries fast.** Probe your machine, then work across three+priority views with inline editing, live previews, and one-click sync back to disk.++![KiCad Library Manager](docs/shot.png)++## What it is++A Hydrogen webview app that reads your **own** KiCad libraries (via the adom-desktop bridge),+lets you reorganize and edit them, and writes the changes back — with reversible backups the+whole way. It doesn't scrape vendors or invent CAD; it manages what you already have (plus+optional one-click adds from the Adom wiki).++## Three views++- **Symbol priority** — grouped by symbol library. Every field is inline-editable: symbol name,+  reference letter, the linked footprint (with **autocomplete** ranked by package/ref family),+  datasheet (a small icon — green when it's a real link), the **LCSC / JLC part number**+  (hover it for **live JLCPCB stock + price breaks**), and a description (expandable editor).+- **Footprint priority** — grouped by `.pretty`. Shows each footprint's 3D model and the number+  of symbols using it (click to expand the list).+- **3D-model priority** — grouped by folder, with the footprints that reference each model.++## Highlights++- **Probe** finds your `sym-lib-table` / `fp-lib-table` and personal libraries automatically.+- **Previews** — click 🔍 to see the symbol + its linked footprint rendered by KiCad's own+  `kicad-cli` (themed for a dark canvas, pad numbers on top), or a footprint with its **3D model**+  in an interactive viewer; standalone 3D-model previews too.+- **Add / duplicate** — pull a part (symbol + footprint + 3D) from the Adom wiki, add a blank+  symbol/footprint, or duplicate a symbol.+- **Flags + undo** — delete flags a row **red**, new items show **green**; nothing touches disk+  until you **Sync**. Full undo/redo tree (Ctrl+Z / Ctrl+Shift+Z) and revert-to-backup.+- **Flags** for libraries not registered in your lib-table and footprints that come from a KiCad+  default (stock) library.+- **Sync** — write edits/adds/deletes to disk with `.klm.bak` backups and a reversible+  `.klm-trash/`, per-library or all at once; a chip shows `N new · N deleted · N changed`.++## Running++```bash+kicad-library-manager serve     # start the server on :7823+kicad-library-manager app       # open it as a Hydrogen webview tab  (alias: klm)+```++## Requirements++- **adom-desktop** bridge (to reach your filesystem + shell).+- **kicad-cli** (KiCad 9) on the desktop for symbol/footprint previews.+- **step2glb** + the JLCPCB search service for 3D model conversion and live stock/price+  (the app degrades gracefully if they're unavailable).++Pure-Node HTTP server, zero native deps, single-file vanilla-JS SPA.
page.jsonadded+53
@@ -0,0 +1,53 @@+{+  "schema_version": 1,+  "type": "app",+  "slug": "kicad-library-manager",+  "title": "KiCad Library Manager",+  "brief": "Organize your KiCad symbol / footprint / 3D libraries fast — three priority views, inline editing, live previews, and one-click sync.",+  "version": "1.0.0",+  "description": "A fast workbench for your personal KiCad libraries. Probes your machine via adom-desktop for your sym-lib-table / fp-lib-table, then gives you three views — Symbol priority (inline-editable ref / footprint / datasheet / LCSC PN / description, with footprint autocomplete and live JLCPCB stock+price on hover), Footprint priority (3D model + the symbols using each footprint), and 3D-model priority. Add parts from the Adom wiki or blank, duplicate symbols, flag deletes (red) and adds (green) with an undo/redo tree, preview symbols + footprints + 3D models with kicad-cli rendering, and sync changes back to disk with reversible backups.",+  "dependencies": {},+  "tags": [+    "eda",+    "kicad",+    "library",+    "symbol",+    "footprint",+    "3d-model",+    "jlcpcb",+    "lcsc",+    "cad",+    "library-manager",+    "adom-desktop",+    "preview"+  ],+  "hero": {+    "type": "billboard",+    "headline": "KiCad Library Manager",+    "subhead": "Three priority views, inline editing, live previews, one-click sync to disk.",+    "screenshot": "docs/shot.png"+  },+  "files": [+    "server.js",+    "cli.js",+    "public/index.html",+    "page.json",+    "SKILL.md",+    "README.md",+    "DEVELOPING.md",+    "install.sh",+    "uninstall.sh",+    "docs/shot.png",+    "package.json"+  ],+  "scripts": {+    "start": "node server.js",+    "install": "./install.sh",+    "uninstall": "./uninstall.sh"+  },+  "org": "adom",+  "author": {+    "name": "barrett-land",+    "email": "[email protected]"+  }+}\ No newline at end of file