The free, open-source app for the Cooler Master MasterHUB modular deck,
an alternative to the official MasterHUB software.
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.
- Download for Windows or for macOS and install it (step by step).
- Quit the official MasterHUB app: two apps cannot drive the deck at once.
- Open HubDeck from the tray and click Show me on my deck: one question, and in about five minutes your deck is set up for your modules and apps. No account and no AI needed.
| Module | Windows 10/11 | macOS 12+ |
|---|---|---|
| Base with the edge light | ✓ | ✓ |
| 15 LCD keys | ✓ | ✓ |
| Dial with its round screen | ✓ | ✓ |
| 3 knobs | ✓ | ✓ |
| 5 faders | ✓ | ✓ |
| 2 rollers | ✓ | ✓ |
Checked module by module on real hardware. Attach and take off modules while HubDeck runs; it finds where each one sits and how it is turned. One base at a time for now.
- 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.
- Stream Deck plugins run in HubDeck: a one-click catalog of about 200 open-source ones plus
the 300 most downloaded on Elgato Marketplace (Settings > Plugins; 36 of Elgato's top 100 publish
an open file and install here), the plugins your Stream Deck app already has, and any
.streamDeckPluginyou open with HubDeck or drop on its window. Of 33 popular ones checked, 26 start and draw on Windows (marked "tried in HubDeck"; the list); tell us when one does not work. - 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 3 % of one CPU core and 40 MB of memory in the tray with a clock and meters on the keys; 9 % and 62 MB with 22 animations on the deck (Windows, measured before the release).
Before and while building HubDeck we read what owners of the MasterHUB and of other decks (Stream Deck, Loupedeck, Logitech MX Creative Console, Razer Stream Controller) say goes wrong: reviews, vendor forums, GitHub issues and about 1,200 Reddit posts of 2025-2026. The ones that shaped HubDeck most, with their sources:
| What owners say | What HubDeck does |
|---|---|
| "Nearly every update ... breaks almost everything"; people roll back by hand (r/elgato, r/elgato) | Nothing installs until you click Install, with the changes shown first; Go back to the version before in Settings, signed like any update, your profiles backed up first |
| A press does nothing, or arrives seconds later, and you cannot tell which (r/elgato) | Every press frames the key at once; an action that failed leaves a red corner and the window says why |
| Official integrations broken for weeks: OBS, weather, Spotify (r/elgato, r/elgato) | OBS, Streamlabs, now playing, weather and Home Assistant are built in; Stream Deck plugins run beside them, restarted when they crash, stoppable by hand |
| Forced accounts, a store, an ad in paid software (r/elgato, r/elgato) | No account, no store, no ads, no telemetry. Open source |
| The vendor walks away and the hardware becomes a brick (r/Loupedeck, the MasterHUB itself) | MIT or Apache-2.0, the protocol documented in PROTOCOL.md: anyone can keep it going |
| "What do I use it for if I don't stream?" (the most discussed non-hardware thread, r/elgato) | A tour builds a deck for your modules and apps in minutes; ideas from other deck owners, taken from that thread, are one click away |
| Companion apps that take 2-4 GB of memory (Logitech reviews) | Measured before every release: 9.4 % of one CPU core and 62 MB with 22 animations on the deck, memory flat over 5 minutes (Windows) |
| "Commands did not save properly", a setup lost (APH Networks) | Every change saved at once and written safely; daily backups with Restore |
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: this version's window was last tried on a Mac before its rebuild (2026-10-15); the macOS build comes from CI and has not yet run on a Mac. Please report what you see.
- The window shows the deck's animations (GIFs, the screensaver) at about 8 frames a second; the deck itself plays them at 15 or more.
- 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, also when the Stream Deck app has them (Elgato keeps their files encrypted on disk); the catalog says which ones come only through Elgato's app. Plugins from their authors' own pages run.
- 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 (modules, profiles, actions, plugins, the tour and the assistant, integrations, lights, looks, ready-made profiles, safety)
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).
- Multimedia (play, pause, tracks), 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(open it with HubDeck, drop it on the window, or pick it), use the plugins Elgato's Stream Deck app already installed, or pick one from a catalog of about 200 open-source plugins and the 300 most downloaded on Elgato Marketplace (Settings > Plugins: Discord, Spotify, OBS, Home Assistant, Philips Hue, Govee, VS Code and more), and its actions join "What should it do?". 26 of 33 popular ones checked run on Windows (the list). Keys are a 5x3 keypad, the dial and knobs are dials, the plugin's own settings page shows in the panel on the right. 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 3 % of one CPU core and 40 MB of memory while it waits in the tray (measured on the release build with the deck attached, a clock and meters on the keys); 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 Report this crash opens a bug report with the details filled in (nothing is sent until you send it).
- 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.
Plugins: about 200 open-source Stream Deck plugins and Elgato Marketplace's most downloaded one click away, and the ones your Stream Deck app has; each shows its CPU and memory, and you can stop and start it by hand.
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: Feedback > Report a problem in HubDeck's top bar opens the form with your version, system, modules and the last errors filled in (addresses, keys and paths left out); you see it all before sending. After a crash, the window offers Report this crash the same way.
- 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.
0 comments
log in to comment.