Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
February 8, 2022 10:05
February 3, 2022 16:10
October 1, 2021 12:33
November 3, 2021 09:47
October 1, 2021 12:33
March 10, 2021 14:04
February 8, 2022 10:05


GitHub GitHub last commit Read the Docs

SVG diagram creation from Python code - pinout provides an easy method of creating pinout diagrams for electronic hardware.

Example diagram created from pinout.

Please visit for the full quick start tutorial and detailed documentation on all options provided by the pinout package.

Quick start

pinout can be easily installed with pip and provides some sample files that demonstrate key features.


Using a virtual environment is recommended; Start by installing the pinout package. Either clone this repo and pip install it or install from PyPi:

pip install pinout

# Or upgrade to the latest version
pip install --upgrade pinout

Duplicate sample files

A normal pinout diagram will include a hardware image, stylesheet, data file, and a Python script. Sample files are included with the package and can be duplicated for your use. Open a command line (with enabled virtual environment if you are using one) in the location you plan to work and enter the following:

py -m pinout.manager --duplicate quick_start

# expected output:
# >>> duplicated.
# >>> hardware.png duplicated.
# >>> duplicated.
# >>> styles.css duplicated.

Once you have these file a finished diagram can be generated from a command line py -m pinout.manager --export pinout_diagram diagram.svg. An SVG file is created and can be conveniently view in a browser.

SVG diagram

For a detailed walk through and more information on pinout please visit