An Open Source Tool To Document Your Wiring

Nov 21, 2023

Most of us are familiar with the tools available to create circuit diagrams, as generally that's the first step towards producing a custom PCB. But that about the cables and wiring harnesses that don't live on your board? How do you easily document the rat's nest perfectly logical wiring of your latest and greatest creation?

That's precisely the question that led [Daniel Rojas] to create WireViz. This open source Python tool takes human readable input files and turns them into attractive and functional visualizations of where all the wires in your project are going. It can even be used to generate a Bill of Materials that documents the lengths of wire required and types of connectors needed to hook everything up.

If you’re still using pre-made cables to connect all of your components together, than you might not immediately see the benefit of a tool like this. But as we’ve talked about in the past, the creation of custom wiring harnesses is something that serious hardware hackers should become familiar with. Yes it takes more effort, but the end result is worth it. With a tool like WireViz, the creation of a bespoke harness for your next project just got a little bit easier.

[Daniel] has done a fantastic job documenting this project, providing not only a tutorial on how to feed and care for your WireViz, but a gallery of examples that shows off the kind of complex wiring the tool can help make sense of. But there's plenty more to be done, and he's happy to get feedback or code contributions from anyone who wants to get involved.