Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
cpu

GitHub Action

kicad-exports

v2.0

kicad-exports

cpu

kicad-exports

auto generate exports (schematics, gerbers, plots) for any KiCAD5 project

Installation

Copy and paste the following snippet into your .yml file.

              

- name: kicad-exports

uses: nerdyscout/kicad-exports@v2.0

Learn more about this action in nerdyscout/kicad-exports

Choose a version

Auto generate exports (schematics, gerbers, plots) for any KiCAD project. You could run it locally or on every git push with Github Actions.

usage of kicad-exports with Github Actions

name: example

on:
  push:
    paths:
    - '**.sch'
    - '**.kicad_pcb'
  pull_request:
    paths:
      - '**.sch'
      - '**.kicad_pcb'

  jobs:
    example:
      runs-on: ubuntu-latest
      steps:
      - uses: actions/checkout@v2
      - uses: nerdyscout/kicad-exports@v2.0
        with:
        # Required - kiplot config file
          config: docs.kiplot.yaml
        # optional - prefix to output defined in config
          dir: .
        # optional - schematic file
          schema: *.sch
        # optional - PCB design file
          board: *.kicad_pcb
      - name: upload results
        uses: actions/upload-artifact@v2.0
        with:
          name: docs
          path: docs

The predefined configs do run a ERC and DRC in advance, if these checks fail no exports will be generated. You could write your own config file and define filters to ignore these errors therefore forcing to export the data. In this case be careful not to end up with some faulty PCB.

use kicad-exports local

Installation

You need to have Docker installed.

git clone --recursive https://github.com/nerdyscout/kicad-exports /some/where/kicad-exports
cd /some/where/kicad-exports
make && make install

run

go to your KiCad project folder and run kicad-exports

cd /my/kicad/example-project
kicad-exports -d $DIR_OUT -e $SCHEMA -b $BOARD -c $CONFIG 

⚠️ running any command your git repository will be modified using kicad-git-filters.

run with predefined example config

kicad-exports -c docs.kiplot.yaml 

run with own config

place config file in directory of your kicad project and use relative path.

kicad-exports -c myconfig.kiplot.yaml -v -s all

running localy enables additional paramaters

  • -v, --verbose is useful while developing own config files
  • -s, --skip $arg skips preflight from given config file

Credits