https://github.com/muesli/obs-scene-switcher
Tracks your active window and switches OBS scenes accordingly
https://github.com/muesli/obs-scene-switcher
hacktoberfest
Last synced: about 2 months ago
JSON representation
Tracks your active window and switches OBS scenes accordingly
- Host: GitHub
- URL: https://github.com/muesli/obs-scene-switcher
- Owner: muesli
- License: mit
- Created: 2020-02-05T02:28:25.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-06-09T10:00:02.000Z (about 2 years ago)
- Last Synced: 2025-03-30T18:44:02.065Z (3 months ago)
- Topics: hacktoberfest
- Language: Go
- Size: 26.4 KB
- Stars: 35
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# obs-scene-switcher
[](https://godoc.org/github.com/muesli/obs-scene-switcher)
[](https://goreportcard.com/report/muesli/obs-scene-switcher)
obs-scene-switcher is a command-line remote control for OBS. It requires the
[obs-websocket](https://github.com/Palakis/obs-websocket) plugin to be installed on your system.
## Installation
### Packages & Binaries
On Arch Linux you can simply install the package from the AUR:
yay -S obs-scene-switcher
Or download a binary from the [releases](https://github.com/muesli/obs-scene-switcher/releases)
page. Linux (including ARM) binaries are available, as well as Debian and RPM
packages.
### Build From Source
Alternatively you can also build `obs-scene-switcher` from source. Make sure you
have a working Go environment (Go 1.12 or higher is required). See the
[install instructions](http://golang.org/doc/install.html).
To build obs-scene-switcher, simply run:
go get github.com/muesli/obs-scene-switcher
## Configuration
Edit scenes.toml and define which scenes you want to be connected to which
windows, e.g.:
```
[[scenes]]
scene_name = "IDE"
window_class = "code-oss"
[[scenes]]
scene_name = "Terminal"
window_name = "Konsole"
[[scenes]]
scene_name = "Browser"
window_class = "Chromium"
[[away_scenes]]
scene_name = "Be Right Back"
```
In plain english, this means that whenever you focus your `VS Code` window, OBS
will be asked to switch to the scene called `IDE`. If you focus your `Konsole`
window it switches to the scene `Terminal`, and so on.
The `away_scenes` define scenes which, when currently active, temporarily stop
automatic scene switching. This is useful for keeping special scenes active,
like a "Be Right Back" mode you only want to manually disable again.
## Usage
Start obs-scene-switcher:
```bash
obs-scene-switcher -config scenes.toml
```