Working with Scripts
Scripts let you group media together into an ordered sequence. When a script plays, each piece of media displays in the order you've arranged them.
Why Use Scripts?
Scripts are useful when you want to:
- Play multiple images or videos in a specific order
- Reuse the same sequence across different templates
- Update content in one place and have it reflect everywhere the script is used
Creating a Script
Scripts are created by grouping media items in the template editor:
- Open a template in the editor
- Add the media items you want to group to a device column
- Click to select media items (use Shift+Click to select a range)
- When you have 2 or more contiguous items selected, a "Group N items as Script" button appears
- Click the button and enter a name for your script
- The selected items become a single script
Your script is saved when you save the template. Once saved, it appears in the Script Library and can be reused in other templates.
Script names must be unique. The editor will let you know if a name is already taken.
Browsing the Script Library
The Script Library shows all scripts that have been created. You can:
- Search scripts by name
- Filter by tags
- See how many media items each script contains
Adding Scripts to Templates
When building a template, you can add existing scripts from your library:
- Click Add Content on a device column
- Search for the script by name or tag
- Select the script and click Add
The entire script (with all its media) is added to your device.
Viewing Script Contents
In the template editor, scripts display:
- The script name
- Any tags applied to the script
- A list of all media items in the script
- The count of media items
Editing Scripts
To modify a script's contents:
- Add the script to a template
- Ungroup it (click the ungroup button)
- Make your changes (add, remove, or reorder media)
- Re-select the items and group them with a new name
Ungrouping Scripts
To convert a script back to individual media items:
- Find the script in your device column
- Click the ungroup button on the script header
- The script expands into its individual media items
This is useful when you want to modify the contents or use only some of the media from a script.
Scheduling Within Scripts
Each media item inside a script can have its own schedule. This lets you control when specific items within the sequence are shown. Click the calendar icon on any media item within a script to set its schedule.
You can also schedule the entire script by clicking the calendar icon on the script header.
Deleting Scripts
Remove scripts you no longer need from the Script Library. If a script is currently used in templates, you'll need to remove it from those templates first.