About DeckSurf

DeckSurf gives you full control of your Stream Deck: a Windows app, a CLI, and an SDK that talk to the hardware directly, so the official software is optional. It's written and maintained by Den.

The CLI

Install it as a .NET global tool with dotnet tool install -g DeckSurf. That gives you a deck command, and you define profiles that map commands to keys.

The Windows app

DeckSurf for Windows is a native WinUI 3 app that does the same job visually: a profile editor, a device and plugin browser, and a tray runtime that keeps your active profile running in the background. It ships as a self-contained MSI installer from the releases page and doesn't need a separate .NET install.

The SDK

If you'd rather build your own tooling, the SDK is a C# library that covers the parts you don't want to write yourself: finding connected devices, listening for key presses, drawing images on keys, and setting brightness.

Plugins extend the CLI with new commands. The bundled Barn plugin launches applications and shows live CPU usage on a key. It also has a playable snake game, which is not useful, but it settles the question of who's in charge of the hardware.

Support

DeckSurf works with the Stream Deck XL, Plus, Original, MK.2, Mini, and Neo on Windows, macOS, and Linux. It's free and open source.

Getting started

Install the CLI and read the docs, or grab the Windows app if you'd rather skip the terminal. The source is on GitHub and the SDK is on NuGet.