What does this script does?

The script recreates the recordings organization of NVIDIA Shadow Play.
Once configured - your recordings/replays/screenshots will be automatically sorted.

Table of Content

• What does this script does?
• Features of the script
• What do I need to do to make it work?
• FAQ

Requirements

Note

This script is designed for ease of use and should work on all Operating Systems

• Script only works with OBS in version 29.0.0 or higher
• Script requires only a Python 3.11 version or higher (3.12 is the highest the OBS 31.0.3 supports for now)
  • No need for tkinter or anything additionally, minimal python works

Features of the script

In case of fullscreen applications/ hooked windows (mentioned as it below):

• Moves recordings to a folder named after it
• Moves replay buffer recordings to folders named after it
• Moves screenshots to folders named after it
• When automatic splitting is enabled, it will also actively move all the split recordings to relevant folder as in recordings case

Other features:

• Verbose logs of the script - you should be able to see the important information on the go when viewing Script Logs

If the Game Capture or Window Capture is not hooked to any app, it will organize saved recording/replay buffer in a folder called "Manual Recording"

What do I need to do to make it work?

First things first!

1. You need Python - a version 3.11 will probably work the best, but you can use newer.

   You might need the version within 3.11 for best compatibility

2. Next you need to configure the Python - it's located under Tools > Scripts > Python Settings inside of OBS.

   Select the root folder of where the Python resides, it should be called something like Python311

3. You are half way there, next you need to add the script in the Tools > Scripts

   Click the "+" button and select the Python script I created.

   For simplicity, you can place the script in location where you installed your OBS, here's the relative path: obs-studio\data\obs-plugins\frontend-tools\scripts

4. Configure the script in a way you see fit

   Explanation for parts of the settings:

   • "Add name of the game as a recording prefix" checkbox - if you want your recordings to look like this:
     • Voices of The Void - %Filename Formatting%
     • Filename Formatting is configured in Settings > Advanced > Recording
   • "Recordings folder"
     • Select a directory where OBS saves your recordings to, it will allow the script to organize them for you ;)
   • "Recording extension"
     • Write here extension of your recordings (the "mkv" is set default to showcase how to write the extension and because it's recommended one for now)
     • Useful discussion to understand why use MKV instead of other containers for now
   • "Screenshot extension"
     • Write here extension of your screenshots saved by OBS as (the "png" is set default to showcase how to write the extension, a default one for non-HDR screenshots)

FAQ

RecORDER doesn't see my Game Capture/Window Capture source and shows "Nothing was found... Did you name your source in different way than in the 'sourceNames' array?" in script log

It's probably happening because you changed the Game Capture/Window Capture source default name to something else.
The message shows only when the script checked the names in "sourceNames" and found no match with the sources in your scene.
Check if you have put your sources into the array before resetting the script using refresh button and trying again!

How should I edit the "sourceNames" when I have no idea how should I put it in the script?

No worries about that, it's not really hard to do because you have the example already in the script and here below

EXAMPLE:

You have a source that you use for recording game "Voices of the Void", so you called the Game Capture source "voice_of_the_void", where you have all the filters you need to make your recording look as good as it can for you.
Because you called it different from the "Game Capture", the script does not recognize it!

All you need to do is go to the Scripts menu

Then, after clicking the "Edit Script" button, you will have to find this part of code

In here you can put how many source names that you are actually using in your workflow
Be aware that the script might need to take longer to find the right source the more source names you add, so do try to keep the difference to the necessary minimum

Example of the sourceNames array:

sourceNames = ["voice_of_the_void", "jc", "sc"]

Make sure it's matching with whatever you have in this little window of your main OBS window:

IF YOU HAVE MORE THAN ONE GAME CAPTURE/ WINDOW CAPTURE SOURCE, MAKE THE CURRENT ONE YOU ARE USING THE HIGHEST ON THE LIST!