Skip to content

Configuring Chapter Marker Manager Companion ​

by Andi ​

Version: 1.0.6DLLStreamerbot Import

Mark the moment from chat, a cheer or a Stream Deck key, without touching OBS. This drives the StreamUP Chapter Marker Manager OBS plugin from Streamer.Bot, and sends every marker to your Twitch VOD at the same time.

πŸ›’ View on StreamUP Shop

πŸ’‘General Notice

This guide assumes you have the latest StreamUP DLL installed. All required plugins, including the StreamUP plugin, and Streamer.Bot should be up to date. It also assumes you have already imported any fonts, OBS scenes or Browser Sources and Streamer.Bot import files.

Please make sure you have followed the standard product installation steps for StreamUP products.

If you haven't and where appropriate please follow these specifically:

Some steps are accompanied by images, you can click on these images to make them bigger. Where appropriate they have been tagged with Numbers, you can find the corresponding number in brackets (X)

πŸ’‘This one has no .StreamUP file

This product is controlled entirely inside Streamer.Bot, so there is no OBS import. You do still need the StreamUP Chapter Marker Manager plugin installed in OBS, because that is what actually writes the markers.

What this product does ​

  • Sends chapter markers to your Twitch VOD whenever a marker is set in OBS
  • Adds chapter markers to the OBS plugin, and to your Twitch VOD, from any trigger
  • Adds annotations to the OBS plugin from any trigger
  • Reads the current chapter marker name back into Streamer.Bot

Prerequisites ​

Enable the commands

This product ships with chat commands, and they are disabled on import. After importing, go to Commands, find the Chapter Marker Manager Companion category, right-click it and choose Enable All.

The actions ​

Three actions do the work. Everything else is an example you can copy or delete.

ActionWhat it doesArguments
CMMC β€’ Set Chapter MarkerAdds a marker in OBS and sends it to your Twitch VODchapterName, chapterSource
CMMC β€’ Set Chapter AnnotationAdds a timestamped note to the current chapterannotationText, annotationSource
CMMC β€’ Get Current Chapter MarkerReturns the current chapter name as %currentChapter%none

Both name fields accept any Streamer.Bot variable, so a marker can carry who triggered it, the game you are on, or anything else you can reach.

Set a chapter marker ​

There is a built-in example that lets moderators add a marker with !marker. To build your own trigger:

  1. Create a new action and set a trigger.
  2. Add 2 new Sub-Actions. Choose Core β†’ Arguments β†’ Set Argument. (1)

Set Argument sub-action

  1. Set the following arguments. You can use any variables in the Value box.

    chapterName

    Setting the chapterName argument

    chapterSource

    Setting the chapterSource argument

  2. Add a new Sub-Action. Choose Core β†’ Actions β†’ Run Action.

  3. Choose CMMC β€’ Set Chapter Marker and leave Run Action Immediately checked.

Running the Set Chapter Marker action

When the action fires it adds a chapter marker in OBS, ready to be exported with your recording, and sends it to your Twitch VOD.

Set a chapter annotation ​

An annotation is the longer note attached to the current chapter. There is a built-in example for moderators using !annotation. To build your own:

  1. Create a new action and set a trigger. This example uses a Twitch Cheer.

  2. Add 2 new Sub-Actions. Choose Core β†’ Arguments β†’ Set Argument.

  3. Set the following arguments.

    annotationText

    Setting the annotationText argument

    annotationSource

    Setting the annotationSource argument

  4. Add a new Sub-Action. Choose Core β†’ Actions β†’ Run Action.

  5. Choose CMMC β€’ Set Chapter Annotation and leave Run Action Immediately checked.

When the action fires it adds an annotation in OBS, to be exported with your recording's chapter marker file.

Get the current chapter marker ​

  1. Create a new action and set a trigger.
  2. Add a new Sub-Action. Choose Core β†’ Actions β†’ Run Action.

Adding the Run Action sub-action

  1. Choose CMMC β€’ Get Current Chapter Marker and leave Run Action Immediately checked.

Choosing the Get Current Chapter Marker action

  1. Use %currentChapter% anywhere later in the action to get the current chapter marker name.

Using the currentChapter variable

Settings ​

Open the settings by going to the CMMC β€’ Settings action, right-clicking the Test trigger, then pressing Test Trigger.

Reset restores the defaults, Save keeps your changes, and Cancel closes without saving.

General ​

The General settings tab

  • OBS Connection Number: the number next to your OBS connection in Streamer.Bot, under Stream Apps β†’ OBS. 0 is the default connection.
  • Send chapter marker to Twitch VOD: ticked sends every marker to your Twitch VOD as well as OBS.

Messages ​

The Messages settings tab

  • Send messages to Twitch / YouTube chat: whether the product announces what it did in chat.
  • Send messages from your bot account: send those messages as your bot rather than you.
  • Default Chapter Name: used when no name is set. Default Chapter.
  • Default Chapter Source: used when no source is set. Default Streamer.Bot.
  • Default Annotation Source: used when no annotation source is set. Default Streamer.Bot.

The message templates take variables:

MessageTemplateVariables
Get Chapter MarkerThe current chapter marker in the recording is: [%chapterName%]%chapterName%
Set Chapter MarkerChapter marker added: [%chapterName%] - [%chapterSource%]%chapterName%, %chapterSource%
Set Chapter Annotation%annotationSource% added an annotation to chapter: [%chapterName%]%chapterName%, %annotationSource%

Built-in examples ​

Three examples ship with the product, switched off until you want them:

  • !marker for moderators, so anyone on your mod team can mark a moment
  • !annotation for moderators, for the longer note
  • A Twitch cheer over an amount you choose, so a cheer marks its own moment

They are ordinary Streamer.Bot actions. Open one, see how it is wired, and copy the shape for your own trigger.

Troubleshooting ​

  • Nothing happens when I test: check Streamer.Bot is connected to OBS, and that the OBS Connection Number in settings matches the one in Stream Apps β†’ OBS.
  • Markers appear in OBS but not on the VOD: tick Send chapter marker to Twitch VOD in the General tab.
  • The chat command does nothing: the commands are disabled on import. Enable the category under Commands.
  • Markers are all called Chapter: nothing set chapterName, so the default was used. Check the Set Argument sub-action runs before the Run Action sub-action.

Support ​

If you get stuck, ask in Discord and include:

  • Product version
  • Streamer.Bot version
  • StreamUP DLL version
  • Which step you are stuck on