Recording Organizer
Automatically organize your OBS recordings by game/application name
What does it do?
This Lua script automatically sorts your finished recordings into subdirectories based on which window or application you're capturing. No more digging through hundreds of files - your recordings are organized by game/app name automatically!
Example:
Features
Quick Start
Installation (30 seconds):
Verify it's working:
Platform Support
Windows: Window Capture, Game Capture ✅
Linux: XComposite ✅
macOS: Screen Capture ✅
macOS Users: Set your Screen Capture source to "Application" mode (not Window or Display) for automatic app name detection. Or simply rename your source to match what you're recording!
Configuration
Optional settings in script properties:
Split Recording Support
Got long recordings that auto-split? No problem!
The script automatically tracks all split segments in real-time and moves them together when you stop recording. Works with any split size/time setting.
Example: Recording splits into 3 files (50MB each) → All 3 files moved to the same organized folder automatically.
Troubleshooting
Recordings go to "Unknown" folder?
Script not working?
Download
GitHub: RaccoonCultSoftware/recording-organizer
Direct Download: recording_organizer.lua
License: MIT (free to use, modify, and distribute)
Author: Strychnine | @rabbitcannon | RaccoonCult.com
Made with ❤️ for the OBS community
Automatically organize your OBS recordings by game/application name
What does it do?
This Lua script automatically sorts your finished recordings into subdirectories based on which window or application you're capturing. No more digging through hundreds of files - your recordings are organized by game/app name automatically!
Example:
Code:
Recordings/
├── Elden Ring/
│ ├── 2025-10-05_16-30-45.mkv
│ └── 2025-10-05_17-15-22.mkv
├── Blender/
│ └── 2025-10-05_18-00-10.mkv
└── Google Chrome/
└── 2025-10-06_11-23-45.mkvFeatures
- Automatic Organization - Runs after each recording finishes
- Smart Name Detection - Extracts clean game/app names from your capture sources
- Split Recording Support - Automatically moves all split segments together
- Multi-Platform - Works on Windows, Linux, and macOS
- Zero Dependencies - Pure Lua, no Python or external tools needed
- Clean Folder Names - Removes junk like "UnrealWindow:", "-Win64-Shipping.exe", etc.
Quick Start
Installation (30 seconds):
- Download recording_organizer.lua
- Open OBS → Tools → Scripts
- Click + (Add Scripts)
- Select the .lua file
- Done! Your recordings are now automatically organized
Verify it's working:
- Make a short test recording
- Stop recording
- Click Script Log button - look for "Successfully moved recording"
- Your recording should be in a subdirectory named after your game/window
Platform Support
Windows: Window Capture, Game Capture ✅
Linux: XComposite ✅
macOS: Screen Capture ✅
macOS Users: Set your Screen Capture source to "Application" mode (not Window or Display) for automatic app name detection. Or simply rename your source to match what you're recording!
Configuration
Optional settings in script properties:
- Base Recordings Folder - Custom folder path (leave empty to use OBS default)
- Capture Source - Auto-detect (default) or choose a specific source
Split Recording Support
Got long recordings that auto-split? No problem!
The script automatically tracks all split segments in real-time and moves them together when you stop recording. Works with any split size/time setting.
Example: Recording splits into 3 files (50MB each) → All 3 files moved to the same organized folder automatically.
Troubleshooting
Recordings go to "Unknown" folder?
- Make sure you're using Window/Game Capture (not Display Capture)
- macOS: Set Screen Capture to "Application" mode
- Check Script Log to see what's being detected
- Manually select your capture source in script settings
Script not working?
- Check Script Log for errors
- Reload script with the refresh button
- Make sure you're using OBS 27.0 or higher
Download
GitHub: RaccoonCultSoftware/recording-organizer
Direct Download: recording_organizer.lua
License: MIT (free to use, modify, and distribute)
Author: Strychnine | @rabbitcannon | RaccoonCult.com
Made with ❤️ for the OBS community