C++ program based on libobs (from obs-studio), designed to read RTMP streams and compose them as sources in different scenes.
The main part consists of a gRPC server. An example client is also provided.
This project uses Docker to ease build and deployment. If you follow the prerequisites below, accessing the GPU with Docker should work out of the box.
apt install make
Check which CUDA version is installed on your host using nvidia-smi
. If needed, edit Dockerfile
to use the same version as a base image: FROM nvidia/cudagl:<YOUR CUDA VERSION HERE>-devel-ubuntu22.04
Existing tags: https://hub.docker.com/r/nvidia/cudagl/tags
Build and run the server:
make build
make run
Start the client in an other terminal:
make client
From the client, you can switch the source using by pressing s
and Enter
.
In order to allow the container to use the host's X Server, the Makefile runs the xhost +
command everytime you use the run
or targets.
You can undo this by executing xhost -
on your host machine.
You can specify which OBS version to build and run with, for example:
make obs_version=28.0.3 build
make obs_version=28.0.3 run
Input: edit etc/shows/default.json
to set the default scene when starting obs-headless. It contains two RTMP sources as inputs, for which you must set the URL of public or local RTMP streams (see STREAMING.md).
Output: edit config.txt
to set server
and key
with your output stream URL and key. You can stream to any platform supporting RTMP (Twitch, Youtube, ...). You can also use any local RTMP server (see STREAMING.md).
The build system uses three images:
Using the dev image: you can start a container with obs-headless sources attached as volumes, so you can edit sources and rebuild in the container.
make shell-dev
.rb
and start with st
(see etc/bashrc for aliases).Using the base image, you can also build obs-studio from sources.
obs_sources
in Makefile to the path where you just cloned obs-studiomake shell-base
.rb
and start with st
(see etc/bashrc for aliases).find_libobs_data_file()
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++17 -Wall -Werror -Wno-long-long -pedantic")