OBS Remote Controller

Toggle OBS recordings with an input via evdev.

Installation

Install with pipx:

pipx install /path/to/obs-remote

Or from a git repository:

pipx install git+https://github.com/yourusername/obs-remote.git

Usage

obs-remote --code 317 --host localhost --port 4455 --password yourpassword

Arguments

• --code: Input event code (required, e.g., 317 for capture button on Xbox One Core controller)
• --host: OBS WebSocket host (default: localhost)
• --port: OBS WebSocket port (default: 4455)
• --password: OBS WebSocket password (default: empty)

Features

• Short press: Toggle recording
• Long press (1s): Launch/close OBS application
• Automatic device detection and monitoring
• WebSocket reconnection handling