By the end of this guide you will be able to tap a single key on your Elgato Stream Deck to instantly switch between OBS Studio scenes, with custom icons and labels that update live as you broadcast. No more hunting through OBS with a mouse mid-stream or fumbling with Alt+Tab. You will create dedicated scene buttons for layouts like Gaming, Be Right Back, and Ending, plus a folder for overflow scenes if you need them.
To follow along you should already have OBS Studio installed and at least two scenes created, an Elgato Stream Deck connected via USB, and administrator access to install plugins on your computer. Basic familiarity with dragging actions in the Stream Deck software helps but is not required.
Before You Start
| What you need | Why | Optional? |
|---|---|---|
| Elgato Stream Deck (MK.2, Mini, XL, or Stream Deck +) | Hardware that sends scene switch commands to OBS | No |
| Windows 10/11 or macOS 12+ PC with OBS Studio 29.0 or newer | Runs the Stream Deck app and OBS Studio with websocket support | No |
| Elgato Stream Deck app 6.5 or newer | Configures keys and installs the OBS plugin, located at C:\Program Files\Elgato\StreamDeck\StreamDeck.exe on Windows or /Applications/Elgato Stream Deck.app on macOS | No |
| OBS Studio plugin for Stream Deck by Elgato | Provides the native Scene and Source actions; installs from Stream Deck app > Store > Plugins > OBS Studio | No |
| Two or more OBS scenes already created | Gives you actual targets to switch between, for example Intro, Gameplay, Webcam Only, BRB | No |
| Custom PNG icons 72×72 or 144×144 pixels | Makes scene keys instantly recognizable | Yes |
Step-by-Step
Step 1: Install the Stream Deck App and OBS Plugin – 3 minutes
Open the Stream Deck app. Go to the top menu bar and click Stream Deck > Check for Updates and install any update so you are on 6.5 or newer. Then click the Store icon in the top right, select Plugins from the left sidebar, search for OBS Studio, and click Install. When prompted, click Install again to confirm. After installation, you will see an OBS Studio category appear in the right-hand Actions panel. Keep OBS Studio closed for the next step.
Step 2: Connect OBS Studio to the Stream Deck App via WebSocket – 2 minutes
Open OBS Studio. Go to Tools > WebSocket Server Settings. Check Enable WebSocket server if it is not already checked. Confirm the Server Port is 4455 and leave Enable Authentication checked. If you set a password, copy it. Click OK. Next, open the Stream Deck app, drag any OBS Studio action like Scene to a blank key to trigger the connection prompt, and enter localhost as the IP, 4455 as the Port, and your password. Click OK. A green dot appears at the bottom of the Stream Deck app when the connection is successful. As of the current workflow in 2026, this native websocket replaces the older obs-websocket 4.x manual install.
Step 3: Create Your First Scene Switch Key – 2 minutes
In OBS Studio, confirm your scene names under the Scenes dock. In the Stream Deck app, make sure your device profile is selected at the top. From the Actions panel on the right, expand OBS Studio and drag Scene onto the key you want to use. With the new key selected, look at the Property Inspector at the bottom. Under Scene, open the dropdown and choose your target scene, for example Gameplay. Change Title to a short label like GAME and set Title Alignment to Center. The key will immediately display the name of the scene you selected.
Step 4: Assign Remaining Scenes and Organize With a Folder – 4 minutes
Repeat Step 3 for each additional scene. For a typical setup, assign: Key 1 – Intro, Key 2 – Gameplay, Key 3 – Webcam Only, Key 4 – Be Right Back. If you have more than six scenes, create a folder to keep your main page clean. To do this, drag Create Folder from the Stream Deck category onto an empty key, name it SCENES, then double-click the folder to enter it and drag more Scene actions inside. Press the back arrow icon at the bottom left of the folder page to return. You can reorder keys by dragging them within the Stream Deck app canvas.
Step 5: Add Custom Icons and Visual Feedback – 3 minutes
Select a scene key in the Stream Deck app. In the Property Inspector, click the small image thumbnail next to the Title field, then click Set Image From File and browse to your PNG file. Use 144×144 pixels for crisp icons on Stream Deck MK.2 and XL, or 72×72 on Mini. For text readability, set Font to Arial Bold, Size to 11 pt, and Color to White. To add live feedback, enable Show Scene Icon if available under the action settings; this adds a subtle highlight border on the active scene. Alternatively, set State 1 to a brighter version of the image so you can see at a glance which scene is live.
Step 6: Set Up Multi Action for Complex Switches – 4 minutes
If you want one key to switch scenes and trigger other actions, use Multi Action. From the Actions panel, expand Stream Deck and drag Multi Action onto a blank key. Double-click the key to enter the Multi Action editor timeline. Click Add Action, then add OBS Studio > Scene and choose your Ending scene. Click Add Action again and add OBS Studio > Mute Source and select Desktop Audio, or add System > Hotkey and set it to Ctrl+Shift+M if you use that for Discord mute. You can set a Delay of 500 to 1000 ms between actions by clicking the clock icon between steps. Rename the Multi Action key to END STREAM in the top field and assign an icon.
Step 7: Configure Stream Deck Preferences for Reliable Switching – 2 minutes
In the Stream Deck app, go to Stream Deck > Preferences > General on Windows or Elgato Stream Deck > Preferences > General on macOS. Check Start on System Startup and Keep Stream Deck app in menu bar. Go to Plugins and ensure OBS Studio shows as Enabled. In OBS Studio, go to Settings > Advanced and uncheck Automatically Reconnect under Network if you use Stream Deck on the same machine, which prevents websocket conflicts. Leave your Stream Deck connected to a direct USB port, not through an unpowered hub, for consistent recognition.
Verify It Worked
Test without going live first. In OBS Studio, click Start Virtual Camera or look at the Preview pane if you use Studio Mode. On your Stream Deck, press the Gameplay key. The Program window in OBS should cut instantly to the Gameplay scene, and the key should show its active state highlight if you enabled it. Press Be Right Back and confirm the transition completes without a black flash. Open the Stream Deck app and check the bottom status bar shows Connected with a green indicator under OBS Studio. If you created a Multi Action, press it and confirm both the scene changes and your audio mutes. Finally, record a 30-second test via OBS > Controls > Start Recording, switch scenes two or three times, stop recording, and play back the file from C:\Users\YourName\Videos or /Movies on macOS to confirm cuts are clean and in the right order.
Mistakes to Avoid
Stream Deck shows yellow exclamation mark and scene does not switch. What causes it: The websocket password or port does not match between OBS and the Stream Deck plugin, or OBS was opened after the Stream Deck app and failed to handshake. How to check: In OBS go to Tools > WebSocket Server Settings and verify Port 4455 and password. In Stream Deck app, select any OBS Scene key and check the Property Inspector for Connection Status: Disconnected. What to do: Update the IP to 127.0.0.1 or localhost, port to 4455, and re-enter the exact password, then click OK and restart both apps with OBS opened first. How to undo: If you changed the OBS password and want to revert, go back to Tools > WebSocket Server Settings, click Show Connect Info > Copy Password or Generate New Password, and paste the new value into the Stream Deck plugin settings.
Pressing the key switches to the wrong scene or a missing scene. What causes it: You renamed or deleted a scene in OBS after assigning it in Stream Deck, so the key still points to the old name. How to check: Select the key in Stream Deck app and look at Property Inspector > Scene dropdown; it will show Not Found or a different name than your current Scenes list. What to do: Open the dropdown and reselect the correct scene name, then click away to save. Always rename scenes in OBS first, then reassign keys. How to undo: Press Ctrl+Z in the Stream Deck app immediately after the change to revert the key assignment, or drag the Scene action off the key and re-add it.
Scene switch works but causes audio to double or echo. What causes it: Both scenes contain the same Desktop Audio source set to Monitor and Output, and switching layers them. How to check: In OBS go to Edit > Advanced Audio Properties and see if Desktop Audio is set to Active in multiple scenes with Monitor and Output enabled under Settings > Audio > Advanced > Monitoring Device. What to do: In each scene, remove duplicate global audio sources and instead add audio sources as Scene-specific, or set unused scenes to Monitor Off. For Multi Actions that mute, add a 750 ms Delay before the Mute Source action so OBS finishes the transition first. How to undo: Go to Settings > Audio and reset to defaults, or re-add Desktop Audio under Settings > Audio > Global Audio Devices and set Channel to Stereo.
Keys revert to default icons after reboot or export. What causes it: Custom images were linked from a temporary Downloads folder that was moved or cleaned, or the profile was not saved. How to check: In Stream Deck app go to Stream Deck > Preferences > Profiles and see if Last Saved shows an old timestamp, and inspect the key icon path in the Property Inspector. What to do: Move all custom PNGs to a permanent location like C:\Users\YourName\Pictures\StreamDeck Icons or /Users/YourName/Pictures/StreamDeck-Icons and reassign them via Set Image From File. Then go to Profiles > Export to back up the .streamDeckProfile file. How to undo: Use Profiles > Import to restore the previous backup, or right-click the key > Reset to clear the broken link and reapply the icon.
FAQ
Can I switch OBS scenes with Stream Deck without the OBS Studio plugin?
Yes, but it is less reliable. You can assign System > Hotkey actions on the Stream Deck and bind those hotkeys in OBS under Settings > Hotkeys, for example set Gameplay to Ctrl+F1, BRB to Ctrl+F2. However, hotkeys require OBS to be the focused window on some systems and do not provide active-state feedback. The native OBS Studio plugin via websocket is recommended because it works in the background and shows which scene is live.
How do I make the Stream Deck automatically switch scenes when I change games?
Use the Switch Profile action with an Application trigger. Install the Stream Deck plugin called App Switcher or use Elgato’s built-in Profile switching. Go to Stream Deck > Preferences > Profiles, select your gaming profile, click the gear icon and set Switch to this profile when application is active, then choose your game executable like eldenring.exe. Combine this with a Multi Action on profile load that includes an OBS Studio > Scene action. Remember to set Application detection delay to 1000 ms to avoid rapid switching if you Alt+Tab.
What is the difference between Scene and Source actions on the Stream Deck?
Scene switches the entire layout, including all sources within it, while Source toggles visibility of a single layer. Dragging OBS Studio > Scene lets you cut to a full composition like Starting Soon. Dragging OBS Studio > Source > Show/Hide lets you turn a webcam, overlay, or alert box on or off without leaving the current scene. For clean switching, use Scene keys for major transitions and Source keys for temporary elements. You can set Source action Toggle Mode to Press to Toggle or Turn On/Off with custom icons for each state.
Why is there a delay between pressing the key and the scene changing?
Most delays come from OBS transition duration, not the Stream Deck. Check OBS > Scene Transitions and see if Duration is set to 300 ms or higher. Set it to 150 ms for Cut or 300 ms for Fade if you want faster switching. Also check Stream Deck Multi Action delays between steps; reduce them to 0 ms unless you need audio to mute after the cut. If delay persists, go to Stream Deck app > Preferences > Advanced and disable Enable Animation, and ensure OBS Studio > WebSocket Server Settings > Enable WebSocket server uses port 4455 on localhost rather than a network IP which adds latency.