obs-studio-rust · stable v1.0.0

The OBSyou know.Rebuilt in Rust.

An independent rewrite of OBS Studio, one module at a time. The libobs C ABI, the obs-websocket v5 protocol and your plugins, scenes and profiles are built to keep working, and 389 upstream bugs are already fixed.

Program · OBS Studio RustAppImage test capture
OBS Studio Rust's main window: Scenes and Sources docks with Mic, Camera and Screen sources, a colour-bar preview, the audio mixer, and a recording in progress.
libobs61.1% ported to Rust
Screenshot: docs/images/appimage-main-window.png, taken by the AppImage's saved-profile test. Figure: conversion.json @ d8562f7e.
Conversion progress

Porting libobs, module by module

61.1% of libobs ported

Whole repository, bytes of source by language:

21.6 MB Rust21.1 MB C5.8 MB C++Whole app 17.5% ported

libobs and app figures: conversion.json @ d8562f7e · 2026-11-21. Language bytes: GitHub linguist, 2026-11-21.

91User-visible changes
389Upstream bugs fixed
147WebSocket requests
27Forks
Drop-in, by contract

Built to stay compatible

The public surface is a compatibility contract. Rust replaces C behind the same symbols, and four tiers of tests compare the Rust build against the original C.

Clibobs C ABI

The exported symbols and headers stay the same. Plugins compiled for OBS load without a rebuild.

v5obs-websocket

The upstream C++ plugin ships unmodified as the compatibility check. Stream Deck, Touch Portal, bots and overlays keep working.

pyScripting

The Lua and Python scripting APIs and the frontend API work as before. Your scripts and docks still run.

⇄Profiles & scenes

On first start it copies upstream OBS's settings, profiles, scenes and plug-in settings into its own folder. The originals are left untouched.

Every port starts red

the four tiers

A port starts with a failing test and is finished when that test passes. Before the C version is deleted, the Rust replacement has to pass all four tiers:

Rust unit tests

Fast, focused tests on the new Rust module itself.

Unchanged C tests

The original cmocka suite, unmodified, run against the Rust implementation.

Differential

The Rust and C versions run side by side on the same inputs, and the outputs are compared.

Black-box protocol

Real obs-websocket clients run against the whole app.

Read the testing policy and coordination guide.

Download

Get OBS Studio Rust

It installs and runs beside upstream OBS with its own app identity and settings folder, so you can try it without uninstalling anything. Your OS is listed first.

Stable OBS-Studio-Rust v1.0.0 2026-11-01

Recommended. The newest release that is not a prerelease.

x64 · arm64
Windows

Verify: Get-FileHash <file> must equal the SHA-256.

Apple silicon · Intel
macOS
  • Apple silicon229 MBce528d7066c0c43e665d16cde5d67e7a3ae9f233add4e4d631e43b32f51173f6
  • Intel245 MB6c7803016fe157d56ac5e84685b1a77572104f47fadbdbd3a92be34881328e7b

Verify: shasum -a 256 <file> must equal the SHA-256.

x86_64
Linux

Verify: sha256sum <file> must equal the SHA-256.

Beta OBS-Studio-Rust v1.0.1-beta.20261120 2026-11-20

Newest build from master: the latest fixes, less testing.

x64 · arm64
Windows

Verify: Get-FileHash <file> must equal the SHA-256.

Apple silicon · Intel
macOS
  • Apple silicon229 MB4715f83e377a9998b27385ae7c5083ddffc422e810c9f0c2374e413be3696edc
  • Intel245 MB2e266a3bc20443e629449d3e6f7905beb89e1b60bf64bd54c87f6e37501873a0

Verify: shasum -a 256 <file> must equal the SHA-256.

x86_64
Linux

Verify: sha256sum <file> must equal the SHA-256.

What to expect

  • WindowsWindows SmartScreen warns on the first start of the portable build: choose More info, then Run anyway.README.md:114
  • macOSPackages are signed and notarized only when the project's release credentials are configured; an unnotarized app is allowed once in System Settings → Privacy & Security → Open Anyway.README.md:97
  • LinuxThe Flatpak bundle does not update itself and is not on Flathub: install the next release's bundle the same way.README.md:83
  • LinuxThe AppImage is tested on AlmaLinux 8, Ubuntu 22.04 and 24.04, Arch Linux and NixOS; the .deb targets Ubuntu 26.04.README.md:74
  • AllIt installs beside upstream OBS and imports its settings once, on first start; later upstream changes are not imported. Going back is safe: upstream's files are never changed.README.md:67
  • Windows, macOSA new app identity, so the OS may ask for capture permissions again.README.md:68

Every release with its SHA256SUMS: github.com/obs-rust/obs-studio/releases. Full install notes: README · as markdown.

Features ledger

What's different

Every user-visible change from upstream gets a line in docs/features.md. Newest first:

6 older changes

Camera-busy warning names a holder found on a retry, and Quit asks first

When the first look misses the program holding a busy camera, the next retry that finds it replaces the "another program" warning with one that names it (app and PID). The Close it button is now "Quit…

Video captureLinux2026-11-06

Camera-busy warning: Close it, Ignore, Always allow

When a V4L2 camera OBS uses is busy, or another program opens it while OBS has it, OBS names every program holding it (app and PID) in a window of the main window and waits for a click: Close it (SIGTERM, then…

Video captureLinux2026-11-05

OBS-Studio-Rust 1.0 stable release

The certified 1.0.0 release is available; the crate version is now 1.0.1 so daily 1.0.1-beta.<date> builds sort after it. A maintainer dispatch of release-rust.yaml with…

Platforms and packagesAll2026-11-01

ALSA audio comes back after a USB replug

An Audio Capture Device (ALSA) source whose USB device is unplugged and plugged in again captures again within a few seconds, instead of staying silent with its capture thread at full CPU. The log says once that the…

AudioLinux2026-10-29

Chromium sandbox for browser sources on Linux and macOS

Browser sources and panels run in Chromium's sandbox where it can work. On Linux: with unprivileged user namespaces, or with a chrome-sandbox helper that is setuid root. On macOS: each helper app…

Sources and filtersLinux2026-10-25

Fallback warning

When a feature falls back to a less safe mode so that it keeps working (for example a browser source without the Chromium sandbox), OBS logs it at error level and shows a warning with a 3-second countdown that…

Scenes and UIAll2026-10-25
Status bar label GPU: 21% with a green dot Status bar label CPU rendering with a red dot

GPU acceleration light

A light in the status bar shows whether OBS renders on a hardware GPU (green), in software on a machine without a GPU (yellow), or in software although a GPU is present, after a graphics failure or over the frame budget (red).

GPU statusAll2026-10-15

Captures: docs/gpu-status.md. On an RTX 3060 (NVML), and on the same machine forced onto llvmpipe (red, because a GPU is present).

Contribute with your agent

Point an AI at an issue

We welcome AI-generated issues and pull requests, and judge them by the work. Paste this into Claude Code and it picks up a ready issue, writes the failing test, ports the code and opens a PR.

Using another agent? The README has a plain-text prompt. Agents can read the whole project at once from /llms-full.txt.

Caution --dangerously-skip-permissions lets the agent run any command without asking. Use it only in a disposable VM or container with no credentials you would not hand to it.

# one worker, one issue, one PR — on a 10-minute loop
PROMPT="/loop 10m https://raw.githubusercontent.com/obs-rust/obs-studio/refs/heads/master/.claude/skills/obs-worker/SKILL.md"
claude --dangerously-skip-permissions "$PROMPT"