slobs-cli/README.md

slobs-cli

A command line interface for Streamlabs Desktop

For an outline of past/future changes refer to: CHANGELOG

---

Table of Contents

• Installation
• Configuration
• Commands
• License

Requirements

• Python 3.12 or greater
• Streamlabs Desktop

Installation

with uv

uv tool install slobs-cli

with pipx

pipx install slobs-cli

The CLI should now be discoverable as slobs-cli

Configuration

Flags

• --domain/-d: Streamlabs client domain
• --port/-p Streamlabs client port
• --token/-t: Remote Control API Token

Pass --domain, --port and --password as flags on the root command, for example:

slobs-cli --domain localhost --port 59650 --token <websocket password> --help

Environment Variables

Load the following values from your environment:

SLOBS_DOMAIN=localhost
SLOBS_PORT=59650
SLOBS_TOKEN=<API Token>

Flags can be used to override environment variables.

Commands

Scene

• list: List all available scenes.

slobs-cli scene list

• current: Show the currently active scene.

slobs-cli scene current

• switch: Switch to a scene by its name.

  • flags:

    optional

    • --preview: Switch the preview scene only.

  • args: <scene_name>

slobs-cli scene switch "slobs-test-scene-1"

Stream

• start: Start the stream.

slobs-cli stream start

• status: Get the current stream status.

slobs-cli stream start

• stop: Stop the stream.

slobs-cli stream stop

• toggle: Toggle the stream status.

slobs-cli stream toggle

Record

• start Start recording.

slobs-cli record start

• status Get recording status.

slobs-cli record status

• stop Stop recording.

slobs-cli record stop

• toggle Toggle recording status.

slobs-cli record status

Audio

• list: List all audio sources.

slobs-cli audio list

• mute: Mute an audio source by name.
  • args: <source_name>

slobs-cli audio list

• unmute: Unmute an audio source by name.
  • args: <source_name>

slobs-cli audio list

• toggle: Toggle mute state of an audio source by name.
  • args: <source_name>

slobs-cli audio list

Replay Buffer

• start Start the replay buffer.

slobs-cli replaybuffer start

• stop: Stop the replay buffer.

slobs-cli replaybuffer stop

• status: Get the current status of the replay buffer.

slobs-cli replaybuffer status

• save: Save the current replay buffer.

slobs-cli replaybuffer save

Studio Mode

• enable: Enable studio mode.

slobs-cli studiomode enable

• disable: Disable studio mode.

slobs-cli studiomode disable

• toggle: Toggle studio mode.

slobs-cli studiomode toggle

• status: Check the status of studio mode.

slobs-cli studiomode status

• force-transition: Force a transition in studio mode.

slobs-cli studiomode force-transition