Skip to content

Latest commit

 

History

History
105 lines (75 loc) · 4.45 KB

README.md

File metadata and controls

105 lines (75 loc) · 4.45 KB

KiKit – Automation for KiCAD

KiKit is a Python library, KiCAD plugin and a CLI tool to automate several tasks in a standard KiCAD workflow like:

KiKit Promo

Do You Enjoy KiKit or Does It Save You Time?

ko-fi

KiKit is currently undergoing large changes. If you use stable version read!

The documentation for latest stable (v0.7) is available at https://github.com/yaqwsx/KiKit/tree/v0.7

Installation

KiKit is available as a PyPi package, therefore, you can install it via pip:

pip3 install kikit

If you would like to test the upstream version (which can have more features implemented but is not guaranteed to be fully tested), you can install it via:

pip3 install git+https://github.com/yaqwsx/KiKit@master

Note that if you have a stable version installed, you need to add --force to upgrade it to upstream.

Note that to use KiCAD GUI plugins, you have to enable them – see the installation guide for more details.

If you would like to use KiKit on Windows or MacOS, see the installation guide.

Why Should I Use It?

Everything KiKit does, can also be done via Pcbnew in KiCAD. However, you have to do it manually. One of the common scenarios is the creation of panels. Most of the tutorials on the internet guide you to use the "append board" functionality of Pcbnew. However, this approach is labour-intensive, error-prone and whenever, you change the board, you have to do it again.

With KiKit you just call a CLI command if you have a simple layout (e.g., a grid) or write few Python instructions like "place board here", "add bridge here", "separate boards via mouse bites/v-cuts" and you are done. The process is repeatable and actually much simpler than hand-drawing the panels. KiKit also allows you to easily export all the Gerbers in a single step.

You can then write a Makefile and simply call make to get all your manufacturing data and board presentation pages.

See BatteryPack as an example usage of KiKit. Also see an example presentation page generated by KiKit.

Feature List

How To Use It?

Read the CLI documentation and the panelize documentation. Also don't miss the examples. If you are interested in generating solder paste stencils, see Stencil documentation

KiKit Is Broken or Does Not Work as Expected

Please, first check FAQ. If you have not found answer for your problem there, feel free to open an issue on GitHub.

If you would like to have a feature in KiKit that is currently not on a roadmap, or if you need to prepare custom panelization script (e.g., multi-design panels, panels with specific arrangement), you can consider hiring me to do the job. Just reach out to me via e-mail and we can discuss further details.

How To Use It CI?

To use KiKit in CI (e.g., Travis) you can use prepared Docker image yaqwsx/kikit. Also see example .travis.yml.