Where Did Your PCB Go Wrong? KiRI Knows

When working on a PCB design in KiCad, it’s helpful that the files are all text and can easily be checked into Git or other source control. However, stepping back through the revisions to determine where precisely a trace got routed wrong can be tricky. [Leandro] started with a simple script that exported the KiCad project to an image for inspection — over time it grew into a full-blown visual diff tool named KiCad Revision Inspector (KiRI).

The primary mechanism exports the revisions of a KiCad 5, 6, or 7 project to SVG, which can then be compared via a handy onion skin view. As this is a tool written for those using KiCad, shortcuts are a huge part of the experience. A command line interface generates artifacts to view the diff in any web browser. As these outputs have the KiRI tooling baked in, it is relatively easy to archive the output as a build artifact and allow easy access to review design changes.

For the long-time reader, you might remember back in 2018 talked about another diffing tool called plotgitsch (which this KiRI uses for KiCad 5 projects). KiCad has grown significantly in the last five years. It might be time to update our tips to utilize Git better for your PCB designs.

Thanks to [Marcel] for sending this one in.

5 thoughts on “Where Did Your PCB Go Wrong? KiRI Knows

    1. I picked this up recently too. Do be aware that it stores a big cache that not only has to be .gitignored, but also excluded from auto-generate scripts and such. That bit me a couple times,

      1. Actually, you don’t have to include these items in your ‘.gitignore’ file, but doing so will help keep your Git repository organized. You simply don’t need to add them to the repository, considering that kiri files are generated and can be regenerated the next time. Alternatively, you could utilize the ‘-d’ flag to store these items in a separate path or folder.

Leave a Reply

Please be kind and respectful to help make the comments section excellent. (Comment Policy)

This site uses Akismet to reduce spam. Learn how your comment data is processed.