linalinn/kicad render pcb

Render KiCad PCBs top, bottom optionally render and gif or mp4 of the PCB rotating

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Mar 20, 2026
License
None

Pinned Snippet

workflow.ymlSHA-pinned
uses: linalinn/kicad-render@7d719b369a5bb613513a49e7211a13db245c6891 # v0.4

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
pcb_filePath to your .kicad_pcbyes
output_pathPath to where top.png and bottom.png should be createdyes
zoomCamera zoom, default 1no
backgroundImage background. Options: transparent, opaque. Default: opaque for JPEG, transparent for PNGnoopaque
animationIf an animation of the PCB rotating should be rendered (mp4 or gif) (background dose not apply)no
prefixSet a prefix for the images diffrent from project nameno
pre_renderPath to shell file which will be sourced before rendering. This can be used to e.g. install missing fonts or set configuration via enviromet variables.no
kicad_cli_optionsAdd varios cli options that are not exposed by the actionno

no outputs