The KiCad Librarian is a utility to manage and maintain libraries with schematic symbols and footprints. It supports the KiCad EDA suite.
A summary of its features:
- You can open two libraries and copy footprints or symbols from one to the other. You can also move footprints/symbols, delete them, or rename them. In the process of moving and copying, the utility may also translate the format from legacy to s-expression, and vice versa.
- You can view footprints, and overlay two footprints (from the same or from two different libraries) to compare them. In the same way, you can view schematic symbols.
- You can create a report (in PDF format) with all footprints or symbols in a particular library.
- The utility extracts the essential parameters from footprints and symbols. For example, for footprints: the pad size, the pitch and centre-to-centre spans of pads; for the symbols, the pin functions and labels. The footprint parameters (dimensions) are also included in the generated reports.
- The utility allows you to edit these parameters as well (with limitations, the librarian is not a full-function part editor). So, changing the size of all 48 pads of a QFN-48, requires only that you edit one or two values (and click "save").
- You can create new parts from templates. Several templates are provided for the most common SMD footprints and a few typical symbol shapes. More templates will be added in the future.
- Most footprint templates include definitions for a 3D model, so when generating a footprint, a matching VRML model is generated alongside. (You can view the 3D shape from within the Librarian as well).
- The utility can connect to a central repository for footprints and symbols, to easily share these parts across different workstations and/or different users.
- It is open source and runs in Microsoft Windows and Linux.
Downloads & license
The KiCad Librarian currently is at version 1.3, build 5692. It is distributed under the Apache License version 2. There are no guarantees or warranties whatsoever; use it at your own risk.
- The KiCad Librarian source code
- The source code of the KiCad Librarian, hosted on GitGub, for all platforms.
- The KiCad Librarian for Microsoft Windows, 32-bit (3.4 MiB)
- The KiCad Librarian in a self-extracting setup (executable only, no source code).
- An example repository implementation, version 0.6 (9.4 KiB)
- A minimalistic, but functional repository implemented in PHP using PDO to access a database (so it can work with MySQL as well as SQLite). There are installation instructions in the archive.
- The file format of footprint and symbol libraries
- My notes on the file format for KiCad footprint libraries and schematic symbol libraries. For the footprints, it covers both the legacy format and the new s-expression format. This is a PDF file.
Changes in version 1.3.5692
- In footprints with a thermal pad, this pad is now formed as a matrix of touching smaller pads (to make it easier for adding multiple vias on a thermal pad).
- The solder paste reduction ratio is visualized. Reducing the apertures on the solder-paste stencil is important for large pads (such as thermal pads).
- Footprints can now be filtered on multiple keywords, as well as on pin count & pitch. Searching & filtering footprints is now significantly faster, through the use of caching the keywords and characteristics of the footprints.
- The footprint report now has an index, for keywords and footprint names.
- Minor updates, such as support for slanted text (italics), an improved GUI with redesigned toolbar icons, and a new footprint template.
- Corrections for issues found since the last release: translation from legacy to s-expression could drop arcs and trhough-hole pads could become SMD pads; the Librarian would fail to locate VRML models under specific circumstances; footprint names with embedded spaces were not supported in s-expression libraries.
There is a manual in each downloadable archive/setup. For a "walk-through" introduction, please see the video below.
On the first launch of the KiCad Librarian, you will have to tell it where to find the libraries, see the menu "Preferences" and choose "Search paths". In contrast to earlier releases, the Librarian no longer plunges into subdirectories recursively —if you have nested paths with libraries, you need to indicate these individually.
To use the repository functions, you have to set one up (or use the demo repository, see below) and configure the Librarian to use it.
The graphic representation of a symbol or footprint may not be indentical to how KiCad shows it, because the Librarian does not use the drawing code of KiCad. This is just a limitation of the preview; if you copy the symbol/footprint to a new library, it will be copied exactly as it is.
If you want to test repository access, but without setting up your own repository, you can use the repository at http://www.compuphase.com/kicad/repository.php. This is a public repository: you do not need an account for read access (download only). You do need an account to upload your own symbols or footprints.
Note: the repository is set up as a proof-of-concept. You can use it to test and evaluate the repository functionality. I may, at some point, remove or clear this demo repository.