obs-scripting

Write and load Python or Lua scripts to automate OBS Studio workflows.

15|4|Updated Apr 18, 2026

Search Tags:#automation #python #scaffolding #scripting #lua #obs-studio #frontend-events

Ready to run

npx skills add https://github.com/damionrashford/media-os --skill obs-scripting

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: obs-scripting
Source: https://github.com/damionrashford/media-os/tree/main/skills/obs-scripting
Command: npx skills add https://github.com/damionrashford/media-os --skill obs-scripting

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

OBS scripting enables automation inside OBS Studio by running Python or Lua scripts, allowing lifecycle management, event handling, and in-app UI construction without compiled plugins.

Core Features & Use Cases

Automate OBS workflows by writing scripts that respond to events (scene changes, streaming/recording) and manage sources and scenes.
Build small tooling UIs inside OBS for scene switching, hotkeys, and automated tasks using obspython/obslua.
Rapidly prototype OBS behaviors and workflows without C++ plugins, enabling per-install or per-project tooling.

Quick Start

Create a new OBS script using the included scaffold-script.py and load it via Tools → Scripts.

Frequently Asked Questions about obs-scripting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I automate scene changes in OBS Studio without compiling C++ plugins?▼

Automate OBS workflows by writing Python or Lua scripts that respond to frontend events like scene changes, streaming, and recording, managing sources and scenes without compiling C++ plugins.

What script lifecycle functions are available for OBS automation?▼

OBS scripting provides lifecycle functions including script_load, script_unload, script_tick, script_properties, script_defaults, script_update, and script_save to manage script behavior and state.

Can I build custom UI inside OBS for automated hotkeys and scene switching?▼

Build small tooling UIs inside OBS for scene switching and hotkeys using obspython or obslua, enabling automated tasks and per-project tooling directly within the application.

Does OBS scripting support both Python and Lua for frontend event handling?▼

OBS scripting supports both Python and Lua for handling frontend events and signals, allowing you to automate workflows based on streaming and recording triggers.

What is the best way to start writing an OBS script for automated task management?▼

Start by using the included scaffold-script.py and load it via Tools → Scripts in OBS Studio to rapidly prototype automated behaviors and per-source workflows.