Extensions are small programs that add features and expands XSplit Broadcaster’s capabilities.

You’ll be able to access them via Extensions menu on XSplit Broadcaster.

If any of the extensions listed here do not appear under the Extensions menu, go to Add Extension, then Find more extensions to launch the Plugin Store.

I. Macros

II. Per Scene Audio

III. Presentation Packager

IV. OBS Scene Importer


Macros

The Macros extension allows you to automate actions for your presentation – such as scene switching or showing/hiding sources through a keypress and even starting your broadcast or recording during a set time.

You’ll be able to access it by going to Extensions then selecting Macros.

Creating Macros

1. Click the Add icon to create a new macro.

2. You can rename your macros by clicking the Pencil icon.

3. Select the Event that will trigger the macro from the drop-down menu. Additional drop-down menus will appear depending on your selected event.

4. Select an Action to perform from the drop-down menu. Additional drop-down menus will appear depending on your selected action.

5. Clicking Add Action or Add Condition will add another action or condition to the macro that will run after the previous one.

6. Once you’re done, click Enable Event Listener. This will make the extension continuously check if the event conditions are satisfied then execute the actions sequentially.

If your Event is set to On key press, we recommend disabling the event listener first before changing the hotkey assigned since it will automatically run the macro while changing it.

You can also swap the order of actions by dragging the label on top of another one.


For examples of how you can use macros, visit this blog post:
How to use Macros in XSplit Broadcaster

Events

On key press

Triggers the macro when the key or mouse click combination set is pressed similar to Hotkeys.

Every interval

Triggers the macro at every time interval set in milliseconds.

On scheduled time

Triggers the macro at the set hour.

On scene switch

Triggers the macro when the selected scene becomes active.

When a stream source goes online/offline

Triggers the macro when the selected stream source in a scene goes online or offline. Works with RTMP, RTSP and NDI stream sources.

When a media source stops

Triggers the macro when a specific media source stops.

Custom Script

See the Custom Script section below.


Actions

Wait

Waits for a time interval before going to the next action.

Start/stop broadcast

Starts or stops one of your streaming outputs, Local Streaming or Local Recording.

Switch to scene

Switches to a specific scene in your presentation.

Set scene transition

Sets a specific scene’s transition. Also supports Stingers.

Set source visibility

Shows, hides or toggles the visibility of a specific source from a chosen scene. Note that source transitions are also triggered when a source is shown or hidden.

Set media source playback state

Plays, pauses or stops a specific media source. Works on both video and audio media sources.

Set source audio state

Mute or unmute a source’s audio output.

Run macro

Runs a different macro.

Stop macro

Stops a different macro.

Enable/Disable macro listener

Enable or disable another macro’s event listener.

Go to action

Go to another action in the same macro. Currently does not work with all available actions.

Custom Script

See Custom Script section below.

Custom Scripts

The Custom Script functionality for the Macros extension are still being changed and improved so documentation and guidelines for them are a work in progress. For now, you can experiment on modifying existing events and actions by clicking the to copy their scripts to the clipboard and pasting them to a custom script action.


Per Scene Audio

This extension allows you to create scene-specific audio profiles for your presentation. You can adjust the microphone and system audio level for each scene.

You’ll be able to access it by going to Extensions then selecting Per Scene Audio.

Use the Scene Selector drop-down to Add that you want to manage the audio. Each scene added will have their own system sound and microphone volume level adjustments. Scenes that you don’t add will use the audio levels set in Default.

If you have the volume range range set above 100% in your Audio Settings, it will also reflect here.

Sync volume adjustment across scenes
Enable this to have the volume levels for all scenes added (including Default) automatically match any volume adjustment done.


Enable scene crossfade
Enable this to have a crossfade effect when switching from one scene to another, making transitions for audio volume between scenes smoother.


Presentation Packager

