MyCujoo LiveServices logo


Product & Features

Getting started


API Documentation


An annotation is a concept of tagging a single moment in time on a stream. For example, when a player scores a goal during a football match or the moment when a new speaker enters the stage during a keynote event.

Use the annotations section in the console to configure these annotations and tell MLS to perform specific actions each time an annotation is triggered.

For example, when a goal is scored during a football match, display the name of the player who scored the goal on top of the video player, increase the score on the scoreboard, and share a message on your social media platforms to entice your users to watch the match; all automated in real-time by an annotation.

Examples/Use cases

  • Display a message on a video stream at a specific time.

  • Add a visual indicator on the video timeline, that can be used by a viewer to jump to the specific time.

  • Create a 20 second video clip of a specific part in your stream.

  • Share a message on your social media accounts with a link to a specific moment on your stream.

  • Tag a keyword for analytical purposes in a specific moment on your stream.

How to use it

All individual annotations in MCLS belong to a specific set. These annotation sets can be set up in any configuration you require.

The annotations section in the console will list all your existing annotation sets, including an overview of the individual annotations in each set.

To create a new set, go to annotations in the console and click "Create annotation set."

Give your set a title, and click "Create annotation type" to get started with your annotation.

Give your annotation a descriptive title that will make it easy to distinguish from other annotations when tagging your live streams.

Time to add your first action. Actions are small tasks that when combined, provides the functionality for each annotation. The simplest way to familiarise yourself with actions is to click on "Add action" and browse through the available options. If you are new to MCLS, try one of the visual actions, like an overlay.

Next, you need to configure the actions' behaviour. The configuration can include but is not limited to content, style and technical settings.

Be sure to read the description of the action as it can contain valuable information and tips on how to set up the action.

Now that you've created your first annotation, you can create an event, stream it, and visit the "Annotation Manager" to test your newly created annotations. Note, to simulate the experience your users will have when streaming, you can place your embed code on a test page to see both your stream and the result of the annotations.