An OBS Studio filter that sends a scene or source straight to a Blackmagic DeckLink output.
By Ben Todman · flashbang.media
Inspired by DistroAV's dedicated-output filter. Built on the obs-plugintemplate scaffold.
- DeckLink Output filter on scenes and sources
- Start / Stop and Auto Start
- Audio routing: master, source/scene, selected source, or mute (video only), with pre/post-fader tap
- Device conflict detection (Tools → DeckLink Output, other filters, or DeckLink input on the same device)
- Status line in the filter properties
- It does not reimplement DeckLink support. Instead it drives OBS’s existing built-in
decklink_output, so device discovery, modes, keyer, and SDR options stay native to OBS.
- OBS Studio with DeckLink support enabled
- A Blackmagic DeckLink device and Desktop Video drivers
| Platform | Status |
|---|---|
| macOS (Apple Silicon) | Tested |
| macOS (Intel) | Not tested |
| Windows | Tested |
| Linux | Not tested |
- Download a release for your platform (or build from source).
- Install the package, or copy the plugin into OBS’s user plugins folder:
| Platform | Package | Manual path |
|---|---|---|
| macOS | .pkg installer |
~/Library/Application Support/obs-studio/plugins/ |
| Windows | .exe installer or .zip |
%PROGRAMDATA%\obs-studio\plugins\ |
| Linux | .deb (sudo dpkg -i …) |
~/.config/obs-studio/plugins/ |
- Restart OBS.
- Right-click a scene or source → Filters → add DeckLink Output.
- Choose the DeckLink device and mode.
- Set audio routing if needed.
- Click Start Output (or enable Auto Start).
Stop the output before changing device/mode settings. Only one filter (or Tools → DeckLink Output) can use a given device at a time.
You need CMake 3.30.5+ and a C/C++ toolchain. On first configure, macOS/Windows download OBS build deps into .deps/; Linux uses system OBS packages.
After building, use the package steps below to produce installable artifacts under release/.
The macos preset builds a universal binary (arm64 + x86_64). That works when OBS/deps are universal (the first configure downloads them into .deps/).
If you only have Apple Silicon OBS (arm64-only — typical for /Applications/OBS.app), build arm64 only or the x86_64 link will fail:
cmake --preset macos -DCMAKE_OSX_ARCHITECTURES=arm64
cmake --build --preset macos --parallelUniversal build (downloaded .deps):
cmake --preset macos
cmake --build --preset macos --parallelPackage (creates the .pkg installer and plugin bundle):
cmake --install build_macos --config RelWithDebInfo --prefix release/RelWithDebInfoArtifacts:
release/RelWithDebInfo/deck-out-*-macos-*-Installer.pkg— installerrelease/RelWithDebInfo/deck-out.plugin— plugin bundle (manual install)
Optional: put machine-specific overrides (local OBS paths, CMAKE_OSX_ARCHITECTURES, etc.) in a gitignored CMakeUserPresets.json.
Requires Inno Setup 6 to package.
cmake --preset windows-x64
cmake --build --preset windows-x64 --parallelPackage (creates the installer and zip):
cmake --install build_x64 --config RelWithDebInfo --prefix release/RelWithDebInfo
.\.github\scripts\Package-Windows.ps1 -Target x64 -Configuration RelWithDebInfoArtifacts:
release/deck-out-*-windows-x64-Installer.exe— installer (requires admin; installs to%PROGRAMDATA%)release/deck-out-*-windows-x64.zip— manual install into%PROGRAMDATA%\obs-studio\plugins\
sudo apt-get install build-essential cmake ninja-build pkg-config obs-studio
cmake --preset ubuntu-x86_64
cmake --build --preset ubuntu-x86_64 --parallelPackage (creates a .deb via CPack):
cmake --build build_x86_64 --target packageArtifact: release/deck-out-*-x86_64.deb (exact name includes version and architecture). Install with:
sudo dpkg -i release/deck-out-*.debCopyright (C) 2026 Ben Todman.
GPL-2.0-or-later — see LICENSE and source file headers.
- Website: www.flashbang.media
- GitHub: github.com/bentodman