I had KiCad 4 installed previosly. Now i updated to v5. Now i have some problems with the library setup


Recommended reading: Library management in KiCad version 5

If you had KiCad 4.0.x installed previously then i would bet you still have parts of its configuration surviving. Most importantly the fp-lib-table. This file controls which footprint libs you use. If this is the case then you probably still run the on demand online footprint libs originally “distributed” with KiCad 4.0.x installations. The installer for the KiCad 5.0.0 however replaced the local symbol and 3d model files. This means your lib is now inconsistent. (There was a rather large reorganization in the library between these two releases)

It is easy to discover if this is the case. Open the library manager in pcb_new and check if you have any lib with the prefix Housings (example Housings_DIP) if this is the case you run the version 4 footprint libs. (These libs have been renamed to the better fitting suffix Package in the version 5 library)

Option 1: Update the library setup to use version 5 footprint libs (recommended)

This will mean that old projects are harder to work with. (You no longer have the same lib as you had back when you designed the project.) It might be worth the extra effort as the new lib has some major improvements. (The quality of both footprints and symbols did increase. The organization scheme is now easier to understand, …)

For this you need to update the fp-lib-table to use version 5 libs. The libraries should already be installed locally. The libs should be found under C:\Program Files\KiCad\share\kicad\modules for windows users and /usr/share/kicad/modules for linux users. If they are not installed read this post

The safest way is to use the library manager and add the libs manually.

  • Open the lib manager found in the preferences menu of the footpritn editor (In v5.1 this will also be found in the preferences menu of the kicad main window)
  • Delete all old libs from the lib table (the ones starting with ${KIGITHUB})
  • Use the browse button to add the new libs
    • It opens a tool similar to the file browser.
    • Navigate to the location of the libs and select the ones you want to add. (You can use shift left click and crtl left click to select multiple libs at once. Only select .pretty directories.)

The second option is to delete your old fp-lib-table from your config directory (under windows found in C:\Users\ …\AppData\Roaming\kicad for linux users it is found in ~/.config/kicad. For OSX it is found under /Users/[your user name]/Library/Preferences/kicad).
When you then start pcb_new from the project manager kicad should ask you if it should create the default library table. After this step you will need to manually add your personal libs again. (As you deleted the file pointing to them.)

Option 2: Downgrade all libs to version 4 libraries.

This option allow you to work with old projects easily but locks you in the old lib that is no longer maintained.

  • Replace the symbol and 3d models that where installed with version 5 of kicad. (Download the 4.0.x release of your choice from: https://github.com/KiCad/kicad-library/releases or clone the git repository and checkout the version you want.)
    • You can place the downloaded files anywhere. The safest option is to use some place inside your home directory.
  • Point your sym-lib-table to this installation.
    • Use the library manager found in the preference menu of the symbol editor (In v5.1 the manager is also available from the kicad main menu)
    • Remove all current libs from the table (Right now the setup will point to v5 libs. You decided to use version 4 libs)
    • Use the browse button to add the libs
      • This opens a file browser like tool
      • Navigate to the place where you put your libs and select the ones you want to add to kicad. (Use the shift and crtl keys to select multiple libs)
  • If necessary also point the KISYS3DMOD path to the place where you put the 3d models. (The path variables are managed with the path setup tool found in the preferences menu of the kicad main window.)

With your current setup you already point to online footprint libs of version 4. ( In more detail you use the current master of the git repository.) As the libs are no longer developed this will unnecessarily use up your data. It is therefore suggested to install the libs locally. Having the libs locally also allows you to install a specific release of the footprints. Read the FAQ article How can i install a specific version of the footprint library? for more details.

Option 3: run both versions of the lib in parallel

The third option is to run both library setups in parallel (or even KiCad 4 and KiCad 5 in parallel) Depending on your operating system this might not be very easily accomplished. (The safest route for a novice is still to run either KiCad 4 or KiCad 5 inside a virtual machine. Everything else requires tampering with system environment variables or startup scripts.)

Additional Information

A detailed description of how the update process could look like can be found in this post (click the link or the arrow to see the full text)

Remap symbol do not fully compatible with 4.0.7
Footprint viewer is empty
Assign footprints is crazy slow
Its looking for deleted lib location
How to assign JST footprint to connector
Global Footprints Lost in Upgrade form 4 to 5.0 on OSX
Not all Footprint Libraries are found
Standard-symbols missing in KiCAD5.0.2 on LINUX-Mint
[Solved] KiCad Crashing Ubuntu
3D Empty header (just holes) array?
Footprint libraries not found on debian (kicad 5.0.2 ; from stretch-backports)
Footprint Assignment Page (CvPcb) Hanging Up ADDITIONAL PROBLEMS
Read Netlist (not responding)
Noob Here - Just starting with KiCad - bom problems - possibly due to my ignorance
KiCAD Crashes Rebuilding Board Connectivity
Noob Here - Just starting with KiCad - bom problems - possibly due to my ignorance
Library does not exist
KiCad 5 - 3D file paths
Getting re-started with KiCad
Specifying a Library Symbol
Set 3D shape to STEP or WRL file
Libraries are empty
Libraries are empty
FAQ Index Thread
Errors were encountered loading footprints:
Mounting holes, can't find any
Download Footprints?
Github footprint libraries missing in KiCad 5
3D models not showing
Error trying to save custom footprint
Mac OS Sierra and Footprints
Fixing footprint library path 4.0.0-rc2?
How to make 3D modeling work in Kicad 5.0.0?
Kicad 5 new symbols load error?
Kicad 5 Fresh Install most footprints missing?
3D models under OSX
CVPCB - Error, component not found in any library
Which option to use when running version 5 first time?
3D models not showing
CvPcb error reading zip
All pcb footprints missing from all libraries
Cursor freezing in schematic
Looking for various footprints (ATMega)
Weirdness with SMD resistor footprints (New KiCAD user)
Kicad5 using old footprints?
KiCad 5.0 should I upgrade from 4.07?
Upgrading to Kicad 5.0.2
Updating Library
KiCad 5 Framebuffer Error & Question
2 important issue plz support PCBnew kicad 5.0
Help to source, install and manage libraries?
KiCad 5.0 should I upgrade from 4.07?
[Solved] How to do a completely clean install on macOS?
Parts Chooser So slow to load, can it stay open?
Confusion about which library to contribute to
3D rendering not working reliably
Kicad 5.01- Installation- can't locate libraries
Problems with KiCAD v5 on Mac
Just upgraded from 4.0.7 to 5.0.2 and I love it!
Kicad Footprint Library Issues
Kicad Footprint Library Issues
Upgrading KiCad 4.07 to Kicad 5 missing all symbols
[solved] Songle Power Relay 3d library