Install Instructions - obsproject/obs-studio GitHub Wiki

Table of Contents

Building OBS Studio

Please see the build instructions for:

Windows

Installer

Microsoft Store

Steam

  • Install OBS Studio from Steam

Portable version

  • Download the official ZIP version of OBS Studio from:
  • Unzip the ZIP
  • In the folder you unzipped, create a blank .txt file and name it obs_portable_mode.txt

macOS

Disk image

  • Download the official macOS version of OBS Studio from:
  • Mount the disk image (.dmg) and drag OBS.app to the Applications folder

Linux

Prerequisites for all versions

  • xserver-xorg version 1.18.4 or newer is recommended to avoid potential performance issues with certain features in OBS, such as the fullscreen projector.

  • OpenGL 3.3 (or later) support is required to use OBS Studio on Linux. You can check what version of OpenGL is supported by your system by typing glxinfo | grep "OpenGL" on Terminal.

  • For virtual camera support, you need the v4l2loopback kernel module installed. You can install it with the following command:

    • Debian/Ubuntu-based:

      sudo apt install v4l2loopback-dkms

    • Red Hat/Fedora-based (requires RPM Fusion to be enabled):

      sudo dnf install kmod-v4l2loopback

    • Fedora Silverblue/Kinoite:

      rpm-ostree install kmod-v4l2loopback

    • Arch Linux-based/Manjaro:

      You will need to install the kernel headers package of your actual kernel beforehand or the module will not be completely installed.

      sudo pacman -S v4l2loopback-dkms

    OBS Studio will normally load the module while starting the virtual camera if the module was not already loaded. This requires a working polkit setup.

    Alternatively, you can also load the module manually using modprobe v4l2loopback exclusive_caps=1 card_label='OBS Virtual Camera'. You can also use modprobe.d conf files to automate this.

    In either case, please refer to your distros documentation on how to do this.

Supported builds

The OBS Project maintains two official, supported Linux builds of OBS Studio: Flatpak and Ubuntu.

Flatpak

The Flatpak distribution is recommended for non-Ubuntu distributions.

Ubuntu

  • Enable the multiverse repo in Ubuntu's software center
  • Install OBS Studio on Ubuntu 18.04 or later using: 
    sudo add-apt-repository ppa:obsproject/obs-studio
sudo apt update
sudo apt install obs-studio

Unofficial builds

Please note that any install directions/packages for Linux/FreeBSD distributions listed as unofficial means that they are community provided, and any support for those packages should be directed at the appropriate distro/package maintainers.

Read the Unofficial Linux builds guide for installation instructions on other Linux distributions, including:

  • Arch Linux
  • Debian
  • Fedora
  • Gentoo
  • Manjaro
  • NixOS
  • OpenMandriva
  • OpenSUSE
  • snappy
  • Solus
  • UOS/Deepin
  • Void

FreeBSD

Install OBS Studio:

pkg install obs-studio