Installation
Install the dartpilot desktop app.
Install the desktop app on the computer that will stay with the board. Pick the build for your platform from the download page:
| Platform | Installer |
|---|---|
| macOS (Apple Silicon or Intel) | .dmg: open it and drag dartpilot to Applications |
| Windows (x64 & arm64) | -setup.exe: run the installer |
| Linux (x64 & arm64) / Raspberry Pi | .AppImage (self-updating) |
On macOS, the app needs macOS 12 (Monterey) or later on Intel and macOS 13.4 (Ventura) or later on Apple Silicon.
Then:
- Download and install the app.
- Open it.
- Plug in your cameras and check they show up as available devices.
When the app can see your cameras, you’re ready to set up the board.
Updates
The desktop app updates itself. On launch it checks the release feed; when a new version is available, use Install update in the app. You should not need to reinstall.
Headless venue machines
A board does not need a screen or a desktop session. On Linux or macOS (a Raspberry Pi, a small mini-PC, or a Mac), install the headless board daemon:
curl -fsSL https://get.dartpilot.app/headless.sh | sh
This installs the board to ~/.local/share/dartpilot and a service that starts on
boot and restarts on failure: a systemd user unit (dartpilot) on Linux, a
LaunchAgent (com.dartpilot.board) on macOS. The board prints a sign-in code on
first start. Enter the code at
play.dartpilot.app/device to approve it and
connect the board to your account. It is then controlled over HTTP on port 3000, and the web app
reaches it over your network. On macOS, allow camera access when macOS asks.
Update it in place:
dartpilot --update
Uninstall with curl -fsSL https://get.dartpilot.app/install.sh | bash -s -- --uninstall.
See Headless boards for the service commands, logs, and
troubleshooting. If the cameras are not detected on Linux, add your user to the
video group and reboot; on macOS, check camera access in System Settings.