OBSControl |

A Beat Saber mod to automatically start/stop recording in OBS when you play a song.

Installation

• OBS
  • Requires the OBS-Websocket OBS plugin.
    • OBS v28 requires the OBS-Websocket 4.9.1-compat plugin
    • OBS v27 requires the OBS-Websocket 4.9.1 plugin
  • You should have something like this in OBS:
  • If OBS is running on the same PC as Beat Saber, you would use ws://127.0.0.1:4444 (default) as the ServerAddress in Beat Saber\UserData\OBSControl.json.
• Beat Saber
  • Extract the release zip from the Releases page to your Beat Saber folder. OBSControl.dll should end up in your Beat Saber\Plugins folder.
  • You should see OBSControl in the Mod Settings menu if you installed it correctly.

Configuration

Settings can be found in-game in the Mod Settings > OBSControl menu.

• Enabled: Check to have OBSControl automatically start/stop recording.
• ServerAddress: The address of your OBS websocket server (in the form of ws://ip:port). This doesn't usually need to be changed.
• ServerPassword: If you set a password in OBS Websocket, enter it here.
• LevelStartDelay: Amount of time in seconds to delay the start of the level. When the Play button is clicked, OBS will start recording for this amount of time before the level actually starts.
• RecordingStopDelay: Amount of time in seconds to wait after the end of a level before stopping the recording or switching to the End Scene.
• Scene Settings
  • GameSceneName: Set the name of the OBS scene you want to use for gameplay footage, leave blank to disable scene switching.
  • StartSceneName: Name of the OBS scene to use as an intro for your videos. You must have a valid GameSceneName set to use this option.
  • StartSceneDuration: Amount of time in seconds to show the Start Scene before switching to the Game Scene.
  • EndSceneName: Name of the OBS scene to use as an outro for your videos. This scene is shown after RecordingStopDelay has finished. You must have a valid GameSceneName set to use this option.
  • EndSceneDuration: Amount of time in seconds to show the End Scene before stopping the recording.
• Advanced (Available only by editing OBSControl.json in your Beat Saber\UserData folder)
  • RecordingFileFormat: Defines how the file will be renamed after the recording stops.
    • Substitution characters are prefixed with ?
    • Optional groups are bounded by < >
      • The group is only shown if one or more of the substitutions inside the group are not empty strings.
        • Example: The format VideoFile<_I_Got_A_?F> will be VideoFile_I_Got_A_FC if you get a full combo or VideoFile if you don't.
    • Optional parameters: Some substitutions can have additional parameters inside { }. For example, the format ?@{yyyyMMddHHmm} would rename the file to 202005050807.mkv on 05/05/2020 8:07 AM.

Availble Substitutions:

Song Data:

Completion Results Data: