Getting started¶
Install¶
Download the package for your system from the Releases page of the releases repository. SHA256SUMS.txt lists the checksums.
| System | Package | Install |
|---|---|---|
| Windows 10/11 (x64) | DeckHost-<version>-win-x64-setup.exe |
Run it. It installs for your user, without administrator rights, with a Start menu entry and an uninstaller. |
| Linux (x64) | DeckHost-<version>-linux-x64.tar.gz |
Unpack and run ./install.sh. It installs to ~/.local/share/deckhost with a menu entry, and (with sudo, once) the device rule that lets DeckHost use the N4 Pro and Stream Decks without root. ./install.sh --uninstall removes it. |
| macOS 12+ (Apple Silicon) | DeckHost-<version>-osx-arm64.zip |
Unzip and move DeckHost.app to Applications. |
First start of an unsigned build
Until DeckHost's packages are signed, Windows SmartScreen says "Windows protected your PC": choose More info → Run anyway. On macOS, right-click DeckHost.app → Open the first time, or run xattr -dr com.apple.quarantine /Applications/DeckHost.app.
The welcome tour¶
The first start opens a short tour:
- Your devices: what DeckHost found, and what to do if your device isn't there.
- A starting point: put everyday actions on the empty keys (media keys, volume, clock, system info, lock, switch profile; the volume on the first knob and track skipping on the touch strip), or start empty.
- Preferences: start with your sign-in, check for updates, and offer to report crashes.
- How it works: the editor in five lines.
Open it again from ☰ → Welcome tour.
Your first key¶
- Find an action in the list on the right (search, or open a plugin's group).
- Drag it onto a key. The device shows it right away.
- Click the key to set it up below the device: the action's settings, the text, icon and background, and the light.
- Double-click the key to try it.
Drag an action off a key to remove it, or right-click → Remove assignment.