kitspace / kicad_footprints Goto Github PK

View Code? Open in Web Editor NEW

310.0 22.0 46.0 428 KB

A collection of all the KiCad footprints on the internet

Home Page: https://github.com/kitspace/kicad_footprints#readme

License: MIT License

Python 75.06% Shell 24.94%

kicad electronics kicad-footprints pcb

kicad_footprints's Introduction

KiCad footprint collection

This is a collection of all the KiCad footprints I know of. If you know of any more, please let me know! (Ideally by opening a pull-request or at least an issue on this repo.)
These footprints are regularily checked with the Github Action workflow to make sure KiCad can load them.
After you register them with KiCad you can use the footprint filter in the footprint assignment tool to find what you want.

This repo uses git submodules. A submodule is a way of including another git repo in your repo holding it at a particular version until you want to update it. This is useful as you can keep a local copy of all the libraries and only update them when you want to.

Usage

Initialization

git clone https://github.com/kitspace/kicad_footprints
cd kicad_footprints && ./init

This downloads all the libraries in parallel but it can still take a while.

If you are stuck on KiCad version 4 or version 5 can use the kicad-4 or the kicad-5 branch. These branches are not being updated though.

Ignoring Modules

Create a file ignore_modules.txt and add a sub-string to match per line for module names to ignore. For example to ignore the official KiCad modules from this repo (since they are already included with KiCad) ignore_modules.txt would be:

kicad-official

If adding lines to ignore_modules.txt having already run ./init then run ./deinit to de-register the modules affected by the lines.

Updating

If you want to update all libraries to their latest versions do:

./update

Warning: ./update will git reset --hard the submodules so don't make changes in these folders that you want to keep. Make a separate clone of the submodule respository for that.

If you want to pull in any libraries that have been added since your initial clone:

git pull && ./init

Registering with KiCad

You can add these libraries manually through the KiCad GUI of course. You could also use generate_table to generate an fp-lib-table, the file KiCad uses as a footprint registry, with all the footprints from this repository. You can use this to replace your existing fp-lib-table. You will need to restart KiCad for this change to take effect.

Warning: This will overwrite your existing fp-lib-table, discard any customization you made to it and also switch to using our copy of the "official" libraries included with KiCad (these are henceforth prefixed with kicad-official/). In our instructions below we make a backup copy of the fp-lib-table so can restore it if you need to.

Linux

cp ~/.config/kicad/6.0/fp-lib-table ~/.config/kicad/6.0/fp-lib-table.backup
./generate_table ~/.config/kicad/6.0/fp-lib-table

Mac OS

cp ~/Library/Preferences/kicad/6.0/fp-lib-table ~/Library/Preferences/kicad/6.0/fp-lib-table.backup
./generate_table ~/Library/Preferences/kicad/6.0/fp-lib-table

Windows (using git-bash)

cp ~/AppData/Roaming/kicad/6.0/fp-lib-table ~/AppData/Roaming/kicad/6.0/fp-lib-table.backup
./generate_table ~/AppData/Roaming/kicad/6.0/fp-lib-table

Restoring original

If you don't like the new way of organizing footprint libs and want to restore your original fp-lib-table:

Linux

cp ~/.config/kicad/6.0/fp-lib-table.backup ~/.config/kicad/6.0/fp-lib-table

Mac OS

cp ~/Library/Preferences/kicad/6.0/fp-lib-table.backup ~/Library/Preferences/kicad/6.0/fp-lib-table

Windows

cp ~/AppData/Roaming/kicad/6.0/fp-lib-table.backup ~/AppData/Roaming/kicad/6.0/fp-lib-table

3D models

You can try and hack the 3D models to be correctly associated to the footprints through absolute paths by running this script:

python3 rewrite_3d_model_paths.py

This script uses dirty regexes to re-write the paths when it finds models of the same name in the same sub-module repository.
It can take up to 5 minutes on my machine.
If you ever run ./update you have to run rewrite_3d_model_paths.py again.

Adding submodules

If you know of any KiCad footprint repositories that have not been added please file an issue and I will add them.

If you want to maintain a private fork of this repository with some private submodules you can add them simply by:

git submodule add <git url> <folder>
git commit

They should work fine with the rest of the scripts once they are added.

License

Any scripts in this repository are MIT licensed. All the footprints have their own licenses of course.

kicad_footprints's People

Contributors

Stargazers

Watchers

kicad_footprints's Issues

Cloning of out-of date submodules is failing

As reported in #2. Not up-to date submodules will fail on init:

