Table of Contents

Actions

Using “Actions”, you can execute various tasks in mAirList, bound to (timed) events.

Actions can be used in various places:

Adding and Configuring Actions

All of the places that support actions, mentioned above, have a section in the GUI where you manage the list of actions to be executed. For example, this is how it looks in the Event Editor:

The toolbar contains buttons to add, delete and configure events, and to load/save the entire list from/to XML files.

The configuration settings largely depend on the type of action – see description below. But all actions have the same Options tab:

The following settings are found here:

Action Description

This section describes all available actions and their options.

Miscellaneous

Execute command

Executes any of the remote control commands.

Work an action list

Serves as a container for other actions, can be used to nest actions for easier management.

Emergency actions

Normally, when an action fails due to an error, the execution of the entire action list is aborted. When you add an Emergency actions action to the end of the list however, the execution will jump to that emergency actions and execute all actions found inside it. If you are a developer, this is pretty much like a try..finally block.

No action

Just a dummy…

Download file

Downloads a file via HTTP or FTP and saves it under the given filename. Can be used together with the Event Scheduler to implement a very simple download manager.

Send e-mail

Send an e-mail. Enter the recipient, subject and body. Note: Sender address and name as well as the SMTP server must be configured in the config app first.

Run script

Runs a script (*.mls file).

Send data to serial port

Sends data to a serial port, which must already be open (e.g. by using a Serial Port Remote Control). The data is sent in ANSI encoding by default. In order to send binary data, enter a dollar sign followed by the hexadecimal data, e.g. $C0BA0003.

File

Insert File

Inserts the specified file at the top of the playlist, or below the currently playing item. You can use logging variables in the filename if substitution is enabled on the Options tab.

Play File

Inserts the specified file at the top of the playlist, or below the currently playing item, and starts it immediately. You can use logging variables in the filename if substitution is enabled on the Options tab.

This action only works in AUTO mode, as it uses the AUTOMATION x NEXT command internally. In ASSIST mode, the file is only inserted but not played.

Insert/play network file

Same as above, but for files on HTTP/FTP servers. Enter a URL instead of a local filename.

Playlist

Note: All “Playlist” actions accept logging variables inside the filename if substitution is enabled on the Options tab.

Load playlist

Loads the specified playlist file. The current playlist content (except for any playing items) is discarded.

Load and play playlist

Loads the specified playlist file, and issues an AUTOMATION NEXT command so that the automation jumps to the first item. Only works in AUTO mode.

Insert playlist

Inserts a playlist file at the top of the current playlist, or below the currently active item.

Insert and play playlist

Inserts a playlist file at the top of the current playlist, or below the currently active item, then issues an AUTOMATION NEXT command so that the automation jumps to the first item. Only works in AUTO mode.

Append playlist

Appends the specified playlist file to the current playlist.

Shuffle playlist

Shuffles the current playlist content.

Automation

Enable automation

Switches to AUTO mode.

Disable automation

Switches to ASSIST mode.

Start automation playback

Equivalent to clicking the PLAY button in the automation toolbar.

Fade to next item

Equivalent to clicking the NEXT button in the automation toolbar.

Stop automation playback

Equivalent to clicking the STOP button in the automation toolbar.

Stream

Insert stream

Inserts a stream playlist item at the top of the playlist, or after the currently active item. Enter the URL and an optional title for the stream. Also specifiy whether this should be an infinite stream, or a stream item with a particular duration.

Play stream

Insert a stream playlist item, and issue an AUTOMATION x NEXT command so that it is played instantly. Only works in AUTO mode.

Database

Load database playlist, Load and play database playlist, Insert database playlist, Insert and play database playlist, Append database playlist

Same as the actions for playlist files described above, but for playlists loaded from a database (e.g. mAirListDB).

Select the database connection to load from (defaults to the first active connection) and the sub-playlist (defaults to the master playlist) to use.

An optional postprocessing script can be specified that is run on the playlist before it is loaded/inserted/appended. The playlist can be accessed through CurrentPlaylist from the script.

Several options are available:

Mixer

These actions refer to the Windows Audio Mixer (not widely used anymore in Vista and later).

Mute Mixer Channel

Mutes the specified channel in the mixer.

Unmute Mixer Channel

Unmutes the specified channel in the mixer.

Encoder

These actions refer to the built-in Streaming Encoder.

Connect encoder

Establishes the encoder connection, equivalent to clicking the Connect button in the Encoder Status window.

Disconnect encoder

Terminates the encoder connection, equivalent to clicking the Disconnect button in the Encoder Status window.

Switch input on or off

Use this action to switch any of the encoder inputs (Mic, Line, Aux, …) on or off. This is the same as clicking the LINE or MIC button in the Encoder Status window.

Enable local output

Unmutes the local audio output of the encoder (to the audio device set as encoder playback device in the config).

Disable local output

Mutes the local audio output.

Aircheck Recorder

The actions in this section are used to control any Aircheck Recorder. The recorder must have a Remote ID set in the screen object properties, and you must enter the same ID in the action configuration.

Open output file

The same as clicking the Open button in the Aircheck Recorder window. The filename is selected automatically based on the recorder configuration.

Start/resume recording

Starts recording, or resumes it if it is paused. Equivalent to the Record button in the Aircheck Recorder window.

Pause recording

Equivalent to the Pause button in the Aircheck Recorder window.

Close output file

Equivalent to the Close button in the Aircheck Recorder window.

File Recorder

These actions refer to the File Recorder.

Start recording

Starts a new recording. See the File Recorder documentation for a description of all options and settings.

Stop recording

Stops one or more recordings, based on the Recording ID.

SAS

These actions refer to the SAS Remote Control (Lawo/Studer/…). The documentation for the actions can be found here.

DHD

These actions refer to the remote control for DHD mixing consoles. The documentation of the actions can be found here.

REST

Execute command via REST

Executes any fader start command on another mAirList instance, using REST Remote Control on the server side.

Select the hostname, port and optionally path of the REST remote to send the command to.

Authentication can be carried out via username/password, or an auth token.

MusicMaster

The actions in this section refer to the MusicMaster Nexus API binding.

Update unscheduled positions

Looks for any unscheduled positions in the current playlist, and checks if they have been scheduled meanwhile, and if yes, replaces the dummy item with the actual audio item.

Synchronize playlist

Syncs any changes made from the MusicMaster side in the current schedule. This is one-way synchronization from MusicMaster to mAirList! Local changes will be lost.