stemdeckapp/stemdeck

[!IMPORTANT]
macOS first launch (no code signing yet). After dragging StemDeck to Applications, clear the Gatekeeper quarantine flag or macOS will say the app is damaged:

xattr -dr com.apple.quarantine /Applications/StemDeck.app

Upgrading from alpha.9 or earlier? If after installing you still see an old version or are missing recent features, clear the cached runtime once and relaunch:

rm -rf ~/Library/Application\ Support/StemDeck/runtime ~/Library/Application\ Support/StemDeck/runtime.old

What's new in 0.8.0 Alpha 2

Server/Docker mode fixes

• Network access is now on by default in server mode. Previously, Docker and headless deployments required manually setting STEMDECK_ALLOW_NETWORK=1 or the server would block all clients with "StemDeck is not available on the network". The app now detects server mode automatically (absence of STEMDECK_DESKTOP) and opens the network gate without any extra configuration.
• Docker port binding fixed. docker-compose.yml was binding to 127.0.0.1:8000, which prevented network clients from reaching the container at the host level. It now binds to 0.0.0.0:8000 so devices on your network can connect.
• Network and port settings are read-only in server mode. The Advanced settings tab now shows the network toggle and port field as disabled with a note explaining they are controlled by the server configuration (e.g. docker-compose.yml), not the UI.

YouTube Shorts support

• YouTube Shorts URLs (youtube.com/shorts/<id>) are now accepted and processed like regular YouTube videos.

Installing

• macOS: drop the .app into Applications and launch (run the xattr command above first).
• Windows: unzip the downloaded .zip, then run StemDeck.exe from the extracted folder.
• Linux: download the .tar.gz for your hardware, extract it, and run ./StemDeck. Install the WebKitGTK + GTK runtime prerequisites first (FFmpeg is fetched automatically on first launch):

  sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0
  

  The NVIDIA build additionally needs a working NVIDIA driver such that nvidia-smi reports your GPU (the CUDA runtime itself is bundled -- no separate CUDA toolkit install needed). If you have no NVIDIA GPU, use the CPU-only tarball.

Artifact scan

• The Linux portable packages (CPU and NVIDIA) were scanned with ClamAV in CI before upload.

Artifact build

• macOS arm64 and x64 DMGs and runtime packs were built and inspected on a macOS GitHub Actions runner before upload.

Artifact scan

• Windows portable packages were scanned with ClamAV in CI before upload.