OBS Studio

From Gentoo Wiki
Jump to:navigation Jump to:search

OBS Studio is free software for video recording and live streaming. Built with Qt, C and C++ and maintained by the OBS Project, the software provides real-time device capture, scene composition, recording, broadcasting and source capture functions with presets for streaming to popular services such as YouTube, Twitch, Instagram and Facebook[1]. In 2014, development started on a rewrite of the software, known as OBS Multiplatform, which included a larger feature set, multi-platform support and broader plugin support[2]. As of 2016, the software was rebranded as OBS Studio, with the older OBS Classic being deprecated.[3]

Installation

USE flags

USE flags for media-video/obs-studio Software for Recording and Streaming Live Video Content

alsa Add support for media-libs/alsa-lib (Advanced Linux Sound Architecture)
browser Enable browser source support via (precompiled) CEF.
decklink Build the Decklink plugin.
fdk Build with LibFDK AAC support.
jack Add support for the JACK Audio Connection Kit
lua Enable Lua scripting support
nvenc Build with NVENC encoding support for nVidia video cards.
pipewire Build with PipeWire support.
pulseaudio Add support for PulseAudio sound server
python Build with scripting support for Python 3.
speex Build with Speex noise suppression filter support.
ssl Build with TLS/SSL support for RTMPS connections.
truetype Add support for FreeType and/or FreeType2 fonts
v4l Enable support for video4linux (using linux-headers or userspace libv4l libraries)
vlc Build with VLC media source support.
wayland Enable dev-libs/wayland backend

For a standard streaming setup that uses a webcam, PulseAudio, has a NVIDIA graphics card and integrates with major streaming services one might add to /etc/portage/package.use :

FILE /etc/portage/package.use/obs-studio
media-video/obs-studio lua nvenc pulseaudio speex v4l

Emerge

root #emerge --ask media-video/obs-studio

Additional software

Audio

OBS Studio can be paired with JACK, Pulseaudio or PipeWire for audio.

VLC

OBS Studio supports integration with VLC media player services. VLC support behaves much like the ordinary media source, however in addition it accepts a list of files to play as well as provides a way to play every path, URL or media source that VLC is able to play.

Configuration

Usage

Invocation

OBS Studio can be invoked from the command line as follows:

user $obs --help
--help, -h: Get list of available commands.

--startstreaming: Automatically start streaming. --startrecording: Automatically start recording. --startreplaybuffer: Start replay buffer. --startvirtualcam: Start virtual camera (if available).

--collection <string>: Use specific scene collection. --profile <string>: Use specific profile. --scene <string>: Start with specific scene.

--studio-mode: Enable studio mode. --minimize-to-tray: Minimize to system tray. --portable, -p: Use portable mode. --multi, -m: Don't warn when launching multiple instances.

--verbose: Make log more verbose. --always-on-top: Start in 'always on top' mode.

--unfiltered_log: Make log unfiltered.

--disable-updater: Disable built-in updater (Windows/Mac only)

--version, -V: Get current version.

Removal

Unmerge

root #emerge --ask --depclean --verbose media-video/obs-studio

Troubleshooting

Wayland

KDE Plasma

If OBS Studio isn't able to record windows the fullscreen on KDE Plasma Wayland, adding the screencast USE flag globally (to make.conf and pipewire for media-video/obs-studio should fix the issue:

FILE /etc/portage/make.conf
USE="screencast"
FILE /etc/portage/package.use
media-video/obs-studio pipewire

External Resources

References