Installation

Binary Releases

Our official LibrePCB binary releases contain the librepcb-cli executable next to the GUI application, so usually no separate installation is needed.

MacOS

You need to invoke the CLI with the full path to the binary:

/Applications/LibrePCB.app/Contents/MacOS/librepcb-cli --help

Linux AppImage

The LibrePCB AppImage also contains the CLI, but since it’s a single binary you can’t run librepcb-cli explicitly. Instead, you have to rename the AppImage to librepcb-cli to make it acting as the CLI (or create a symlink):

wget "https://download.librepcb.org/releases/1.2.0/librepcb-1.2.0-linux-x86_64.AppImage"
chmod +x ./librepcb-1.2.0-linux-x86_64.AppImage
mv ./librepcb-1.2.0-linux-x86_64.AppImage ./librepcb-cli
./librepcb-cli --help

Docker Image

The easiest way to get the LibrePCB CLI on Linux (especially for usage on CI) is to pull our official Docker image librepcb/librepcb-cli:

docker run -it --rm -v `pwd`:/work -u `id -u`:`id -g` \
    librepcb/librepcb-cli:1.2.0 --help