Skip to content

Playlist Building / Content

Add Input

When you click the Add Input button, a context menu appears with the following options:

  • Add vMix Input: Adds an item that targets and plays a specific input in vMix. The item matches an input by its title or input number. You must specify a duration for playback. If the title does not match any vMix input, this item can be used to delay the playlist. To edit the duration and title see Editing Items / Attributes for details

  • Add Media: Allows you to add media files to the playlist. See Supported Media Types for details. You can also select a saved project file with the .tsk extension; this will import all content from that project into the current playlist.

  • Add Transparent Image: Inserts a transparent image item into the playlist.

Note: For vMix Input items to work, ensure you have selected API Output as your playback output see Streaming / Output for details

Drag and Drop Media

You can also drag and drop files directly into the playlist. When you do, you will be prompted with the following options:

  • Insert: Adds the item after the target row where the cursor is pointing.
  • Replace: Replaces the item under the cursor.
  • Replace Instance: Replaces all instances of the item under the cursor.

Add Command

When you click the Add Command button, a context menu appears with the following options:

  • vMix Function: Adds a command to execute a vMix function during playlist playback.
    Double-click the Type column to open the property window, where you can adjust the vMix function. The properties allow you to select a function from the list of vMix functions and provide extra fields for entering values for the selected function (see the vMix documentation for available functions).

  • vTask SwitcherFunction: Adds a command to toggle the visibility of elements in the currently loaded Kente graphic, or swap the z-index of each element. In the property window, you can select either the SwitchOverlay or SetLayer function from the Kente category in the function dropdown. The input field must match the name of the output graphic element from Kente. See vTask Integration in Kente for details

Note: With both options above, you can click the Add button in the property window to add multiple functions, which will be executed at the same time, or specify a delay by entering a delay amount in milliseconds in the Delay field of each function.

To use the vTask SwitcherFunction a node graph must have been loaded using the vTask LoaderFunction or manually through the kente editor

  • vTask LoaderFunction: Adds a command to load a project file (.tsk) or a node graph graphics file (.kente or .graph).
    Click the Browse button to select a file to load at any point in the playlist. If you load a .tsk project file, the current playlist will be cleared and replaced with the selected project when this item is played. If the Schedule checkbox is unchecked, the loaded project's timing resets to the current time and starts playing automatically; if checked, it loads in scheduled mode and waits for the next scheduled time.
    When a graphics file is selected, the corresponding Kente graphic is loaded and set as the active graphic for the Kente switchboard, displaying its output ports on the switchboard.
    See vTask Integration in Kente for details.

vTask CGFunction

This function is timer-based and controls a single XAML titler in vMix. It can dynamically update the content of the titler and toggle its visibility a specified number of times and intervals during video playback. For example, on a music video channel, it can display the title of the currently playing music, the upcoming track, and repeat the process whenever a new item is played.

The CGFunction property window includes the following fields:

  • Activate CG: When checked, the CG function's timer is activated.
  • Xaml Tile: The name of the titler to use in vMix (e.g., myTitler.xaml).
  • Message: A dropdown listing all column names of the currently playing item. This selects the text to send to the titler (e.g., choosing "Title" will display the title of the current, upcoming, and later items).
  • Initial Delay: The time in milliseconds to wait after a new item is played before activating the function.
  • Intervals: The interval in milliseconds that determines how long before changing the content of the title (e.g., switching between "now playing" and "upcoming").
  • Repeat: The number of times to toggle the titler on/off during the duration of the current playing video.
  • NowPrefix: Text that appears before the "now playing" message.
  • NextPrefix: Text that appears before the "upcoming" message.
  • LaterPrefix: Text that appears before the "later" message.
  • Separate Prefix: When checked, the prefix appears on the first line and the message on the second line; otherwise, the prefix and message are concatenated on a single line.
  • Trigger: A dropdown to select which overlay input to use for toggling the titler on.

These fields allow you to customize how and when the titler displays information during playlist playback.

Note:
Once the CG function is activated, its settings are applied throughout the playlist whenever any video plays.
To stop the CG function, add another CG function command later in the playlist and uncheck "Activate CG".

Add Transition

This option inserts a transition command into the playlist.
Double-click the Type column to open the property window, where you can adjust the duration of the transition using the Trim Out field and select the transition type from the Transition dropdown.

Note:
Once a transition item is played, all subsequent video items will use the same transition until another transition item further down the playlist is played.
Transitions only work when API Output is selected as the playback output for vMix. See Streaming / Output for details.

Add Program

When you click the Add Program button, you will be prompted to enter a name for the program. This action inserts a new item into the playlist, which acts as a nested playlist. Double-clicking the Type column for this item opens a mini playlist editor, allowing you to arrange items within the program just like in the main playlist.

You do not need to manually save inside the mini editor, closing it will automatically save your changes. For best results, save your main playlist instead, which ensures all programs are saved correctly.

Each program you add is saved as a separate .tsk project file in a folder within the main project directory. To reuse a program, you can duplicate it, this will generate a duplicate name and a new file. If you use the same name for two programs, they will share the same file: any changes made to the playlist in one instance will be reflected in all instances. Similarly, if you delete either instance from the main playlist, the content of all instances with that name will be lost.

This feature is useful for organizing groups of items, such as commercial breaks or recurring segments, and reusing them multiple times within your main playlist.

Add Loop

Clicking the Add Loop button prompts you to enter two fields: From Row and Count. Both must be integers.

  • From Row: Specifies the item number in the playlist to jump to when the loop item is played.
  • Count: Determines how many times to repeat this jump before moving to the next item below the loop.

The current loop state is displayed in the Title column of the loop item, showing {Loop From Row:0:For:11:Times} (with your input values). This state updates each time the loop item is played, decrementing the count until it reads {Loop From Row:0:For:0:Times}. When the count reaches zero, playback continues with the next item below the loop.

You can reset or change the loop by double-clicking the Type column of the loop item and updating the From Row or Count values in the property window.