Adom KiCad Library

@@ -60,17 +60,45 @@ takes it.  --- -## Installing without the repository URL+## Adding the libraries by hand, without PCM -If you cannot reach the URL, or you want to pin an exact version:+Each release ships **two zips**, and they are not interchangeable: -1. Download the `.zip` from+| Download | Model paths | Use it for |+|---|---|---|+| `adom-kicad-library-<ver>-manual.zip` | `../../3dmodels/...` | adding the libraries by hand |+| `adom-kicad-library-<ver>-pcm.zip` | `${KICAD_3RD_PARTY}/3dmodels/<id>/...` | PCM, which is what the URL above fetches |++They differ only in how each footprint points at its 3D model. PCM extracts+footprints to `<3RD_PARTY>/footprints/<id>/` and models to+`<3RD_PARTY>/3dmodels/<id>/`, which are sibling trees under different parents,+so a relative path cannot reach across. A hand-install keeps the folders+together, where the relative path is exactly right and no path variable is+needed.++Grab the wrong one and the footprints and symbols still work, but the 3D viewer+comes up empty.++### Manual install++1. Download **`adom-kicad-library-<ver>-manual.zip`** from    [Releases](https://wiki.adom.inc/adom/adom-kicad-library) on this page.-2. In KiCad, go to **Tools** -> **Plugin and Content Manager**.-3. Click **Install from File...** at the bottom and pick the zip.+2. Extract it somewhere permanent and **keep the folder structure intact**. The+   footprints reach their 3D models by relative path, so moving+   `3dmodels/` away from `footprints/` breaks them.+3. **Preferences** -> **Manage Footprint Libraries** -> **+**, and point it at+   `footprints/adom-kicad-footprint-library.pretty`.+4. **Preferences** -> **Manage Symbol Libraries** -> **+**, and point it at+   `symbols/adom-kicad-footprint-library.kicad_sym`. -This installs the same package. The tradeoff is that KiCad will not tell you when-a newer version exists.+`metadata.json` in the zip is PCM bookkeeping. A manual install ignores it.++### Offline PCM install++To use PCM but pin an exact version, download+**`adom-kicad-library-<ver>-pcm.zip`**, then **Tools** -> **Plugin and Content+Manager** -> **Install from File...**. Same package the URL serves, except KiCad+will not tell you when a newer version exists.  --- @@ -117,6 +145,11 @@ Every field is validated, and one bad value fails the whole repository rather th a single package, so no libraries appear at all. This was fixed in v1.2.1. If you see it, you are on an older cached copy: remove the repository and re-add it. +**Footprints place fine but the 3D viewer is empty.** You are on 1.2.0 or 1.2.1,+which shipped relative model paths in the PCM package. Update to 1.2.2 or newer.+If you installed by hand, check you used the `-manual.zip` and that `3dmodels/`+is still beside `footprints/`.+ **The library does not appear in the Libraries tab.** Check the dropdown at the top-left is set to "Adom KiCad Repository" and not the default KiCad repository. 

@@ -4,11 +4,27 @@   "slug": "adom-kicad-library",   "title": "Adom KiCad Library",   "brief": "KiCad PCM library of Adom machine pin and machine contact footprints, symbols, and 3D models",-  "version": "1.2.1",-  "tags": ["adom", "adom-modular", "kicad", "library", "footprints", "machine-pin"],+  "version": "1.2.2",+  "tags": [+    "adom",+    "adom-modular",+    "kicad",+    "library",+    "footprints",+    "machine-pin"+  ],   "license": "proprietary",   "visibility": "public",-  "hero": { "type": "image", "path": "screenshots/hero.png" },-  "discovery_triggers": ["adom kicad library", "machine pin footprint", "kicad pcm adom", "install adom kicad library", "machine contact footprint"],+  "hero": {+    "type": "image",+    "path": "screenshots/hero.png"+  },+  "discovery_triggers": [+    "adom kicad library",+    "machine pin footprint",+    "kicad pcm adom",+    "install adom kicad library",+    "machine contact footprint"+  ],   "org": "adom" }

@@ -24,6 +24,15 @@         "homepage": "https://github.com/adom-inc/adom-kicad-library"       },       "versions": [+        {+          "version": "1.2.2",+          "status": "stable",+          "kicad_version": "8.0",+          "download_sha256": "1e2736530506a85ea09d0f1813207304173ebb17fba37c4f019d9f5d00648d66",+          "download_url": "https://wiki.adom.inc/download/adom/adom-kicad-library/1.2.2/adom-kicad-library-1.2.2-pcm.zip",+          "download_size": 254059,+          "install_size": 1124846+        },         {           "version": "1.2.1",           "status": "stable",@@ -41,15 +50,6 @@           "download_url": "https://wiki.adom.inc/download/adom/adom-kicad-library/1.2.0/adom-kicad-library-1.2.0.zip",           "download_size": 253819,           "install_size": 1124533-        },-        {-          "version": "1.1.1",-          "status": "stable",-          "kicad_version": "8.0",-          "download_sha256": "0d6ca432ef842224060eb0351425e19255748e21f289755a8bd9bbc696773f36",-          "download_url": "https://wiki.adom.inc/download/adom/adom-kicad-library/1.1.1/adom-kicad-library-1.1.1.zip",-          "download_size": 253819,-          "install_size": 1124534         }       ]     }

@@ -9,8 +9,8 @@   },   "packages": {     "url": "https://wiki.adom.inc/adom/adom-kicad-library/render/pcm/packages.json",-    "sha256": "bf369bffc2518096650d764f7aa929fc5d26afe932692ccf11460afb95f505d6",-    "update_time_utc": "2026-07-30 21:17:53",-    "update_timestamp": 1785446273+    "sha256": "d980af1c46654a6bad0cd08ee4e986cb3830ed4c055f5e31b31894c29d68b9f7",+    "update_time_utc": "2026-07-31 17:59:51",+    "update_timestamp": 1785520791   } }