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.
Porting libobs, module by module
Whole repository, bytes of source by language:
libobs and app figures: conversion.json @ d8562f7e · 2026-11-21. Language bytes: GitHub linguist, 2026-11-21.
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.
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.
- Portable · x64223 MB
e07b77781519ae1c9cdcadb7444c13d26cc8fd04d4a3c18531808b24d52534c2 - Portable · arm64200 MB
3f54613f0462f8fbcd4bf33d68b7c54dee4453565dd484ff9ea1ba88121676cc
Verify: Get-FileHash <file> must equal the SHA-256.
- Apple silicon229 MB
ce528d7066c0c43e665d16cde5d67e7a3ae9f233add4e4d631e43b32f51173f6 - Intel245 MB
6c7803016fe157d56ac5e84685b1a77572104f47fadbdbd3a92be34881328e7b
Verify: shasum -a 256 <file> must equal the SHA-256.
- AppImage · any distro107 MB
ad525f5e6a4317971894caef01988c59b5e8978614fe200f80a0aebeb55173bf - .deb · Ubuntu 26.04181 MB
38e8689cc1c4ed00c6750568966523e21feca79669f32a00092423712da1f5a3 - Flatpak bundle179 MB
b63987244fd28a1a09cdbe3df93d4a3fa41cc8e35df2eab85f84e676865781d5
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.
- Installer · x64191 MB
06e1c03e3adb586f29cd9a1a66850b4e3ce84f482fb7a65fc722c943f5da2d62 - Installer · arm64165 MB
db39c72a9470e6c6f544969eb10f851266535088b4395a52aeb7eb3afe52af38 - Portable · x64224 MB
d58904759816eb33011552ff385bc695a3e7abce556bc4218b9b39d9fd858144 - Portable · arm64201 MB
a614f86127dfb9d7b2e0d19e8163185cfd9c464e64151f7130b5aecc8d0c8860
Verify: Get-FileHash <file> must equal the SHA-256.
- Apple silicon229 MB
4715f83e377a9998b27385ae7c5083ddffc422e810c9f0c2374e413be3696edc - Intel245 MB
2e266a3bc20443e629449d3e6f7905beb89e1b60bf64bd54c87f6e37501873a0
Verify: shasum -a 256 <file> must equal the SHA-256.
- AppImage · any distro107 MB
cc0590787f3e52ddc99978d63b9f98a354eae8d87d86623de2001e32bb5f1c08 - .deb · Ubuntu 26.04181 MB
4d3df6d0aeb8ea903ae9520e01368975bc5bafbf4acef118bb8889b749be9e91 - Flatpak bundle179 MB
e41e8c618c32cf1935a60a0031872b587f424ffd07a4d34923762252f19d938b
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.
What's different
Every user-visible change from upstream gets a line in docs/features.md. Newest first:
MCP starts without X11
The headless host uses an available Wayland compositor or X server, and serves control requests without either display. Video operations report unavailability when no display can create graphics.
Bounded MCP waits
Agents can wait for typed output/source/media/metric conditions and request automatic waits on starts, without GUI interaction or fixed sleeps. Timeouts return the last observation.
Typed MCP control
Existing OBS MCP tools publish input and output schemas, structured results and machine-readable domain errors. Read operations carry annotations, and repeated output start/stop calls succeed with current state.
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…
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…
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…
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…
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…
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…
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).
Captures: docs/gpu-status.md. On an RTX 3060 (NVML), and on the same machine forced onto llvmpipe (red, because a GPU is present).
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"
Drive OBS from anything
WebSocket API
All 147 requests, 60 events and every enum, searchable. You can call your own OBS from the page.
Open reference → MCPMCP server
Give an AI agent OBS: 30 typed tools for scenes, sources, recording, streaming, screenshots and waits.
Plug in an agent → { }Examples
Rust, Python, JavaScript and raw-socket clients, plus plugin and script starters.
Copy & run → AILLM corpus
107 documents in 1739 searchable chunks, also served as llms.txt and llms-full.txt for agents.
Search corpus → Clibobs reference
The C API reference for plugin authors: sources, outputs, encoders, graphics.
Read →