Repository navigation
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.