Configuring StreamUP
by Andi
Version: 2.2.1
The main StreamUP plugin for OBS. A collection of tools, shortcuts and quality of life features that fill in the gaps OBS doesn't cover out of the box. Source locking, browser source refreshing, device management, a scene organiser, a customisable toolbar, multi-dock containers, an adjustment layer source, plugin update checking, and a full WebSocket API.
If you've ever wished OBS had "just one more button" for something, this is probably it.
Requires OBS 31.0 or newer. Works on Windows, macOS and Linux.
Tools Menu
Everything lives under Tools > StreamUP in the menu bar. This is the main entry point for all the features below.
Source Locking
Lock all sources in place so you don't accidentally drag something mid-stream.
- Lock or Unlock All Sources locks every source across every scene in one go
- Lock or Unlock Current Scene Sources only affects the scene you're on right now
A notification pops up confirming the current lock state so you know what just happened. Available from the menu, the dock, the toolbar, hotkeys, and WebSocket.
Browser Source Refresh
Hit Refresh All Browser Sources and every browser source in your setup gets reloaded. No more right-clicking each one individually when something gets stuck.
The plugin handles this by toggling the frame rate internally, which forces a proper reload without removing and re-adding the source.
Audio Monitoring Refresh
Refresh Audio Monitoring resets audio monitoring for all sources. If you've ever had audio routing get stuck or monitoring just stop working after a while, this fixes it. One click, everything resets cleanly.
Video Capture Devices
Three tools for managing your cameras and capture cards.
- Activate All wakes up every video capture device in your setup
- Deactivate All powers them all down
- Refresh All toggles devices off and back on again, which fixes cameras that didn't wake up properly when OBS launched
All three are available from the menu, dock, toolbar, hotkeys, and WebSocket.
Transition Copy and Paste
Copy show and hide transitions from one source and paste them onto another. Saves a lot of time when you're setting up consistent transition behaviour across multiple sources.
- Copy Show Transition stores the selected source's show transition
- Copy Hide Transition stores the selected source's hide transition
- Paste Show Transition applies the stored show transition to whichever source you've got selected
- Paste Hide Transition same deal but for hide transitions
A notification confirms each action so you know it went through. Available via hotkeys and WebSocket.
Quick Source Actions
A few handy shortcuts for working with sources faster.
- Group Selected Sources wraps whatever you've got selected into a new group. No more right-click, group, confirm
- Toggle Visibility of Selected Sources flips the visibility of all selected sources at once. The dock button even shows a real-time indicator of the current state
- Open Selected Source Properties opens the properties dialog for the selected source
- Open Selected Source Filters opens the filters dialog
- Open Selected Source Interact Window opens the interaction window (useful for browser sources)
- Open Current Scene Filters opens filters for the scene itself
All available through hotkeys, and most through the dock and WebSocket too.
StreamUP Dock
A small dock with quick-access buttons for the tools you use most. Add it from the Docks menu or it shows up automatically.
Every button is optional. Go to Settings > Dock Configuration to toggle which ones appear:
- Lock or Unlock All Sources
- Lock or Unlock Current Scene Sources
- Refresh Browser Sources
- Refresh Audio Monitoring
- Video Capture Device controls (Activate, Deactivate, Refresh)
- Group Selected Sources
- Toggle Visibility of Selected Sources
Right-click the dock to jump straight into configuration. The visibility toggle button updates in real time to reflect the actual state of your selected sources.
StreamUP Toolbar
A slim, customisable toolbar that replaces or supplements the default OBS Controls dock. Position it at the top, bottom, left, or right of the OBS window.
Toolbar Settings
- Position to dock it where you want (Top, Bottom, Left, Right)
- Icon Size slider from 10 to 24 pixels
- Show/Hide master toggle
Toolbar Configurator
Right-click the toolbar or open it from settings. Three tabs of items you can add:
- StreamUP tab has all the built-in tool buttons (lock, refresh, device controls, group, visibility toggle)
- Dock tab lets you add buttons that show or hide any OBS dock or StreamUP dock
- Hotkey tab lets you create custom buttons that trigger any OBS hotkey, with your choice of icon and label
You can also add spacers with adjustable pixel widths and separators to keep things tidy. Drag to reorder or use the Move Up/Move Down buttons. Reset to Default if you want to start fresh.
Scene Organiser
A full replacement for the built-in OBS scene list. Adds folders, colour coding, search, drag and drop reordering, and a bunch of quality of life features the default list doesn't have.
Setting It Up
Enable it in Settings > Scene Organiser. The main options:
- Show scene and folder icons for visual clarity
- Item height slider (10% to 200%) to fit your layout
- Scene switching mode lets you choose single click or double click to switch scenes
- Automatic sorting with options for alphabetical A-Z, Z-A, newest first, or oldest first. Or leave it on none and sort manually
- Keep folders grouped at top so they don't get lost in the list
- Remember folder expansion state across OBS restarts
- Disable preview switching in Studio Mode if you don't want the preview to jump around
- Disable transition firing in Studio Mode for the same reason
If you're coming from the old SceneTree plugin, there's a one-click import to bring your existing layout across.
The Dock Toolbar
Along the top of the Scene Organiser dock:
- Add Folder
- Remove selected item
- Open Filters for the selected scene
- Move Up / Move Down
- Expand All / Collapse All (the button updates dynamically)
- Lock the organiser layout
- Search box that filters by scene or folder name without collapsing the tree
Scene Context Menu
Right-click a scene for the full set of options:
- Rename, duplicate, remove
- Switch to scene
- Copy filters / Paste filters (transfer filters between scenes without rebuilding them)
- Open scene filters
- Take screenshot
- Show in multiview
- Open projector (any monitor or fullscreen)
- Move Up, Down, To Top, To Bottom
- Sort (A-Z, Z-A, Newest, Oldest)
- Set colour / Clear colour
- Toggle icon visibility
Folder Context Menu
Right-click a folder:
- Rename, delete
- Add a sub-folder
- Create a new scene inside the folder
- Move Up, Down, To Top, To Bottom
Other Bits
- Hide scenes you don't want cluttering the list
- Colour coding for visual organisation
- Drag and drop to reorder scenes and move them between folders
- Search that filters live as you type
Multi-Dock System
Combine multiple OBS docks into a single tabbed container. Keeps your workspace tidy when you've got a lot of docks open.
Creating a Multi-Dock
- Go to Tools > StreamUP > Multi-Dock > New Multi-Dock
- Give it a name
- Drag any OBS dock into the container
Managing Multi-Docks
Tools > StreamUP > Multi-Dock > Manage Multi-Docks lets you edit, rename, delete, or add docks to your containers.
Each Multi-Dock shows up in the menu with a visibility toggle so you can show and hide them quickly. You can also lock the layout to prevent accidental changes. Everything persists across OBS restarts.
Handy for themed setups. Put your "Streaming" docks in one container, your "Recording" docks in another, and toggle between them.
Adjustment Layer Source
A new source type that applies filters to everything underneath it in the scene hierarchy. Works like adjustment layers in Photoshop or After Effects.
Adding One
- In your scene, click + under Sources
- Select Adjustment Layer from the list
- Add filters to it like you would any other source
Whatever filters you put on the adjustment layer affect all the sources below it. One blur filter on the adjustment layer instead of five on five different sources.
Properties
- Opacity controls the blend strength from 0% to 100%
- Group Only limits the effect to sources in the same group. Turn it off and it affects everything in the scene
- Hide Originals hides the unfiltered versions of affected sources, showing only the filtered output
- Filter Mode gives you three options:
- All Sources applies to everything below
- Include List Only applies only to sources you pick
- Exclude List applies to everything except sources you pick
- Source Picker for adding and removing sources from the include or exclude list
When to Use It
Any time you'd otherwise be copying the same filter onto multiple sources. Colour correction across a whole scene, a blur over everything behind an overlay, a shared LUT. One adjustment layer, one filter, done.
Plugin Update Checker
The plugin scans all your installed OBS plugins for available updates. It runs automatically when OBS starts up, or you can trigger it manually from Tools > StreamUP > Check for OBS Plugin Updates.
Each plugin shows its current version, the latest available version, and a direct link to download the update. Shift-click the menu item to force a cache refresh if you think something's out of date.
Product Installer (Windows)
On Windows, you can install StreamUP products directly through the plugin.
- Install a Product loads
.streamupproduct files. Shift-click to force a reinstall - Download Products opens the StreamUP store
- Check Product Requirements scans for any missing plugins that a product needs. Shift-click to refresh the cache
- Font Checker automatically detects missing fonts when installing products and gives you download links
Hotkeys
17 hotkeys you can bind in Settings > Hotkeys or through the StreamUP settings hotkeys tab.
| Hotkey | What it does |
|---|---|
| Lock or Unlock All Sources | Toggles lock state across all scenes |
| Lock or Unlock Current Scene Sources | Toggles lock state for current scene only |
| Refresh Browser Sources | Reloads all browser sources |
| Refresh Audio Monitoring | Resets audio monitoring for all sources |
| Open Selected Source Properties | Opens properties for the selected source |
| Open Selected Source Filters | Opens filters for the selected source |
| Open Selected Source Interact Window | Opens interaction window for the selected source |
| Open Current Scene Filters | Opens filters for the active scene |
| Activate All Video Capture Devices | Wakes up all cameras |
| Deactivate All Video Capture Devices | Powers down all cameras |
| Refresh All Video Capture Devices | Toggles all cameras off and on |
| Copy Show Transition | Stores the selected source's show transition |
| Copy Hide Transition | Stores the selected source's hide transition |
| Paste Show Transition | Applies stored show transition to selected source |
| Paste Hide Transition | Applies stored hide transition to selected source |
| Group Selected Sources | Wraps selected sources into a group |
| Toggle Visibility of Selected Sources | Flips visibility of all selected sources |
The StreamUP settings dialog has its own hotkeys tab where you can bind and manage all of these in one place. Single hotkey recording at a time so you don't accidentally set duplicates.
Settings
Open from Tools > StreamUP > Settings. Everything's organised into tabs.
General
- Run plugin checker on OBS startup to automatically check for plugin updates when OBS launches
- Mute system tray notifications if you don't want popups
- Auto-mute notifications while streaming/recording so they don't appear mid-broadcast
- Show CPH references enables Streamer.Bot code snippets in the WebSocket Commands window
- Show StreamUP Toolbar master toggle
- Enable debug logging for troubleshooting
Plugin Management
A table showing every installed OBS plugin with its status, name, version, module name, and a link to its website. Colour-coded compatibility indicators so you can see at a glance if something needs attention.
Hotkeys
All 17 hotkeys in one place. Bind, rebind, clear, or reset all to defaults.
Dock Configuration
Toggle which buttons appear in the StreamUP dock. Each one can be turned on or off individually. Reset to defaults if you want to start over.
Toolbar
Show/hide toggle, position dropdown, and icon size slider. The Configure Toolbar button opens the full configurator.
Scene Organiser
All the scene organiser settings covered above. Enable/disable, icons, item height, switching mode, sorting, folder behaviour, Studio Mode options, and the SceneTree importer.
WebSocket API
Over 30 vendor commands for automation tools like Streamer.Bot, Touch Portal, Stream Deck, and anything else that speaks OBS WebSocket.
Open Tools > StreamUP > WebSocket Commands for a browsable reference. Every command has copy-to-clipboard support for both OBS Raw request format and Streamer.Bot CPH code (when enabled in settings).
Utility Commands
| Command | What it does |
|---|---|
GetStreamBitrate | Returns the current stream bitrate in kbps |
GetPluginVersion | Returns the StreamUP plugin version |
CheckRequiredPlugins | Lists any missing required plugins |
Source Management
| Command | What it does |
|---|---|
ToggleLockAllSources | Locks or unlocks all sources across all scenes |
ToggleLockCurrentSceneSources | Locks or unlocks sources in the current scene |
RefreshAudioMonitoring | Refreshes audio monitoring for all sources |
RefreshBrowserSources | Refreshes all browser sources |
GetSelectedSource | Returns the name of the currently selected source |
GroupSelectedSources | Creates a group from the selected sources |
ToggleVisibilitySelectedSources | Toggles visibility of the selected sources |
Transition Management
| Command | What it does |
|---|---|
GetShowTransition | Returns the show transition for a source |
SetShowTransition | Sets the show transition for a source |
GetHideTransition | Returns the hide transition for a source |
SetHideTransition | Sets the hide transition for a source |
CopyShowTransition | Copies the show transition from the selected source |
PasteShowTransition | Pastes the stored show transition onto the selected source |
CopyHideTransition | Copies the hide transition from the selected source |
PasteHideTransition | Pastes the stored hide transition onto the selected source |
Source Properties
| Command | What it does |
|---|---|
GetBlendingMethod / SetBlendingMethod | Get or set the blending method |
GetDeinterlacing / SetDeinterlacing | Get or set deinterlacing mode |
GetScaleFiltering / SetScaleFiltering | Get or set scale filtering (point, bicubic, bilinear, lanczos, area) |
GetDownmixMono / SetDownmixMono | Get or set mono downmix |
UI Interaction
| Command | What it does |
|---|---|
OpenSourceProperties | Opens the source properties dialog |
OpenSourceFilters | Opens the source filters dialog |
OpenSourceInteraction | Opens the source interaction window |
OpenSceneFilters | Opens the current scene's filters |
Video Capture Devices
| Command | What it does |
|---|---|
ActivateAllVideoCaptureDevices | Activates all video capture devices |
DeactivateAllVideoCaptureDevices | Deactivates all video capture devices |
RefreshAllVideoCaptureDevices | Refreshes all video capture devices |
File Management
| Command | What it does |
|---|---|
LoadStreamupFile | Loads a .streamup product file by path |
GetVLCCurrentFile | Returns the current file playing in a VLC source |
UI Enhancements
A few visual tweaks that come along for the ride.
- Mixer hover styling gives audio source labels a rounded hover effect (OBS 32.1+)
- Monitoring state icons in Advanced Audio Properties show the monitoring status at a glance (None, Monitor Only, Monitor and Output)
- Studio Mode rounded corners on the program display to match the preview
- Theme awareness so StreamUP styling follows whatever OBS palette you're using
Notifications
Most actions trigger a system tray notification confirming what just happened. You can mute these entirely in settings, or set them to auto-mute while streaming or recording so they don't pop up mid-broadcast.
Patch Notes and About
- Patch Notes shows a collapsible card view of every version's changes. Handy for checking what's new after an update
- About has the version info, credits, support links, and an update check button
Good to Know
- Most tools are accessible from multiple places: the menu, the dock, the toolbar, hotkeys, and WebSocket. Use whichever fits your workflow.
- Shift-clicking certain menu items gives you extra behaviour. Shift-click "Install a Product" to force a reinstall, or Shift-click "Check for OBS Plugin Updates" to refresh the cache.
- The Scene Organiser handles special characters in scene names without issues. Folder expansion states persist across restarts even with unusual naming.
- All settings save automatically to the OBS config. Toolbar layouts, Multi-Dock configurations, hotkey bindings, and folder states all survive restarts.
- The plugin includes a dev tools menu that's hidden by default. Shift-click the menu to reveal it if you need it, but most users won't.