2025-06-27 12:38:35 +01:00
2025-06-25 17:37:32 +01:00
2025-06-29 16:56:49 +01:00
2025-06-25 14:38:54 +01:00
2025-06-25 17:37:32 +01:00
2025-06-25 17:27:11 +01:00
2025-06-30 07:04:33 +01:00

simple-recorder

pdm-managed Ruff

A simple OBS recorder app. Run it as a CLI or a GUI.


Requirements

Installation

with uv

uv tool install simple-recorder

with pipx

pipx install simple-recorder

with pyz

Finally run the pyz with python (CLI)/pythonw (GUI):

python simple-recorder.pyz <subcommand>

pythonw simple-recorder.pyz

note, the pyz extension won't be required if you followed the optional step and made it discoverable.

Configuration

Pass --host, --port and --password as flags on the root command:

simple-recorder --host=localhost --port=4455 --password=<websocket password> --help

Or load them from your environment:

OBS_HOST=localhost
OBS_PORT=4455
OBS_PASSWORD=<websocket password>
OBS_THEME=Reds

Use

CLI

To launch the CLI:

simple-recorder start "File Name"

simple-recorder stop

Commands:

Usage: simple-recorder [OPTIONS] COMMAND

┏━ Subcommands ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ start      Start recording                                                        ┃
┃ stop       Stop recording                                                         ┃
┃ pause      Pause recording                                                        ┃
┃ resume     Resume recording                                                       ┃
┃ directory  Get or set the recording directory                                     ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

┏━ Options ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ --host <HOST>          OBS WebSocket host                                         ┃
┃ --port <PORT>          OBS WebSocket port                                         ┃
┃ --password <PASSWORD>  OBS WebSocket password                                     ┃
┃ --theme <THEME>        GUI theme (Light Purple, Neutral Blue, Reds, Sandy Beach,  ┃
┃                        Kayak, Light Blue 2)                                       ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

GUI

To launch the GUI:

simple-recorder-gui

simple-recorder

Just enter the filename and click Start.

Themes

You can change the colour theme with the --theme option:

simple-recorder-gui --theme="Light Purple"
Description
A single purpose application for naming file recording in OBS.
Readme 525 KiB
Languages
Python 100%