Cloning xesscorp/RPi_Hat.pretty
Cloning xesscorp/xess.pretty
remote: Total 0 (delta 0), reused 0 (delta 0), pack-reused 0
error: no such remote ref 9f166ffe86d1f3e41b1b8ce0c034773ac0f7983b
Fetched in submodule path 'tylercrumpton/CrumpPrints.pretty', but it did not contain 9f166ffe86d1f3e41b1b8ce0c034773ac0f7983b. Direct fetching of that commit failed.
falling back to deep clone for tylercrumpton/CrumpPrints.pretty
error: no such remote ref 9f166ffe86d1f3e41b1b8ce0c034773ac0f7983b
Fetched in submodule path 'tylercrumpton/CrumpPrints.pretty', but it did not contain 9f166ffe86d1f3e41b1b8ce0c034773ac0f7983b. Direct fetching of that commit failed.
 ** Failed ** tylercrumpton/CrumpPrints.pretty

CvPcb load error on lowstar and adamjvr

Back to Ubuntu from OSX and giving your footprints compilation a good try :)

I just found this:

Errors were encountered loading footprints:
PARSE_ERROR: Expecting 'circle, rectangle, oval, or trapezoid' in input/source '/home/romanvg/dev/kicad_footprints/adamjvr/KiCAD-OnHand-Lib/OnHand-Components.pretty/C1206.kicad_mod' line 20 offset 14 from /build/kicad-lOwy61/kicad-4.0.4+dfsg1/common/dsnlexer.cpp : Expecting() : line 369
PARSE_ERROR: Expecting 'circle, rectangle, oval, or trapezoid' in input/source '/home/romanvg/dev/kicad_footprints/lowstar/IPC7351C-Nominal.pretty/LEDC160X80X65L30N.kicad_mod' line 24 offset 14 from /build/kicad-lOwy61/kicad-4.0.4+dfsg1/common/dsnlexer.cpp : Expecting() : line 369

Would it be possible to run the kicad lexer standalone or sth on travis so that those don't ever show up later on?

#idea

Include another repository

git://smisioto.eu/kicad_libs.git

Include the python script that generates a catalog of footprints

The script that was provided here [1] is very awesome. it generates a pdf catalog containing all footprints and with its image preview.
Maybe you can add a caller script that will traverse all repositories and generate a catalog for each one inside a common directory.

[1] - https://forum.kicad.info/t/full-footprint-library-lists-ideally-in-ascii/3334/9

Contributor guideline

Hi, nice work here.

Would be great if you could add some info about how to contribute repos not yet in this collection.

Found this https://github.com/natsfr/kicad-components and would like to add.

Add official espressif library

The espressif kicad libraries contains ESP related footprints and symbols.

The LICENSE.md states:

These are the same license conditions as those used by KiCad project for the official libraries: https://www.kicad.org/libraries/license/.

This library contains e.g. the ESP32-C3 module footprints and symbols.

Adding on Windows?

Hi,

I am running KiCad on Windows. I've successfully generated a fp-lib-table file using Python with generate_table script and then moved it to C:\Users\%username%\.config\kicad directory. However, I am not seeing the footprints in CvPcb when I am loading it. Am I missing something or this is not supported?

For what it's worth, there are several fp-lib-table files in KiCad installation directory, however I am not sure what is the right one to replace if that's what is necessary.

Thanks!

Does this also work with KiCad 5.99 nightly (de-facto version 6.0)?

I have installed kiCad nightly 5.99, which will be the upcomming version 6. But apparently this method is not compatible with 5.99. Is there a fix for that?

Script to remove kicad 6 incompatible files

I noticed that when I run ./update there's now a bunch of files that start with (footprint that cause footprint loading to fail completely in KiCad 6.0.10 and earlier. You can reproduce this locally by running python load_all.py where you'll get an IO_ERROR.

My previous strategy was to remove repos when they use unstable features, but we lose a lot of footprints that way that are actually still compatible. It's also more work for me. Would be better to have a script to remove these files.

Parsing errors in stable KiCAD

After running ./generate-table and copying it into the OSX location for it (doing a .backup of the former first as advised in the README):

~/Library/Preferences/kicad/fp-lib-table

I'm getting this couple of footprint parsing errors while running CvPcb on KiCad 4.0.5:

