Repository navigation
Releases
v3.2.3 - Macro & Key Combo Upgrades
userdeck v3.2.3 - Macro & Key Combo Upgrades
New: edit your macros
Every macro now has an Edit button. Open it to fine-tune a recording without re-recording it:
- Editable timing - change the delay before any click, key or scroll, down to the millisecond.
- Grouped mouse movement - recorded cursor movement folds into a single "Mouse movement" block so it doesn't clutter the list, and its motion is preserved untouched.
- Readable steps - each step shows its icon and label (Left Click, F press, Scroll up...), with a live step count and total time up top.
Tune it, hit Save, and the macro updates in place.
Keyboard capture is fixed in two places, and macros are now editable.
Macros now record your keyboard
Macro recording only ever captured the mouse - keystrokes never made it in. That's fixed: keyboard presses and modifiers (Ctrl / Shift / Alt) are captured reliably now and replay exactly as you performed them. Mouse moves, clicks, scroll and keyboard all record together.
Key combos capture full chords
Setting a Key combo binding used to drop the main key on bigger chords - hold three modifiers and press P, and the P would vanish, leaving just the modifiers. Now the captured key sticks: hold Ctrl + Alt + Shift, tap P, and Ctrl + Alt + Shift + P binds. You don't even have to hold them all at once - the modifiers latch, so you can let one go before tapping the key.
Upgrade
Install userdeck v3.2.3 over your existing copy. It's all host-side - no firmware flash needed. Your keymaps, soundboards, launchers, macros, numpad profiles, screen settings and device choices carry over untouched.
v3.2.2 - Soundboard Volume Fixes
userdeck v3.2.2 - Soundboard Volume Fixes
Two fixes for the soundboard sliders, plus a tidy cap on pad labels. Nothing you've set is lost - your saved volumes still read the same percentage, they just sound the way the slider says now.
Volume sliders actually work across their whole range
The sliders used to apply volume in a straight line, which is not how loudness works to the ear - 50% was only a hair quieter than 100%, and you couldn't hear any real change until you dragged below halfway. Now every soundboard slider (each pad's volume, the Preview, and the Master volume) uses a proper audio taper, so the full length of the slider maps to an even spread of loudness. 100% is unchanged; the middle of the travel is now genuinely quieter and useful.
Live volume percentage on every slider
Every volume slider now shows its level as a percentage right next to it, updating as you drag - on the Numpad pads, in the deck sound editor, and on Master volume in Settings. No more guessing what level you're at.
Label length cap
Soundboard pad labels are now capped at 25 characters so they stay readable on the pad and in the editor.
Upgrade
Install userdeck v3.2.2 over your existing copy. It's all host-side - no firmware flash needed. Your keymaps, soundboards, launchers, macros, numpad profiles, screen settings and device choices carry over untouched.
Notes
- The Master volume slider got the same audio taper as the pads, so a mid setting now sounds a little quieter than before at the same percentage - 100% is identical. Nudge it back up if you'd had it parked low to compensate.
v3.2.1 - Interface Polish
userdeck v3.2.1 - Interface Polish
A tidy-up pass over the screens you touch most. Nothing you set changes - the KBKeymap, Macros and Settings pages just read cleaner, line up properly, and use one consistent set of icons.
KBKeymap
- The pad rows finally lay out right. Each Numpad key is one clean row: the key, a Type picker, then its fields. Picking Macro no longer squashes the macro list into a sliver while the repeat box balloons - the macro picker grows to fill the row and the repeat sits at a fixed width beside it. The Sound row reads the same way: label, file, volume, then Browse / Preview / Clear.
- Numpad 0 and . are page keys. They're shown as their own reserved rows - Numpad 0 steps to the previous profile, Numpad . (decimal) to the next - so the bindable sound/macro slots (Numpad 1-9) are never mixed up with the paging keys.
Macros
- One consistent icon set. Play, Stop and Record now use crisp vector icons that match the Delete icon, instead of the old text symbols. Everything in the row reads as one family.
- The name leads. The macro name is the editable field, so it now gets the room - it grows to fill the row while the event/duration readout sits quietly next to the Play / Export / Delete buttons. Before, the name was cramped and the read-only stats hogged the space.
Settings
- Every section looks the same now. The whole page is one consistent stack of titled sections - Connection, Device behavior, Configuration, and on down through Training overlay, Macros, KBKeymap, Soundboard and Firmware. The top of the page used to float a few unlabeled boxes; now each group has a heading, a one-line description, and a divider, top to bottom.
Upgrade
Install userdeck v3.2.1 over your existing copy. It's all host-side - no firmware flash needed. Your keymaps, soundboards, launchers, macros, numpad profiles, screen settings and device choices carry over untouched.
Notes
- This is a UI-only release - behavior is unchanged apart from Numpad 0 / . now paging your KBKeymap profiles.
- Numpad keys are global hotkeys, so they fire whatever app is focused (with Num Lock on). A macro key runs its macro on press and stops it on the next press; a looping macro keeps going until you press the key again.
v3.2.0 - KBKeymap
userdeck v3.2.0 - KBKeymap
Your number pad is now a second deck. This release adds a KBKeymap tab that binds Numpad keys (captured system-wide while Num Lock is on) to either a soundboard sound or a macro - so you don't even need the userdeck plugged in to fire your sounds and macros from the keyboard.
KBKeymap
- One home for everything keyboard. A new KBKeymap tab gathers all numpad binding in one place. The old "KBSoundboard" mode is gone from the Keymap tab - it lives here now, and it does more.
- Sound or macro, per key. Each of the 9 number keys (Numpad 1-9) is Sound, Macro, or Empty. Pick the type, then choose the sound file (with label + volume) or the macro (with repeat: once, 2-5 times, or loop forever).
- One binding per key. Sounds and macros are mutually exclusive on a key - binding one clears the other, so you always see exactly what each key does and which keys are free.
- Page through your profiles from the numpad. Numpad 0 steps to the previous profile and Numpad . (decimal) to the next, so you can flip between layouts without touching the app. Keep as many profiles as you like and switch between them in the tab too.
- Toggle the tab. Don't use the numpad? Hide the KBKeymap tab from Settings > KBKeymap.
Upgrade
Install userdeck v3.2.0 over your existing copy. It's all host-side - no firmware flash needed. Your keymaps, soundboards, launchers, macros, numpad profiles, screen settings and device choices carry over untouched.
Notes
- Numpad keys are global hotkeys, so they fire whatever app is focused (with Num Lock on). A macro key runs its macro on press and stops it on the next press; a looping macro keeps going until you press the key again.
- A KBKeymap key bound to a macro that you later delete just does nothing - rebind it from the tab.
- The macro recorder's global input hook is only active while the app runs, and only saves input while you are recording. Everything stays on your machine - no telemetry.
v3.1.1 - Macro fixes
userdeck v3.1.1 - Macro fixes
A small patch that fixes two rough edges in the new macro recorder from v3.1.0. Host-side only - no firmware flash needed.
Fixes
- Mouse drags replay properly. Recordings now capture mouse movement, so dragging and cursor paths play back exactly as you did them. Before, playback jumped straight from click to click instead of moving the cursor along the way.
- The record hotkey stays out of the way.
Ctrl + Shift + Rnow only works while the Record screen is open. Open the recorder, then the hotkey (or clicking the box) starts and stops the take; close it and the hotkey does nothing, so it can't fire anywhere else. - A cleaner record screen. The recorder now matches the rest of the app's capture UI - the same box style as the Keymap "key combo" capture, with a live timer and event count while you record.
Changes
- Keymap is now the first tab. It sits at the far left and the app opens on it.
Upgrade
Install userdeck v3.1.1 over your existing copy. Your keymaps, soundboards, launchers, macros, screen settings and device choices carry over untouched.
Notes
- If a macro you recorded before updating still teleports on playback, re-record it - the fix applies to new recordings.
- The recorder's global input hook is only active while the app runs, and only saves input while you are actively recording. Everything stays on your machine - no telemetry.
- Mouse positions are screen coordinates, so play a macro back on the same resolution / monitor layout you recorded it on.
v3.1.0
userdeck v3.1.0 - Macros
Record it once, fire it from a key. This release adds a full macro recorder: capture any sequence of mouse moves, clicks and keystrokes, save it, and bind it to a deck key. It also makes the new screen feel instant and squashes the connection drop-outs some of you hit after v3.0.0.
Macros
- Record anything. A new Macros tab records your mouse + keyboard into a saved sequence. Press Ctrl + Shift + R anywhere to start, and again to stop - the recorder window shows a live timer and event count while you go.
- Bind it to a key. In the Keymap tab, the new Macro action type lets a deck key run a saved macro. Pick how many times it repeats: once, 2-5 times, or loop forever.
- Run / stop from the deck. Press the key to run the macro; press it again to stop (a "loop forever" macro runs until you do). Recording and running are completely separate - the hotkey only records.
- Save, export, import, rename, delete. Manage everything from the Macros tab, and share macros as
.jsonfiles. - Rebindable hotkey. Change the record shortcut in Settings > Macros.
Faster, steadier screen
- Instant feel. The v3 screens were doing too much work per update, which made presses lag and sometimes dropped clicks. Repaints are roughly twice as light now, so the deck keeps up.
- No more connect / disconnect loop. A tiny serial buffer combined with the heavy repaints could stall the USB link and throw the deck into a connecting / disconnecting loop (or "access denied"). The buffer is now large enough to absorb a full keymap, and repaints keep the USB link serviced - the loop is gone.
- Reconnects itself after a flash. After flashing, the app now re-finds the freshly rebooted deck on its own instead of leaving you to press "Reconnect".
Smaller touches
- Export log. An Export log button on the Activity tab saves the live frame log to a text file.
Upgrade
- Install userdeck v3.1.0 over your existing copy.
- Open Settings > Firmware and click Flash to push the bundled v3.1.0 firmware - this is the fix for the connection drop-outs, so flash it even if everything else looks fine.
- Macros are host-side: open the Macros tab and start recording.
Your keymaps, soundboards, launchers, macros, screen settings, and device choices carry over untouched.
System requirements
- Windows 10 / 11 (x64)
- A USB port for the userdeck
- Optional: a GC9A01 1.28" round display for the screen features
- Optional: a virtual audio cable for Soundboard mic routing (free VB-CABLE, one-click install)
- ~30 MB disk
Compatibility
- Talks to any userdeck-firmware Pico over CDC + composite HID.
- The connection-stability fix is in the v3.1.0 firmware; flash from Settings to get it.
- Macros run on the PC - the deck key just triggers them - so they don't need a display and work on any userdeck.
Notes
- The macro recorder installs a global input hook while the app runs (the nature of any macro recorder). It only saves input while you're actively recording, and everything stays on your machine - no telemetry.
- Mouse positions are recorded as screen coordinates, so play a macro back on the same resolution / monitor layout you recorded it on.
- For a clean recording, stop with Ctrl + Shift + R rather than the on-screen button (clicking the button records that click).
- Building a deck from scratch? See the README for the hardware BOM, wiring, and assembly notes.
v3.0.0 - The Display, Reimagined
userdeck v3.0.0 - The Display, Reimagined
The round screen has been rebuilt from the ground up. Where it used to be flat black with blocky text, every screen is now composited in a true framebuffer with full anti-aliasing, deep gradients, soft glows, a real typeface, and smooth transitions. It is a different device to look at.
A whole new rendering engine
- Anti-aliased everything. Rings, gauges, dots, numerals and text are all edge-smoothed now, so curves are clean instead of stair-stepped.
- Depth, not flat black. Each screen sits on a deep radial gradient with a subtle vignette and a soft accent glow behind the content, for a sense of depth a flat panel never had.
- Flicker-free. Screens are drawn off-display and pushed in one shot, so updates are clean with no tearing.
Real typography
- A proper font. Labels, page names and track titles now render in a crisp, anti-aliased geometric typeface (true mixed case, not all-caps blocks).
- Hero numerals. The clock, CPU load, volume and timer use large rounded-segment numbers with soft, rounded ends - the centerpiece of every data screen.
Redesigned screens
- Watchface home. Mode pill with a status dot, the page or soundboard name as the hero, a segment clock, and refined page dots that glow on the active one.
- PC stats + Volume. Circular load gauges that fill and colour-code (green to amber to red), with the value at the heart of the ring.
- Now playing. A play / pause glyph and state, the track title, and the artist beneath, with a gentle accent glow while playing.
- Confirm prompts. Proper rounded Cancel / Confirm pills in their accent colours.
- A glowing connection ring. The perimeter bezel lifts to a soft green glow when the configurator is connected.
Smooth motion
- Fade transitions. Flipping pages now fades the new watchface up out of black instead of snapping.
Upgrade
The new look lives in the firmware, so this release needs a flash.
- Install userdeck v3.0.0 over your existing copy.
- Open Settings > Firmware and click Flash to push the bundled v3.0.0 firmware to your deck.
- That is it - your keymaps, soundboards, launchers, screen settings, and device choices carry over untouched.
System requirements
- Windows 10 / 11 (x64)
- A USB port for the userdeck
- A GC9A01 1.28" round display for the screen features (the deck works without one; this update is all about the screen)
- Optional: a virtual audio cable for the mic routing (the free VB-CABLE, installable in one click from inside the app)
- ~30 MB disk
Compatibility
- Talks to any userdeck-firmware Pico over CDC + composite HID.
- The new screen system needs the bundled v3.0.0 firmware; flash from Settings to upgrade. No display? Everything else works exactly as before.
- PC stats, Volume and Now Playing read live state from Windows and are pushed to the deck by the Configurator, so keep it running (it lives in the tray).
Notes
- The redesign is firmware-only; the companion app's controls are unchanged.
- Still fully offline apart from the optional one-time VB-CABLE download. No telemetry, no network calls otherwise.
- Building a deck from scratch? See the README for the hardware BOM, wiring, and assembly notes.
v2.1.0 - The Training Overlay
userdeck Configurator v2.1.0 - The Training Overlay
Learn your layout without looking down. This release adds a training overlay: a see-through, draggable copy of your 3×6 grid that floats on top of everything else, mirrors your deck, and lights up the button you press. Turn it on while you get used to a new setup, then turn it off once it is muscle memory.
The overlay
- Your whole grid, at a glance. A translucent 3×6 grid showing every button's name - Streamdeck keys, sound pads, and the reserved Cancel / Confirm / Prev / Next corners.
- It lights up when you press. The matching button glows on the overlay the instant you press it on the deck, so you can see exactly what is where.
- It follows your deck. The overlay tracks the page and mode you are actually on, so flipping pages or switching to Soundboard updates it live.
- Drag it anywhere. Click and drag anywhere on the overlay to move it; it remembers where you left it and whether it was open.
- Adjustable transparency. A slider sets how see-through it is, so it never gets in the way of what is underneath.
Where to find it
Open the Settings tab and look for Training overlay - tick Show training overlay to bring it up, and use the Transparency slider to taste.
Upgrade
- Install userdeck Configurator v2.1.0 over your existing copy.
- Open Settings > Firmware and click Flash to push the bundled v2.1.0 firmware. This adds live page reporting so the overlay follows page changes on the deck. The overlay still works without it (it follows the mode and your selected page); flashing just makes page-flips on the deck update it instantly.
- Open Settings > Training overlay and switch it on.
Your keymaps, soundboards, launchers, screen settings, and device choices carry over untouched.
System requirements
- Windows 10 / 11 (x64)
- A USB port for the userdeck
- Optional: a GC9A01 1.28" round display for the screen features
- Optional: a virtual audio cable for the mic routing (the free VB-CABLE, installable in one click from inside the app)
- ~30 MB disk
Compatibility
- Talks to any userdeck-firmware Pico over CDC + composite HID.
- The overlay works on your current firmware; the bundled v2.1.0 firmware adds live page-following on the deck.
- The overlay reads your layout from the app and mirrors the deck, so keep the Configurator running (it lives in the tray).
Notes
- The overlay is always-on-top and see-through; drag it out of the way any time, or hide it from Settings when you no longer need it.
- Right-click the tray icon for quick settings, Open, and Quit; left-click opens the main window.
- Still fully offline apart from the optional one-time VB-CABLE download. No telemetry, no network calls otherwise.
- Building a deck from scratch? See the README for the hardware BOM and assembly notes.
v2.0.2 - Tray + Update Screen Fixes
userdeck Configurator v2.0.2 - Tray + Update Screen Fixes
A small follow-up to v2.0.1. It brings back the Quit button in the tray menu and makes the "update available" window show its release notes properly. Both are host-side, so there is no firmware to reflash.
Fixed: tray Quit button
- You can quit from the tray again. The quick-settings popup (right-click the tray icon) was taller than its window, so the Open userdeck and Quit buttons at the bottom were cut off. The popup now measures its own contents and sizes itself to fit - on any display scale, DPI, or font - so those buttons are always visible.
Nicer update screen
- Release notes that actually read like release notes. The "update available" window used to show the raw text of this changelog - HTML tags, hashes and all. It now renders properly, with headings, bullet points and the userdeck logo, so you can see what is new at a glance.
Upgrade
This release is entirely host-side - no firmware reflash needed.
- Install userdeck Configurator v2.0.2 over your existing copy.
- That is it - your soundboards, keymaps, launchers, screen settings, and device choices carry over untouched.
System requirements
- Windows 10 / 11 (x64)
- A USB port for the userdeck
- Optional: a GC9A01 1.28" round display for the screen features
- Optional: a virtual audio cable for the mic routing (the free VB-CABLE, installable in one click from inside the app)
- ~30 MB disk
Compatibility
- Talks to any userdeck-firmware Pico over CDC + composite HID.
- No firmware change in this release; your current firmware keeps working as-is.
Notes
- Right-click the tray icon for quick settings (soundboard, mic, push-to-talk) plus Open and Quit; left-click opens the main window.
- Sounds are played by the Configurator, so keep it running (it lives in the tray) for the soundboard - deck or keyboard - to work.
- Still fully offline apart from the optional one-time VB-CABLE download. No telemetry, no network calls otherwise.
- Building a deck from scratch? See the README for the hardware BOM and assembly notes.
v2.0.1 - Soundboard + Detection Fixes
userdeck Configurator v2.0.1 - Soundboard + Detection Fixes
A focused hotfix on top of v2.0.0. It makes the microphone path behave the way it should - picked up on its own at startup, with no delay between what you say and what comes out - adds a second push-to-talk button, and fixes a stubborn case where the app would sit on "searching" and never see your deck. Everything here is host-side, so there is no firmware to reflash.
Mic is picked up automatically at startup
- No more disable / re-enable. Before, the soundboard would come up at login with the mic not actually captured, so you had to toggle it off and on for your voice to pass. The engine now brings itself up cleanly on startup, so your mic is live from the moment the app loads.
Instant mic passthrough
- No more delay. Your voice used to lag behind by up to a second before reaching the virtual cable. The passthrough buffer is now held tight, so what you say reaches Discord / OBS effectively in real time.
A second push-to-talk button
- Bind two keys. You can now set a secondary push-to-talk button alongside the first - holding either one opens the mic. Set or clear each independently in Settings. Great for keeping a keyboard key and a mouse side-button both armed.
Fixed: app stuck on "searching"
- Your deck is always found now. A serial port could get left in a locked state after a crash, a force-quit, or the app restarting its own connection, which made the configurator loop on "searching" and never detect a plugged-in userdeck.
- Clean release every time. The app now lowers the port's control lines and releases it properly whenever a connection ends or you quit, and it waits for the old connection to fully let go before reopening - so it can no longer block itself out of its own device.
- Slow firmware can't wedge it. Writes to the deck now time out instead of hanging, so a busy device can never freeze the connection.
Upgrade
This release is entirely host-side - no firmware reflash needed.
- Install userdeck Configurator v2.0.1 over your existing copy.
- That is it - your soundboards, keymaps, launchers, screen settings, and device choices carry over untouched.
One-time note: if your deck was already stuck on "searching" before updating, unplug and replug it once (or reboot) to clear the locked port. This fix prevents it from happening again; it can't unstick a port that was already wedged.
System requirements
- Windows 10 / 11 (x64)
- A USB port for the userdeck
- Optional: a GC9A01 1.28" round display for the screen features
- Optional: a virtual audio cable for the mic routing (the free VB-CABLE, installable in one click from inside the app)
- ~30 MB disk
Compatibility
- Talks to any userdeck-firmware Pico over CDC + composite HID.
- No firmware change in this release; your current firmware keeps working as-is.
- The microphone and push-to-talk features are Windows features (they read live button and audio state from the OS).
Notes
- Push-to-talk gates the microphone only; soundboard effects always play. Either bound button opens the mic.
- Sounds are played by the Configurator, so keep it running (it lives in the tray) for the soundboard - deck or keyboard - to work.
- Quitting from the tray releases the deck cleanly. A hard End Task kill can still leave a port locked until you replug; quit normally to avoid it.
- Still fully offline apart from the optional one-time VB-CABLE download. No telemetry, no network calls otherwise.
- Building a deck from scratch? See the README for the hardware BOM and assembly notes.