Installing OpenPnP
PikkoBot uses OpenPnP as its control software. OpenPnP is free and open-source, available for Windows, macOS, and Linux.
Download OpenPnP
Use the version tested and recommended for PikkoBot: Latest Recommended Version (v2.6 — 2026-03-01).
| Platform | Download |
|---|---|
| Windows 64-bit | OpenPnP-windows-x64-main.exe |
| Windows 32-bit | OpenPnP-windows-x32-main.exe |
| macOS | OpenPnP-macos-test.dmg |
| Linux (Debian/Ubuntu) | OpenPnP-linux-main.deb |
| Linux (RPM) | OpenPnP-linux-main.rpm |
Download links are provided on the Downloads page, with MD5/SHA256 checksums for verification.
Installation
Windows
- Run the .exe installer
- Follow the setup wizard (default options are fine)
- OpenPnP installs to C:\Program Files\OpenPnP\
macOS
- Open the .dmg file
- Drag OpenPnP to Applications
- On first launch: right-click → Open (to bypass Gatekeeper)
Linux
# Debian/Ubuntu
sudo dpkg -i OpenPnP-linux-main.deb
# Or via tar.gz
tar -xzf OpenPnP-unix-main.tar.gz
cd OpenPnP
./run.sh
Loading the PikkoBot Configuration
PikkoBot ships with pre-tuned OpenPnP configuration files. Do not use the OpenPnP defaults — load the PikkoBot config instead.
Go to Loading Configuration Files to continue.