Spout2 Source Plugin for OBS Studio (64bit)

This plugin enables the import of shared textuers at high resolution from SPOUT2 compatible programs.

Why

Previously the only way to import shared textures from SPOUT was via the DirectShow SpoutCam interface or by screen-capturing the full-screen output of the SpoutReceiver program.

The SpoutCam is limited to standard webcam resolutions and capped at 1920x1080 and capturing the SpoutReceiver is both inefficient and limited by your current screen resolution

This plugin implements the SPOUT2 SDK and creates Source from the SPOUT shared texture

Acknowledgements

Thanks to the developer of OBS-OpenVR-Input-Plugin whose source helped greatly in getting my head around the OBS API.

Thanks to the OBS team and their discord channel

Thanks to the authors of SPOUT for the library and clear documentation

Installation

• Go to the Releases Page
• Download the windows installer: OBS_Spout2_Plugin_Installer.exe
• Run the installer (accepting installation from untrusted source)
• Select the OBS directory if not the default install location

N.B there are no current plans for 32bit builds, although theoretically this should be possible

Contributing / Building

• Clone the main OBS repository
• Carefully follow their build instructions ensuring that your build folder is build64
• Add this repo as a submodule inside the plugins folder: git submodule add git@github.com:Off-World-Live/obs-spout2-source-plugin.git plugins/win-spout
• Download Spout.2.006 and extract the files from the directory SpoutSDK/Source to a new folder deps/spout inside the win-spout plugin folder
• Edit the CMakeLists.txt file in /plugins directory and add add_subdirectory(win-spout) inside the if(WIN32) block.
• Run Configure, Generate and then Open Project in the CMake Gui

Building the windows installer

• Download the latest version of NSIS here;
• Set the the APPVERSION variable in win-spout-installer.nsi
• Compile win-spout-installer.nsi

Pull Requests welcome!

Contributors

Thanks to everybody that submitted bug tickets and in particular the code contributors:

• @shugen002
• @mzlt
• @terids

Roadmap

• Improve CMakeLists.txt to copy Spout.dll automatically (thanks to @shugen002)
• Spout Output

License

This plugin authored by Campbell Morgan is Copyright Off World Live Ltd, 2019-2021 and licenced under the GPL V.2.