Repolode
Niek

Niek/obs-web

A browser-based remote control for OBS Studio that manages scenes, streaming and recording over obs-websocket, with no install needed.

Stars
1,498
Forks
178
Open issues
7
Last commit
22 hours ago

What is it?

OBS-web is a web client for controlling OBS Studio from any modern browser on desktop or mobile. It connects to OBS through the obs-websocket server, so you can switch scenes, start and stop streaming and recording, and trigger the Replay Buffer without installing extra software on the controlling device.

The interface shows a live preview and program output refreshed about once per second, supports Studio Mode, and lets you switch profiles, scene collections and custom transitions. Control works on the local network, and can also reach OBS over the internet through WSS tunnels. A host can be encoded in the URL to create a bookmarkable deeplink.

The project targets OBS v28 and later with obs-websocket v5, with older versions supported through the v4 compatibility build. It is written in Svelte and can be run locally with npm or deployed via the provided Docker image.

Key features

  • 01Switch scenes and start or stop streaming and recording from a browser
  • 02Live preview and output view updating about once per second
  • 03Studio Mode support with separate preview and program scenes
  • 04Replay Buffer, profile, scene collection and custom transition control
  • 05Remote access over WSS tunnels in addition to the local network

Use cases

  • Running a live stream from a phone or tablet while moving around a studio
  • Letting a co-host or assistant manage scenes on a separate device
  • Controlling OBS on a home or office machine from outside the local network

Quick start

  1. 1

    Open the hosted app in a browser

  2. 2

    Enable the OBS-websocket server in OBS

  3. 3

    Run the Docker image

    docker run --rm -p8080:8080 ghcr.io/niek/obs-web

Things to know

  • Requires OBS v28 or higher for the standard setup; older versions need manual plugin installs or the unmaintained v4 build.
  • Remote control outside your local network needs a separate WSS tunnel service.

Topics

FAQ

What is obs-web?
A browser-based remote control for OBS Studio that manages scenes, streaming and recording over obs-websocket, with no install needed. OBS-web is a web client for controlling OBS Studio from any modern browser on desktop or mobile. It connects to OBS through the obs-websocket server, so you can switch scenes, start and stop streaming and recording, and trigger the Replay Buffer without installing extra software on the controlling device.
Is obs-web free to use? What license does it have?
obs-web is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is obs-web still maintained?
Actively maintained. The last commit to obs-web was on Oct 19, 2026.
What can I use obs-web for?
Running a live stream from a phone or tablet while moving around a studio Letting a co-host or assistant manage scenes on a separate device Controlling OBS on a home or office machine from outside the local network
How do I install obs-web?
Open the hosted app in a browser Enable the OBS-websocket server in OBS Run the Docker image: docker run --rm -p8080:8080 ghcr.io/niek/obs-web
Where can I get obs-web?
The source code and installation instructions are on GitHub: https://github.com/Niek/obs-web

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects