RecORDER is a Python script for OBS Studio designed to bring ShadowPlay-style automatic organization to your media.
It automatically sorts recordings, replays, and screenshots into folders called after captured windows/games, keeping your media clean and organized.
--------------------------------------------------
Features
--------------------------------------------------Automatic Folder Sorting
- Detects the game/window that OBS hooks into (Game Capture or Window Capture)
- Places each recording in a folder named after the application
- Works similarly to NVIDIA ShadowPlay’s folder structure
Replay & Screenshot Management
- Replay Buffer recordings and screenshots are placed in dedicated directories
Split Recording Support
- Automatically moves split segments to the correct folder when OBS splits files
Organization mode customization
- Decide which type of organization works best for you
- Basic - move files into respective folders
- Group by Date - Basic + move media into folders named after their creation date
Fallback Behavior
- If OBS cannot fetch title of hooked application (e.g., using Display Capture), files are sent to a generic folder called "Any Recording" or whatever user sets-up as a name
Check RecORDER updates in Scripts window
- Press the button to see if there's an update available!
--------------------------------------------------
Compatibility
--------------------------------------------------- OS: Windows 11 (tested), MacOS, Linux
- OBS Version: 29.0.0 or newer
--------------------------------------------------
Installation
--------------------------------------------------- Download
RecORDERvX-X.pyfrom the project repository - Open OBS → Tools → Scripts
- Click [+] and add
RecORDERvX-X.py - Configure script to your preferences
- Start recording — RecORDER handles sorting automatically
--------------------------------------------------
Limitations & Notes
--------------------------------------------------- Sorting only works with Game Capture or Window Capture sources
- Display Capture recordings go to the fallback folder
- Report issues via GitHub
--------------------------------------------------
Example Directory Structure
--------------------------------------------------
Code:
Videos/
├─ Apex Legends/
│ ├─ 2024-04-05 17-32-10.mp4
│ ├─ 2024-04-05 17-32-10-1.mp4 (split recording)
│ └─ Screenshots/
├─ Factorio/
└─ Manual Recording/
==================================================