Presentation Packager allows you to save your XSplit presentation into a self-contained file which also contains the corresponding directory for each source. This is great for portability and easier sharing of your presentation to other users.

You'll be able to access it by going to Extensions then selecting Presentation Packager.

Exporting Presentations

1. Click Save As….

Enabling Export as BPZip presentation will put the presentation files into a single compressed BPZip file . Otherwise, it will be exported as a BPres file along with a folder containing all the files used by the presentation.

2. Choose the filename and destination folder then click Save.

3. Check if all the details such as the filename and destination are correct. You can also click on Validate File Integrity to make sure that all the files used as sources can be loaded and exported. Once all details are correct, click on Export.

4. When confirmation that the export has been completed successfully is shown, you'll be able to find the BPres or BPzip file in the destination folder you chose earlier.

Loading .BPres and .BPZip Presentations

1. To load your exported .BPres files, go to File > Load Presentation….

Make sure that the .BPres file and the folder with all the presentation assets are in the same directory and have not been renamed.


2. The .BPZip files generated from the Presentation Packager can be loaded the same way through the File menu but will have to be extracted first. This window will be shown to let you choose which folder to extract the presentation's files to:


OBS Scene Importer

The OBS Scene Importer allows you to import a scene collection from OBS Studio into XSplit Broadcaster for an easy and streamlined way to transition between the two applications.

You will have to export your scene collections on OBS Studio first by going to Scene Collection > Export then saving the JSON file.

Importing OBS Scenes

1. Go to Extensions > OBS Scene Importer.


If OBS Scene Importer is not shown in the Extensions menu, you will have to install the extension plugin first through Extensions > Add extensions > Find more extensions.

2. Click then browse and select your exported OBS Scene Collection JSON file.

3. Click Import to continue.

4. Before a new presentation is created from the scene collection you imported, you will be prompted if you want to save your current presentation.

A log file will also be generated in your XSplit logs folder after importing.

Supported Source Types

SOURCE

SUPPORTED PROPERTIES

NOTES

Image

• Image File Path

Properties dialog will notify you if image is missing on import.

Audio Input

• Selected Device

No Device will be shown if device is not available. Refresh source if device is plugged in and available.

Browser

• URL
• Local File
• Width
• Height
• Custom CSS
• Refresh Browser when scene becomes active

Custom resolution will be the width and height set in OBS.

Color Source

• Color
• Width
• Height

Display Capture

• Display
• Capture Cursor

Game Capture

• Window
• Capture Cursor

Image Slideshow

• Image Files
• Transition
• Loop
• Time Between Slides

Media Source

• Local File
• Loop
• Show nothing when playback ends.

Scene Source

Text Source

• Text
• Color
• Opacity
• Font
• Alignment
• Outline

Imported values for sizes will be approximations.

Video Capture Device

• Device
• Resolution

No Device will be shown if device is not available. Refresh source if device is plugged in and available.

Window Capture

• Window Value
• Capture Cursor

Supported General Source Properties

The following properties will be imported for sources:Z

Position, Order, Scale, Flip, Rotate¹ and Volume.

Linked Sources and Groups are also supported for import.

¹ Positioning will be different for Rotate values not in multiples of 90°.


Supported Effect Filters

While OBS Studio supports applying the same effect filter to a single source multiple times, only the latest effect filter of a specific type will be imported using the extension. The only exception is the Crop/Pad effect filter.

FILTER

SUPPORTED PROPERTIES

NOTES

Crop / Pad

• Left
• Top
• Right
• Bottom

Position and size may be a little off due to framework differences in crop handling.

Color Correction

• Opacity
• Saturation
• Contrast
• Brightness
• Hue

Color Key / Chroma Key

• Key Color Type
• Similarity (Threshold)

Red, Green and Blue chroma key options will be imported. Custom chroma key filters is not supported.

Image Mask

• File path

Scaling / Aspect Ratio

• Resolution

Resolution values will be imported as width and height values.


Did this answer your question?