Script was tested only on Windows 11, but it allegedly works on other OSes as well

‼️Script only works with OBS in version 29.0.0 or higher‼️

What does this script does?

To put it simply, it tries to mimic the recordings organization of NVIDIA Shadow Play.

Once configured - you don't have to worry about anything. From now on your recordings/replays/screenshots will be automatically sorted for you.

Tested only on 3.11.4, but it might work on other versions as long as there are no big changes!

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:

  IMPORTANT:

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