The free, open-source app for the Cooler Master MasterHUB modular deck.
Windows and macOS. No account, no cloud, no telemetry.
Download for Windows · Download for macOS · Website · Docs · FAQ
HubDeck is an independent project. It is not made, endorsed or supported by Cooler Master. "Cooler Master" and "MasterHUB" are trademarks of their owner and are used here only to say which hardware this software works with.
- Every module, live. 15 LCD keys, the round dial, knobs, faders, rollers and the edge light, found and drawn as they sit on your base, while it runs.
- A deck made for you in minutes. Say what you do most; HubDeck builds a deck for your modules and apps and walks you through it on the hardware. No AI needed.
- Profiles that follow the app in front, with per-app volume, mute, media with cover art, OBS, Home Assistant, monitor brightness and system stats.
- About 200 Stream Deck plugins run as they are (Spotify, Discord, OBS, Hue and more), one click from a catalog.
- Safe by design. Firmware is never written; dangerous commands are refused in code. Nothing leaves your computer unless you turn it on (PRIVACY.md).
- Light. About 1 % of one CPU core and 45 MB of memory in the tray.
Download from Releases.
Windows 10 and 11: run HubDeck_x.y.z_x64-setup.exe. Windows SmartScreen may say it does not
know the app (it is not signed with a paid certificate): choose More info > Run anyway.
macOS 12 or later (Apple silicon and Intel): open the .dmg and drag HubDeck to Applications.
The app is not notarised by Apple yet, so the first time macOS says it "could not verify" HubDeck.
Once only:
- Click Done (not Move to Trash).
- Open System Settings > Privacy & Security, scroll to Security and click Open Anyway next to the line about HubDeck; confirm with your password or Touch ID.
- Click Open in the next message.
On macOS 14 and older, right-click HubDeck in Applications and choose Open also works. To send shortcuts and type text from the deck, allow HubDeck in Privacy & Security > Accessibility; the app asks for it with a button. Setting one app's own volume (macOS 14.2 or later) asks once for System Audio Recording: HubDeck plays that app's sound at the level you set and records nothing.
Close the official MasterHUB app first: two apps cannot drive the deck at once.
- macOS: after HubDeck restarts, the keys or the dial sometimes stop taking pictures; HubDeck tries to restart that module by itself, and taking it off the base and putting it back always helps.
- macOS 12 to 14.1: one app's own volume cannot be set (the system and the player can).
- Elgato Marketplace plugins with copy protection do not run; plugins from their authors' own pages do.
- Twitch sign-in is off until the app registration is done. Linux is not supported.
- A module that drops off USB when you press it (Windows plays its unplug sound, the keys go blank for a moment) has a loose contact with the base: take it off and put it back firmly.
Everything in detail. Coming next: Twitch actions (built, waiting for the app's Twitch registration), a shared profiles gallery, more than one base.
Deck and modules
- Every module: 15 keys, dial with its 240x240 screen, knobs, faders, rollers and the base. Attach and remove modules while it runs; HubDeck finds where each one sits and how it is turned.
- The window draws your deck as it is on the desk, live: the very pictures the keys and the dial get (clocks, values, covers), LED colors and the edge light. Press, turn or slide anything to select it.
- Modules you own but have not attached stay on a shelf beside the deck, still editable.
Profiles that follow you
- Your home profile is the one you pick. An app with its own profile takes over while it is in
front (even one window:
chrome.exe: YouTubeon Windows,Google Chrome: YouTubeon macOS) and gives back when you leave it; the Auto-switch switch in the top bar stops switching. Switching is drawn in tens of milliseconds. - Key pages, press / hold / double press on every key, knob and the dial, multi-actions with delays and conditions, a keyboard macro recorder, toggles, several modes on one dial.
- Profiles in a OneDrive or Dropbox folder to share them between PCs; daily backups with
one-click restore; import of profiles exported by the official app (
.mhz, beta).
Actions
- Open apps, files and websites (with the app's own icon), run commands, hotkeys (F13-F24, media keys, and a mode that games can read), type text, scroll.
- System, per-app, "app in front" and microphone volume (per app on macOS 14.2 or later); microphone mute for every app; switch the speakers or microphone; play sounds (a small soundboard).
- Media control, now playing with cover art, seek in 12 players; monitor brightness (DDC/CI); system monitor (CPU, memory, GPU, temperatures, on macOS too); clock and timer; deck brightness.
Plugins made for Stream Deck
- Install a
.streamDeckPlugin, or pick one from a catalog of about 200 open-source plugins (Settings > Plugins), and its actions join the library: Discord, Spotify, OBS, Home Assistant, Philips Hue, Govee, VS Code and more. Keys are a 5x3 keypad, the dial and knobs are dials, the plugin's own settings page shows in the inspector. Many plugins are written in JavaScript and need Node.js 20 or later installed; HubDeck says so when one does. How it works and what to expect: docs/STREAMDECK-PLUGINS.md.
A tour, then a deck assistant
- Show me on my deck (no AI needed): one question about what you do most, then HubDeck makes a deck for your modules and your apps at once and walks you through it on the hardware, part by part; the control to try blinks on the deck. Keep the parts you like; nothing of yours changes until you keep the deck. With your OK it counts presses, and the next day names a control you never used, to swap it.
- The assistant uses your own Claude Code (it needs a Claude Pro or Max plan, or an Anthropic API key; the tour and everything else work without it): it looks at the apps you use (with your OK), asks a few questions and sketches whole decks you try on the hardware before you keep one; or go step by step, control by control, through a gallery of options. It changes only drafts; more in docs/ASSISTANT.md.
- Your own apps and scripts can show their state on the deck (an agent waiting, a build running) and offer actions: docs/APP-CONTRACT.md.
Integrations
- OBS Studio and Streamlabs Desktop: scenes, record, stream, replay, sources, mixer, with the live state on the keys.
- Spotify (like, playlists), Home Assistant (devices, scenes, lights, services), MIDI to any DAW.
- Claude Code: a key per coding session that shows whether it works, needs your permission or waits for you. Only the state and the project folder name are sent; never your prompts.
- Plugins in any language over a local WebSocket, and a local API for scripts; see docs/PLUGINS.md.
Lights
- One lighting style for the whole deck, or a color and effect per knob and fader and for the edge.
- Lights that mean something: a muted microphone, being on air, a session that needs you, a timer that ran out, levels as brightness.
Key looks
- Labels, colors, styles (flat, gradient, glass, outline), your own pictures and animated GIFs, one picture, a clock or a live graph across all 15 keys.
- Lucide icons and 300 game icons (game-icons.net) with search; install icon packs, including Stream Deck icon packs.
Ready-made profiles
- Everyday desk, OBS streaming, Discord and meetings, Photoshop, Illustrator, Lightroom, video editing, Claude Code, a game action bar, and games on their default keys: Diablo IV, Baldur's Gate 3, Counter-Strike 2, Valorant, Fortnite, Minecraft, League of Legends (how to set up a game). Each one adapts to the modules you have.
Sharing
- A profile and all its pictures as one
.hubdeckfile; secrets in web requests are left out.
Safe and light
- The module firmware is never updated or changed. Commands that could rewrite serial numbers, reset a module or flash firmware are not part of HubDeck's protocol code, and hand-built reports carrying them are refused.
- No account, no cloud, no telemetry. HubDeck goes online only for the update check (on by default, Settings > Updates), album covers of what plays, and what you turn on; the full list is in PRIVACY.md.
- About 1 % of one CPU core and 45 MB of memory while it waits in the tray (measured on the release build with the deck attached); the window exists only while it is open.
- If HubDeck ever stops unexpectedly, a small guard hands the deck back to its firmware and starts HubDeck again; the window then says when it happened and lets you copy the details for a bug report (nothing is sent).
- Tray app that starts with the system; dark and light look; Reduce motion (nothing blinks or flashes); English and Polish.
The tour: a deck made for your modules at once, walked through part by part; the control to try lights up on the deck.
Settings: one page with sections; Lights and screens, Connections, Plugins, Backups, Updates.
Can HubDeck damage or brick my modules?
No. HubDeck never writes firmware. Commands that could rewrite serial numbers, reset a module or
flash firmware are not part of its protocol code, and reports carrying them are refused
(crates/mh-protocol/src/safety.rs).
Do I need to uninstall the official app? Can I go back? No uninstall is needed; just quit the official app first, since two apps cannot drive the deck at once. To go back, quit HubDeck (tray > Quit) and start the official app; your modules are unchanged.
Does it work with a Stream Deck or other decks? No, it drives the MasterHUB only. It runs plugins made for Stream Deck on the MasterHUB.
Is the AI required? Does it cost anything? No. The tour, the editor and everything else work without it. The optional assistant runs on your own Claude Code, which needs a Claude Pro or Max plan or an Anthropic API key.
Why is the app unsigned? Is it safe? Code-signing certificates cost money every year; the installers are built from this repository by GitHub Actions, and each release lists the files' SHA-256. The source is all here, and PRIVACY.md lists everything that can go online.
Linux? Not yet. The protocol code is cross-platform; the app needs a Linux pass and a tester with a deck.
- Stream Deck plugins: what runs and how
- The deck assistant and your own apps on the deck
- Games, sharing profiles, the command line
- Plugins for developers, MCP tools
- The USB protocol, architecture, how it was built
- Comparison with the official app
The MasterHUB is good hardware: a base with an edge light, and modules you arrange as you like (15 LCD keys, a dial with a round screen, knobs, faders, rollers). Its official software has not kept up: pieces promised to backers (an SDK, macOS support, more integrations) have not arrived, updates are rare, and owners ask about bugs and whether it will stay supported (what we found). HubDeck is a new, open app for the same hardware, so the deck keeps working and keeps getting better. The protocol was worked out from public research and checked module by module on real hardware; see PROTOCOL.md.
You need Rust (1.90 or later), Node 22 or later with pnpm, and on Windows the Visual Studio C++
build tools (the "Desktop development with C++" workload); on macOS the Xcode command line tools
(xcode-select --install).
cd app
pnpm install
pnpm tauri dev # run with hot reload
pnpm tauri build # installers in target/release/bundle/
Tests: cargo test -p mh-protocol -p mh-device -p hubdeck and pnpm test in app/. Without the
hardware, pnpm dev and http://localhost:1420/?demo show the window with a sample deck.
How it is built:
crates/mh-protocol: the HID protocol of the modules (encode and decode, no I/O), as verified on hardware in PROTOCOL.md.crates/mh-device: USB HID transport and the hot-plug hub.app/: the Tauri 2 app, the engine in Rust (app/src-tauri/src/engine/) and the window in React.
More in ARCHITECTURE.md.
- Something does not work: report a problem (Settings > Help and about fills in your version and saves a diagnostics file to attach).
- An idea: suggest a feature.
- Questions, setups, profiles: Discussions.
- Anything you prefer not to post in public: przemotar+hubdeck@gmail.com
- Code: see CONTRIBUTING.md.
HubDeck is licensed under either of Apache License, Version 2.0 or MIT license at your option. Unless you explicitly state otherwise, any contribution you submit for inclusion in this project, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Third-party icons and fonts keep their own licences (Lucide ISC, game-icons.net CC BY 3.0, IBM Plex OFL): see NOTICE.md.
Made by Przemysław Tarkowski (przemotar+hubdeck@gmail.com), from scratch: the USB protocol of every module was worked out and checked on real hardware, then the app was written around it. It was built with Claude Code as the main tool; the story, the numbers and the decisions are in docs/CASE-STUDY.md.