Playlists
Where: sidebar → Content Management → Playlists
A playlist is a set of images that play in order; each image is called a "source". A playlist does not play by itself: a schedule starts it at a set time and sends it to the devices the schedule names.
Only Platform Administrators and System Operators see this page.
List columns
| Column | Description |
|---|---|
| "Name" | The playlist's name |
| "Loop" | "Loop": after the last image it goes back to the first; "Play Once": after the last image it stays on the last image |
| "Created At" | When it was created |
| "Actions" | "Edit" and a red delete icon |
Adding a playlist
- Click "Add Playlist" at the top right.
- Fill in the fields below and add sources (see Sources).
- Click "Save". Click "Cancel" to return to the list without saving.
| Field | Description |
|---|---|
| "Name" | Required |
| "Loop" | A switch, on by default. On = "Loop", off = "Play Once" |
| "Default Interval" | How long each image shows before the next one, in the format "hh:mm:ss". Used when a source has no "Interval (seconds)" of its own |
| "Duration" | The longest time images keep changing, counted from when the schedule starts, in the format "hh:mm:ss". When the time is up, images stop changing and the screen stays on the current one |
| "Valid From" | A date and time; see the note below |
| "Valid Until" | A date and time. After this time images stop changing and the screen stays on the current one. It must be later than "Valid From", otherwise "Valid Until must be after Valid From" appears |
"Default Interval", "Duration", "Valid From" and "Valid Until" can all be left empty.
"Valid From" currently has no effect on playback
Filling in "Valid From" does not delay playback: playback starts as soon as the schedule triggers, whether or not that time has been reached. This is a known issue; this page will be updated when it is fixed. To control when playback starts, use the trigger time of the schedule.
Sources
In the "Sources" section, click "Add Source" to add an image. Each source is a card:
| Field | Description |
|---|---|
| "Type" | "Content Library": use an image from My Gallery; "URL": download the image from a web address each time it plays |
| "Image" | Required when the type is "Content Library"; choose an image from the gallery (shown by file name) |
| "URL" | Required when the type is "URL"; enter the image's full web address |
| "Interval (seconds)" | How long this image shows before the next one, at least 1 second. When empty it shows "Inherit default", which means the playlist's "Default Interval" is used |
- Drag the handle icon on the left of a card to change the play order; images play from top to bottom.
- Click the red delete icon on the right of a card to remove that source.
URL sources
An image of type "URL" is downloaded only when its turn comes. If the address cannot be opened or is not an image, the image does not change this time, the device keeps its current screen, and the next image appears at the next interval.
How playback works
Each time a schedule triggers, the playlist starts from the first source and is sent to all devices the schedule names; after that, images change one by one at the set intervals. Every image change creates a new task in the Task List.
| Situation | Result |
|---|---|
| "Loop", after the last image | Goes back to the first image and continues |
| "Play Once", after the last image | Stays on the last image; no more changes |
| Only one source, and it is "Play Once" | Shows this image and does not change again |
| The source has no "Interval (seconds)" and the playlist has no "Default Interval" | Stays on this image until the schedule triggers again |
| "Duration" or "Valid Until" is reached | Images stop changing and the screen stays on the current one |
When a playlist has no sources, nothing is sent when the schedule triggers.
A device under local control does not receive the playlist's images.
Editing a playlist
Click "Edit" on the row of the playlist you want to change, make your changes and click "Save".
If you change the sources while the playlist is playing, the new content is used from the next image change.
Deleting a playlist
- Click the red delete icon on the row of the playlist you want to delete.
- The confirmation window says "Once confirmed, this playlist will be permanently deleted and cannot be undone."; click "Confirm Delete".
- "Playlist deleted" appears.
Schedules that use this playlist are not deleted
The schedules stay, but when they trigger later they play nothing. Before deleting a playlist, go to "Schedule Settings" and edit or delete the schedules that use it.
Related pages: My Gallery, Schedule Settings, Task List