obs-studio-node is a Node.Js compatible wrapper around OBS Studio. It works by wrapping libOBS inside a secondary process that is talked to using lib-streamlabs-ipc, which results in better stability and performance.
The goal of the project is to provide a fully featured working Node.Js and electron wrapper around libOBS (OBS Studio).
CMake offers better compatibility with existing projects than node-gyp and comparable solutions. It's also capable of generating solution files for multiple different IDEs and compilers, which makes it ideal for a native module. It is also the build system of obs-studio, which we depend on for any functionality.
The project is for the most part automated, so there is very little to actually do.
You will need to have the following installed:
- Node.JS (LTS or latest, LTS recommended for now)
- Yarn (Run
npm install -g yarninside a shell with node.js access) - CMake, Version 3.1 or higher
Building on windows requires additional software:
- Visual Studio 2017 or 2015 with the latest update installed.
- Windows SDK (latest version, included in Visual Studio 2017)
- Open a git enabled shell.
- Clone the project:
git clone https://github.com/stream-labs/obs-studio-node.git - Enter the cloned project directory:
cd obs-studio-node - Initialize all submodules recursively:
git submodule update --init --recursive --force - Open a node.js enabled shell (if not already in one) inside the project directory.
- Initialize any node dependencies of the project:
yarn install
- Open CMake-GUI.
- Set "Where is the source code:" to the cloned project directory.
- Set "Where to build the binaries:" to the build directory inside the project directory (you might have to create it first).
- Click "Configure".
- Specify the generator that you want to use. "... Win64" are 64-bit capable generators.
- Optional: If you have a 64-bit system, type in
host=x64into the "Optional toolset to use" box. - Leave it at default native compilers.
- Click Finish.
- Click Generate once the button is no longer grey.
- Open the project (if you still have CMake-GUI open, just click Open Project)
- Build the "ALL_BUILD" project.
- Open CMake-GUI
- Change the "Where to build the binaries:" directory to the configured build directory. CMake should automatically update.
- Modify the CMAKE_INSTALL_PREFIX variable to the directory of your liking. Visual Studio will need to have write & execute access to that location.
- Click Configure.
- Click Generate.
- Open the project and build the INSTALL project. This will create the proper node module structure in the directory you specified to CMAKE_INSTALL_PREFIX
First make sure that you've configured and built obs-studio-node. Once you have done that, do the following:
- Open a node.js enabled shell inside the project directory.
- Run
yarn build:docsand wait for the command to be done. - Documentation will be inside the
/docs/directory as a static HTML file.
A lot of the build system is automated, which makes integrating custom dependencies difficult. However there are some steps that can be taken to at least debug using custom built versions of OBS Studio.
The following setting must be changed before clicking Generate for the first time in obs-studio:
- ENABLE_SCRIPTING must be Off (false)
- ENABLE_UI must be Off (false)
- QTDIR must be empty
To go from just a compiling obs-studio to using the actual custom obs-studio inside obs-studio-node, you must reconfigure obs-studio to install things into <obs-studio-node build dir>/libobs-src. You can do this by changing CMAKE_INSTALL_PREFIX in the obs-studio project. Any changes done to obs-studio must now be installed by building the INSTALL project in obs-studio, and will then be sent along to whatever is using obs-studio-node once you build the INSTALL project in obs-studio-node.
See the Guidelines for contributing.