app
Adom KiCad Library
Public Made by Adomby adom
KiCad PCM library of Adom machine pin and machine contact footprints, symbols, and 3D models
← Commit history
downloads: one zip for humans, PCM payload served from the feed
1 file changed
+13−34
README.md+13−34@@ -62,45 +62,24 @@ takes it. ## Adding the libraries by hand, without PCM -Each release ships **two zips**, and they are not interchangeable:+The **Download** button on this page gives you `adom-kicad-library-<ver>.zip`,+which is the hand-install bundle. Its footprints reach their 3D models by+relative path, so it works as long as the extracted folders stay together. -| Download | Model paths | Use it for |-|---|---|---|-| `adom-kicad-library-<ver>-manual.zip` | `../../3dmodels/...` | adding the libraries by hand |-| `adom-kicad-library-<ver>-pcm.zip` | `${KICAD8_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. 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+1. Download it and extract somewhere permanent, **keeping the folder structure+ intact**. Moving `3dmodels/` away from `footprints/` breaks the 3D models.+2. **Preferences** -> **Manage Footprint Libraries** -> **+**, and point it at `footprints/adom-kicad-footprint-library.pretty`.-4. **Preferences** -> **Manage Symbol Libraries** -> **+**, and point it at+3. **Preferences** -> **Manage Symbol Libraries** -> **+**, and point it at `symbols/adom-kicad-footprint-library.kicad_sym`. -`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.+`metadata.json` in the zip is PCM bookkeeping. A hand-install ignores it. +The package PCM fetches is a different build of the same library, with model+paths rewritten to `${KICAD8_3RD_PARTY}/3dmodels/<id>/...` because PCM installs+footprints and 3D models into sibling trees that a relative path cannot reach+across. It is served from the feed rather than offered as a download, since it+is only useful to KiCad itself. ## What is in it