The fast path: Copy Diagnostics
Open the settings of the Status key - or, on dial decks, the Page & Settings dial - in the Stream Deck app (the plugin's settings home - add one from the DeckBridge action list if neither is placed) and press Copy Diagnostics. Paste the result into an email to
support@deckbridge.ioThe paste contains plugin and Resolve versions, channel health, your active keymap, the last MIDI error if any, and the last 50 log lines - no media, no project contents, no personal data. Nothing is ever sent automatically: nothing leaves your machine unless you paste it.
Or send it from here
No mail client handy? Same inbox, straight from this page.
Thanks - your message is in. If you left an email address, we'll reply there.
Frequently asked
Does DeckBridge work with Resolve Free?
Yes. Resolve Free doesn't expose the external scripting API, so DeckBridge installs a small bridge script into Resolve's own Scripts menu - started automatically on macOS and Windows. Transport, commands, pages and timecode all work; see the setup guide §6.
My keyboard layout isn't QWERTY - will keys press the right commands?
DeckBridge reads your active Resolve keymap, whatever it is - built-in presets, custom presets, any layout. Keys fire the binding Resolve itself has for that command, and follow along live when you rebind.
What exactly does Enable MIDI change on my system?
On macOS it adds two persistent IAC buses (DeckBridge Out /
DeckBridge In) to the system MIDI configuration - after storing a
timestamped backup of your pristine config in DeckBridge's data folder, kept until
you uninstall and restorable from there at any time. If you delete that folder
yourself the backup goes with it: uninstall still removes DeckBridge's own buses
cleanly and leaves your devices untouched, but can no longer tell whether the IAC
Driver was enabled beforehand, so it leaves it on. On Windows it uses Windows MIDI Services loopback and
changes nothing system-wide. Faders and transport lights need it; everything else
works without.
Should I close Resolve's Preferences before pressing Enable MIDI?
Yes - close the Preferences window first. Enabling MIDI restarts the macOS MIDI service so your new buses appear, and Resolve doesn't always cope with that while its Preferences window is open; it can quit unexpectedly, and any Control Panels settings you hadn't saved are lost.
The setup guide's order avoids this: press Enable MIDI first, then open Preferences to point Resolve at the DeckBridge buses. It's only worth remembering if you come back and press Enable MIDI again later. Resolve is unaffected the rest of the time - enabling MIDI is a one-time step.
I enabled MIDI but Audio MIDI Setup doesn't show the DeckBridge buses
Quit and reopen Audio MIDI Setup, then look again under Window → Show MIDI Studio → IAC Driver. Its MIDI Studio window doesn't refresh when the configuration changes underneath it, so buses added while it's open stay invisible until you reopen it - they're already there and already working.
The reliable check is the deck itself: the Status key goes green once Resolve is wired to the buses.
A key shows greyed - why?
Greyed means "this can't act right now, and pressing won't pretend otherwise": Resolve is closed, no timeline is open, or that command has no binding in your keymap yet - assign one in Resolve's Keyboard Customization and the key lights up by itself within seconds.
The Play/Pause key shows the wrong state - how do I fix it?
Press Stop - it always resyncs. This only happens when MIDI isn't connected: with MIDI, Resolve reports its real transport state and the key follows it exactly.
Without MIDI the deck has no way to hear Resolve, so it assumes your press did what you asked. If playback was already started or stopped from the keyboard, or Resolve ignored the key, that assumption drifts out of step. Enabling MIDI fixes it properly. Fast-forward and rewind never show a false state, because multi-speed shuttle is never guessed at.
I restarted the Stream Deck app and my DeckBridge keys went blank for a few seconds - is something wrong?
No, and it fixes itself. Restarting the Stream Deck app also restarts DeckBridge, and on macOS the system MIDI service shuts down with it and takes a moment to come back. If DeckBridge starts during that gap it stops, and the Stream Deck app starts it again about ten seconds later with everything restored - your MIDI setup, buses and settings are untouched.
It's most likely on a Mac with little or no other MIDI equipment configured. If the keys stay blank for much longer than that, send us Copy Diagnostics.
Which devices are supported?
Stream Deck +, MK.2, XL, Mini, Neo, Studio, + XL and Galleon 100 SD - each with curated starting profiles, one per Resolve page. Dial and touch-strip features (timecode, page and mixer dials) need a deck with dials: Stream Deck +, + XL, Studio or Galleon 100 SD.
Why does Stream Deck keep asking to install a profile?
If you connect a deck after installing DeckBridge, the Stream Deck app asks your permission before adding each of DeckBridge's page profiles - one prompt per page, the first time you visit it. That's the app's own confirmation, not an error: only you can approve a profile being added to your deck.
Accept them and the prompts stop for good on that deck. A deck that was already attached when you installed DeckBridge gets its profiles up front and never asks.
Resolve keeps jumping to the front on its own - why?
Update DeckBridge - this was a bug in builds before 0.2.24. On Resolve Free, DeckBridge periodically starts its bridge script for you, and if macOS's Automation permission was declined, older builds kept bringing Resolve forward every few seconds while the useful half of the automation was refused. Current builds check the permission first and never touch focus while it's denied.
To get automatic bridge start-up working, allow it under System Settings → Privacy & Security → Automation → Elgato Stream Deck → System Events - DeckBridge picks the grant up within seconds, no restart needed.
I can't find the Remove DeckBridge data button - where is it?
It lives in the settings panel of two actions: Status (a key) and, on decks with dials, Page & Settings. If neither is on your deck, drag either one from the DeckBridge action list onto any empty slot, open its settings, run the cleanup, then remove the tile again - it doesn't have to stay.
Do this while the plugin is still installed. Removing the plugin first leaves the button unreachable, because the Stream Deck app gives a plugin no chance to clean up on its way out. If you've already removed it, the manual's uninstall section lists the steps, including deleting the two DeckBridge buses in Audio MIDI Setup.
How do I reset a profile to its defaults, or recover a deleted one?
Delete the profile in the Stream Deck app's preferences first if it still exists (an installed profile is never overwritten, customizations included), then press Reinstall default profiles in the settings of the Status key or, on dial decks, the Page & Settings dial.
It asks the Stream Deck app to install every missing bundled profile for each connected deck - approve each prompt the app shows (one per profile; the app never installs silently).
Does updating DeckBridge overwrite my customized profiles?
No - an update never touches an installed profile, so your customizations always survive. The flip side: when an update ships an improved default layout, your installed profiles keep the old one.
To adopt the new defaults, delete that profile in the Stream Deck app's preferences, then press Reinstall default profiles in the Status key's settings.
How do I reach the extra pages I added on a deck without dials?
Hold the corner tiles (about a third of a second): Timecode, bottom-left, goes to the previous page of keys; Status, bottom-right, to the next - the chevrons on their outer edges show the direction, and both wrap around at the ends. A quick tap still does the tile's normal job (Timecode taps to the next Resolve page).
If the hold just flashes an alert, the current profile has only one page - add more with the app's + under the key grid.
Where are the plugin settings on a deck without dials?
In the Status key's settings panel - select the Status key in the Stream Deck app and the inspector shows the full settings home: setup state, MIDI ports, keymap import, the "Your keys" readout, Copy Diagnostics, Reinstall default profiles and the uninstall cleanup. It's the same panel the Page & Settings dial shows on dial decks.
If no Status key is placed, drag one from the DeckBridge action list onto any empty slot.
What do the M, S and R letters on a fader pair mean?
The strip's live state, straight from Resolve's Fairlight mixer: grey M is muted, green S is soloed, red R is record-armed. They appear in the fader's top-right corner whenever the state is active, and need MIDI connected - without it the deck can't hear the mixer.
There are two Timecode actions - what's the difference?
Timecode is a key for button decks: timecode, current page and health dots on one tile, with tap and hold gestures. Timecode Dial is for the touch strip on dial decks: a big dedicated readout whose dial jogs the playhead.
If you used an earlier build: the key was called Status before, and today's Status key was Setup & Status - same actions, clearer names, and your placed keys carry over unchanged.
This site won't load on my work network - certificate error with no way past it
Your network's security appliance is intercepting HTTPS and re-signing it with its own certificate. deckbridge.io enforces strict HTTPS (HSTS), so browsers refuse the substituted certificate outright rather than offering a proceed-anyway link - that refusal is the browser protecting you, and it's not something we can lift from our side.
Ask IT to either install the appliance's certificate on your machine or exempt deckbridge.io from TLS inspection; from home or a phone the site loads normally.
How do refunds work?
DeckBridge is sold on the Elgato Marketplace, so purchases, receipts and refunds are handled by Elgato under the Marketplace refund policy - request one from your Marketplace account, not by email to us. Unsure whether DeckBridge fits your setup? Ask us first and we'll tell you straight.
Known issues
- Color-page play LED. Resolve doesn't emit the MCU play light on the Color and Fusion pages; DeckBridge infers play from your own press, so play started from the keyboard or UI on those pages isn't reflected until the next stop. Cosmetic.
- Windows 10. DeckBridge targets Windows 11. On Windows 10 the deck runs keystroke-only with an amber MIDI state (no mixer/timecode) - supported best-effort.
- Freeroll timecode. During playback Resolve's API goes quiet, so the timecode dial estimates (shown amber) and re-anchors exactly on stop. By design.
- Page switching during playback. Changing pages from the deck while the timeline is playing may not take effect on the Edit and Color pages - stop playback first. This is a Resolve scripting limitation, not a DeckBridge fault.
A Resolve update broke something? The deck's red/amber states link straight to the fix; this list carries anything newer than the shipped build.
Uninstall - completely
- In the settings of a Status or Page & Settings key (the only DeckBridge inspectors with the Uninstall section - add one from the action list if neither is placed), press Remove DeckBridge data… and confirm. This de-commissions the MIDI buses (restoring your original configuration from the pristine backup), removes the bridge script from Resolve, and deletes all DeckBridge app data.
- Then uninstall the plugin from the Stream Deck app as usual.
Prefer to do it by hand, or removed the plugin first? The manual steps:
delete ~/Library/Application Support/com.deckbridge.resolve
(macOS) or %APPDATA%\com.deckbridge.resolve (Windows), remove
DeckBridge from Resolve's Workspace → Scripts folder, and delete the
two DeckBridge buses in Audio MIDI Setup → MIDI Studio → IAC Driver.