Errors were encountered loading footprints:
PARSE_ERROR: Expecting 'circle, rectangle, oval, or trapezoid' in input/source '/Users/romanvg/dev/kicad_modules/kicad_footprints/lowstar/IPC7351C-Nominal.pretty/CAPC160X80X87L35N.kicad_mod' line 24 offset 14 from /Users/ansible/4.0.5/kicad-mac-packaging-4.0.0/kicad/common/dsnlexer.cpp : Expecting() : line 369
PARSE_ERROR: Expecting 'circle, rectangle, oval, or trapezoid' in input/source '/Users/romanvg/dev/kicad_modules/kicad_footprints/adamjvr/KiCAD-OnHand-Lib/OnHand-Components.pretty/BLM15HG601SN1D.kicad_mod' line 16 offset 14 from /Users/ansible/4.0.5/kicad-mac-packaging-4.0.0/kicad/common/dsnlexer.cpp : Expecting() : line 369

wiebus repo fails on OSX

I was following the installation instructions and hit this error:

(...)
Submodule 'vontrapp/vontrapp.pretty' (https://github.com/vontrapp/vontrapp.pretty.git) registered for path 'vontrapp/vontrapp.pretty'
Submodule 'wiebus/SOT23_SOT143_SOT143R_TSOT6_MK06A_SC70-6_Housing_14Mar2014.pretty' (https://github.com/wiebus/SOT23_SOT143_SOT143R_TSOT6_MK06A_SC70-6_Housing_14Mar2014.pretty.git) registered for path 'wiebus/SOT23_SOT143_SOT143R_TSOT6_MK06A_SC70-6_Housing_14Mar2014.pretty'
Submodule 'xesscorp/RPi_Hat.pretty' (https://github.com/xesscorp/RPi_Hat.pretty.git) registered for path 'xesscorp/RPi_Hat.pretty'
Submodule 'xesscorp/xess.pretty' (https://github.com/xesscorp/xess.pretty) registered for path 'xesscorp/xess.pretty'
xargs: illegal option -- i
xargs: illegal option -- i
usage: xargs [-0opt] [-E eofstr] [-I replstr [-R replacements]] [-J replstr]
             [-L number] [-n number [-x]] [-P maxprocs] [-s size]
             [utility [argument ...]]

Apparently gxargs the GNU version of xargs is no longer in Homebrew, so I switched to GNU parallel and it went fine.

I hesitated to file a pullrequest since I'm not sure if you want to require users to install GNU parallel.

In any case, nice collection of kicad libs, thanks a ton for this effort!

liubenyuan

https://github.com/liubenyuan/kicad-xeit/ no longer exists.
Please remove or adapt link.

KiCAD footprint repositories that have not been added

https://github.com/4ms/4ms-kicad-lib/tree/master/lib-footprints
https://github.com/4ms/4ms-kicad-lib/tree/master/4ms-footprints.pretty
https://github.com/tristan-smith/HA_KicadLibraries
https://github.com/russellmcc/russell_kicad/tree/master/russell.pretty
https://github.com/russellmcc/eurorack_kicad/tree/master/eurorack.pretty
https://github.com/recursinging/kxmx/tree/master/kxmx_erack/kicad/kicad/libraries/krachmacher.pretty
https://github.com/nebs/eurocad/tree/master/Eurocad.pretty
https://github.com/peekpt/kicad_smisioto/tree/master/modules/walter

Path is /cygdrive/c/Users instead of c:/Users

I'm using the window branch, when generating fp_lib_table using Git Bash, it becomes :-

(lib (name "digikey/digikey-footprints.pretty")(type KiCad) (uri "/cygdrive/c/Users/stanley/Documents/Github/kicad_footprints/digikey/digikey-footprints.pretty") (options "") (descr ""))

This is a Win 7 32-bit version..

I have another Win 7 64-bit version with no such issues ...
Any idea why ??

Include a config file to exclude libraries

It'd be convenient if we could ignore any number of these submodules. A simple ignore_modules file would suffice, one ignored submodule name per newline. This way I could ignore some repos, for example the official one (because I already have it in my distro).

Digikey Partner Library

I believe this hasn't been included yet:

https://github.com/Digi-Key/digikey-partner-kicad-library

Note this is different than https://github.com/Digi-Key/digikey-kicad-library, which has been added.

Seeed Studio Open Part Library

Seeed Studio have Kicad OPL but they are in zip format...

https://github.com/Seeed-Studio/OPL_Kicad_Library

Pls help to add them to this great KiCad footprint collections...

Thanks

kitspace / kicad_footprints Goto Github PK

kicad_footprints's Introduction

KiCad footprint collection

Usage

Initialization

Ignoring Modules

Updating

Registering with KiCad

Linux

Mac OS

Windows (using git-bash)

Restoring original

Linux

Mac OS

Windows

3D models

Adding submodules

License

kicad_footprints's People

Contributors

Stargazers

Watchers

Forkers

kicad_footprints's Issues

Recommend Projects

Recommend Topics

Recommend Org