EDMC PVP Bot OBS Bridge¶

The EDMC Plugin, as of Version 1.4.0 supports integrating with a locally running OBS instance using the WebSocket Server that can be enabled on newer Versions (v28+). With this integration, you can automatically clip on kills, deaths and on command using a user-defined text command. Additionally, for clips triggered by kills and deaths you can further trim and rename them based on the kill specifics.

Prerequisites¶

• EDMC_PvP_Bot and Version 1.4.0 or higher

  Get it here. Click on the blue "Download | Release" image / button.

• OBS on Version 28 or higher

  Get it here or here

• ffmpeg to be accessible to EDMC / installed on the System (optional, needed for clip trimming only).

  Get it here and ensure it's on the $PATH.

  ffmpeg on Windows (click to open)

  Its easiest to install ffmpeg not from the official site, but from a repackage:

  Search for the wt program on Windows and start it, then paste and run:

  winget install Gyan.FFmpeg
  

  This will install ffmpeg and put it on the $PATH (making it discoverable to EDMC).

  You can verify by closing and re-opening wt and running

  ffmpeg -version
  

OBS Setup¶

Enable Replay Buffer¶

Under the hood, all the plugin does it trigger the Save Replay Buffer command on OBS. For Replay Buffers to work, you need to ensure they are enabled and have enough RAM assigned.

With OBS open, select File > Settings in the top left of the window.

In the settings, select the Output Tab on the left.

The next step depends on your output mode. Select the relevant tab for you:

Closing the Settings.

Enable WebSocket Server¶

Again from the system bar (top left), select Tools > WebSocket Server Settings

Ensure Plugin Settings > Enable WebSocket server is enabled.

Ensure a Server Port is set (the default 4455 is fine), enable authentication and click Generate Password.

You get the Password by clicking Show Connect Info.

It should look something like this:

Click Apply. You can keep this window open for the next step.

Configure the EDMC Plugin¶

Basic¶

Start EDMC, head to the Settings, find the EDMC_PvP_Bot Tab, followed by the OBS Bridge Subtab.

• Enable Enable OBS Bridge
• Set the Port if youre using a different one
• Set the Websocket Password

Without changing anything else, your clips get automatically clipped. If that's all you care about, you can stop reading here.

Move and Rename Clips¶

For Kills and Deaths, the Plugin already has a lot of context about the clip that is being saved, making it a sensible candidate for autorenaming clips to give them context about the killer and victim, the time and the location.

To get renaming to work, you must first decide about a Clip Storage Location. Select a folder here, preferably not the one that OBS uses for its clips. If you leave this empty, the feature will not work

Under Clip Naming Format you get to pick what the file name should be.

You get the following variables exposed. You reference a variable by putting it into curly braces.

E.g. killer gets referenced as {killer} in the input string.

Examples¶

Feel free to just copy paste or adjust any of these examples:

{date_yyyy_mm_dd}/{killer_NO_SPACE}-{victim_NO_SPACE}-{system_name_NO_SPACE}

{system_name_NO_SPACE}/{date_yyyy_mm_dd}/{killer_NO_SPACE}-{victim_NO_SPACE}

{self_ship}/{date_rfc3339}

{other_party_NO_SPACE}/{date_yyyy_mm_dd}/{system_name_NO_SPACE}/{self_ship}-vs-{other_party_ship}

Variable Reference¶

Template Rules¶

• Subpaths are allows. Use forward slashes, even on Windows
• Escaping Clip Storage Location is forbidden. If you use relative paths and absolute paths that cause the effective path to be resolved outside the configured Clip Storage Location, the move / rename will be aborted
• No file extensions. You template should not define a file extension. The extension from the source file is taken and appended.
• Name collisions are handled. If you use something like {killer}-{victim}, this will cause the first file to be named killerName-victimName.mp4. Subsequent collisions enumerate at the end: killerName-victimName_2.mp4, killerName-victimName_3.mp4, etc.

Autotrim¶

If you declared a storage location, trimming can be used. This will trim the clip based on the last time you dropped from SC.

Using Offset the Checkpoint you can adjust the clip start. Using a negative value makes the clip longer (you keep the SC drop), using a positive makes it shorter (you miss part of the drop.) The values are in milliseconds, hence -2000 starts the clip 2 seconds earlier.