A lightweight OBS script that automatically organizes recordings, replays, and screenshots into folders named after the current scene.
Find a file
2025-10-08 10:32:30 -04:00
LICENSE remove remuxing feature and simplify codebase, the script now focuses 2025-07-27 07:06:44 -04:00
OBSReplay.lua add support for current window name instead of scene 2025-10-08 10:32:30 -04:00
README.md remove remuxing feature and simplify codebase, the script now focuses 2025-07-27 07:06:44 -04:00

OBSReplay

⚠️ LINUX ONLY - This script only works on Linux systems.

Simple OBS script that automatically moves your recordings, replays, and screenshots into folders based on your current scene name.

What it does

  • When you save a recording/replay or take a screenshot, it gets moved to a folder named after your current scene
  • No more messy downloads folder - everything is organized automatically!

How to install

  1. Download the OBSReplay.lua file
  2. Open OBS Studio
  3. Go to ToolsScripts
  4. Click the + button and select the OBSReplay.lua file

How to set it up

  1. In the Scripts window, find "OBSReplay" in the list
  2. Set the Output Path to where you want your organized files (like /home/yourname/Videos/OBS)
  3. Optionally enable desktop notifications to see when files are moved
  4. Click "Close"

Example

If your scene is called "Gaming" and you save a replay, it will be moved to:

/home/yourname/Videos/OBS/Gaming/replay.mkv

Settings

  • Output Path: Where to organize your files (required)
  • Enable Desktop Notifications: Get popup notifications when files are moved
  • Restart Replay Buffer After Save: Automatically restart replay buffer after saving

Requirements

  • Linux operating system
  • OBS Studio

License

BSD 3-Clause


Code Stats