The standalone mAirList Configuration app is found in the Windows Start Menu (setup installations), or invoked through the mAirListConfig.bat batch file included in the zip distribution (which calls mAirList.exe -mode config to start it).

The standalone configuration gives you access to all configuration options. It must, however, not be used while any other mAirList process/app is running.

Live Configuration (mAirList Control Panel)

The live configuration, also known as mAirList Control Panel, can be found in the About menu of the main playout app.

It provides access to many configuration settings that can be changed while the playout is running. Some settings (e.g. the basic setup of playlists and players) are not available at all, and some will only take effect after you restart the playout.

Configuration Pages

The configuration is organized on several pages which you access through the menu tree on the left hand side of the configuration dialog. Note that some pages may not be available based on your license/edition.

1 - Playlists

This configuration section contains all settings related to the playlist(s) in the playout app.

This section is only available in the standalone configuration app. not the live configuration.

On the Playlists page, specify the desired number of playlists you want in the playout app. mAirList supports any number of playlists (also zero for cartwall-only setups), but most users will have one playlist.

For each playlist, a Playlist (number) item will appear in the menu on the left.

Playlist

This page contains the following tabs:

General

Player count: Specify the number of players to be used with this playlist (at least 1, typically 2 or 3 for most setups). For each player, a menu item Player (number) will appear (see below).
Number of played/skipped items to keep in history: Specify the number of played or skipped items that should remain (grayed out) in the playlist before they are moved to Recycle Bin (if the corresponding option Move played/skipped items to Recycle bin is enabled on the Options page).
Number of prebuffered items: Specify the number of upcoming items that mAirList should open (and thereby check for errors) in advance. Successfully rebuffered items are identified by a small green checkmark next to the item icon.

Options

This tab contains options related to the behavior and operation of the playlist:

Allow automation mode: Uncheck to force the playlist being in ASSIST mode all the time.
Use only a single player in automation mode: If enabled, mAirList will play all audio files through a single player (and thus, soundcard) in automation mode. The benefit is that you don’t have to remember to open all faders when switching from ASSIST to AUTO. The player used for automation will be the one that was active when the switch to AUTO was made, or the first player, in case no player was active at that time. In any case, it must/will be a player for which Use in automation is enabled in its options.
Move played/skipped items to Recycle Bin: If enabled, all played and skipped items are automatically deleted from the playlist and moved to the Recycle Bin browser.
Only move items at the top of the playlist to Recycle Bin: By default, only items from the top of the list will be moved to the Recycle Bin, not those played out-of-order in ASSIST mode. By enabling this option, the latter will be moved to the Recycle Bin as well.
Automatically mark non-playable items as played in assist mode: If enabled, any non-playable item (e.g. Dummy) will be marked as played as soon as any playable item below it is started in ASSIST mode. (In AUTO mode, this will always be the case.)
Keep non-playable items in automation mode if playlist would run empty otherwise: This option refers to the situation when the playlist is in AUTO mode, and only non-playable items remain in the rundown. If enabled, these items will not be marked as played (and possibly move to Recycle Bin) before at least one playable item is added to the playlist again.
Include non-playable items in logging: If enabled, non-playable items (e.g. Dummy items) that are automatically marked as played (in AUTO mode, or in ASSIST mode if the corresponding option is enabled, see above) will be injected into to the Logging subsystem, e.g. for stream title update and database reporting.
Move deleted items into Recycle Bin: If enabled, items that are manually deleted by the user will be moved into the Recycle Bin.
Automatically unpack embedded playlists: If enabled, Embedded Playlist items will automatically unpacked (content items copied into playlist) when added to the playlist.
Keep Embedded Playlist as Dummy after unpacking: If enabled, the Embedded Playlist item will be converted into a Dummy and remains in the playlist after unpacking; otherwise it will be deleted.
Automatically jump to fixed time items in automation mode: This option controls the processing of (hard or soft) fixed times in playlist items. Uncheck to disable fixed times altogether – items with timing set to Hard or Soft will be treated as Normal.
Wait for hard fixed time items: This option controls the behavior of the playlist if an item with Hard timing is reached too early in AUTO mode. If disabled, the item will be played immediately, even if the set time has not been reached. If enabled (the default), the automation will wait for that time to be reached, playing silence (an Infinite Silence) item until then. Additionally, the When playlist runs empty in automation mode action is triggered in order to execute any “emergency” actions.
Wait for soft fixed time items: The same as above, but for Soft timing items. Disabled by default.
Update backtiming with current time when idle: This option is related to the Time column in the playlist, in a situation where all players are idle. If disabled, the start time relative to the beginning of the playlist (00:00:00) will be displayed for all items. If enabled, the start time relative to the current date/time will be displayed, updated every second, assuming that the first item is started in this very moment.
Auto float: If enabled, the Auto Float feature will automatically move Normal timing items around fixed time items so that no underruns or overflows occur in the playlist.
Repeat mode: If enabled, all played items are automatically recycled and moved to the end of the playlist again. This is meant for demo setups.

GUI Options

This tab contains options related to the user interface of the playlist:

Show save confirmation: If enabled, a confirmation dialog is displayed if there are unsaved changes when you close a playlist.
Show ramp countdown overlay: If enabled, a large countdown is displayed as an overlay in the playlist while the ramp/intro of an item is playing.
Show only nearest ramp: For items with more than one ramp set, this option controls whether only one ramp (the nearest from the current playback position) or all of them (separated by a / sign) will be displayed in the Ramp column and the ramp overlay.
Show EOF warning countdown overlay: If enabled, a countdown overlay will be displayed during the last few seconds.
Click on playlist icon toggles Extra PFL: If enabled, clicking the icon on an item in the playlist will open its Properties dialog, switch to the PFL tab and start PFL playback.
Always show duration: If enabled, 0:00 will be displayed for items with unknown duration.
Always show ramp: If enabled, 0 will be displayed for items that don’t have any ramp set.
Auto-truncate time: If enabled, leading zeroes will be removed from all duration and ramp strings.
Automatically scroll to playing item: If enabled, and an item is started, the playlist will automatically scroll so that that item becomes visible (if it hasn’t been before).
Spacebar triggers AUTOMATION NEXT: As the spacebar cannot be used in Hotkey remote control due to limitations imposed by Windows, this option allows you to hardwire it with the AUTOMATION NEXT command.
Escape triggers AUTOMATION BREAK: If enabled, the Escape key will trigger the AUTOMATION BREAK command.
Escape triggers AUTOMATION STOP: If enabled, the Escape key will trigger the AUTOMATION STOP command.
Show color ribbon: If enabled, a colored ribbon is displayed in the playlist, representing the color or other properties of the item (based on the skin).
Use item colors for color ribbon: Check this option to use the item color (if set) for the color ribbon, rather than the color defined in the skin.
Use item colors for row color: Check this option to use the item color (if set) for the entire row background, rather than the color defined in the skin.
Item-specific colors have priority over skin.ini: If enabled, item colors will always have priority over those defined in the skin.
Show break duration: If enabled, Automation Break playlist items will display the duration of the preceding block instead of their own duration.
Show album art: If enabled, mAirList will try to extract album art from the file tag, and display it instead of the default item icon. Album art is kept in a cache file to speed up loading when the item is used again.
Show player state: Enable this option to display the player state (ON AIR, NEXT, etc.) next to the player name in the playlist.
Show player progress as row background: If enabled, the row background of playing items will be used as some kind of progress bar, displaying elapsed/remaining time in different colors.
Auto recycle items on move/drop: When enabled, every played/skipped item that is moved with the mouse will automatically be recycled (marked as unplayed).

Control Bar

The options on this tab refer to the control bar (toolbar) displayed above or below the playlist.

Show control bar: Uncheck to hide the control bar altogether.
Position at bottom (default is at top): Check this option to move the control bar below the playlist, rather than above the playlist (the default).
Separate ASSIST/AUTO buttons: By default, there will be two separate buttons to switch between ASSIST and AUTO mode. Check this option to merge them into a common button that toggles between ASSIST and AUTO.
Show NEXT button in assist mode: If enabled, a NEXT button will be displayed also in ASSIST mode, that simulates commands to fade out the current player and start the next loaded player.
Alwayse use automation for NEXT button: If enabled, the aforementioned NEXT button will briefly enable AUTO mode to carry out the NEXT command.
AUTO button flashes while playing: If enabled, the AUTO button will flash when automation is engaged and playback is started.
Show next event time box: Check this option to enable a button that displays the time of the next planned event, and opens the Event Scheduler when you click it.
Show item count and duration boxes: This option toggles this display of a button that displays the number and total or remaining duration of the items in the playlist.
Show Edit button: If enabled, an “Edit” button is displayed that expands the inline editor which allows you to quickly edit some common properties of the selected playlist items, including cue markers.
Always show move up/down buttons: If enabled, a separate pair of “move up/down” buttons will be displayed in the main control bar, rather than only in the inline editor.

Progress Bar

This tab provides options related to the “inline” progress bar displayed in the playlist rows for playing items.

See the Common Settings section for a description of the available options.

Display

Time Formats

Here you can adjust the time format strings used for duration, ramp, ramp overlay and EOF warning overlay.

Auto Comment

Any text entered here will be concatenated with the item comment and displayed when the item is expanded by clicking the corresponding button in the item row.

It is possible to use Logging Variables here that access properties of the item, e.g. attributes. For example, %u{Album} will insert the value of the Album attribute (album name extracted from file tag).

Player

For each player of each playlist, a menu item is created in the menu tree on the left hand side of the configuration dialogs, which provides access to the settings for that particular player.

General

On the first tabe, the following general settings are available:

Caption: Choose a caption (typically a single character) that is used to identify the player in the GUI. It is displayed in the player, as well as in the playlist next to the item that is loaded into that player.
Color: Each player is associated with a color that helps the DJ to identify the player in the GUI. It is used as the background for the player indication in the playlist, and also for the background of the player object while it is active (unless overriden by skin).
Default time display mode: Select the default mode for the time display: remaining time, elapsed time or backtiming (the time at which the item will finish playing). You can toggle between remaining and elapsed by clicking the time label in the player object, or double-click it to switch to backtiming mode. If a Command when clicked is specified (see below), the Shift key must be hold down while clicking the time label.
EOF warning: Specify the number of seconds before EOF when the player should stat flashing and trigger the OnPlayerEOFWarning procedure in background scripts.
Command when clicked: Choose an optional command that is executed when the user clicks anywhere in the player object with the mouse. This is useful for touchscreen operation.
Fade duration: Enter the duration, in seconds, that the audio should fade out when a FADEOUT command is issued, or the Fade Out button is clicked. The value 0 means that the default fade duration from the Misc. Settings page will be used.
Time formats: Specify the time format strings for the remaining and elapsed time and the ramp display.

Options

This tab contains options related to the behavior and operation of the playlist:

Auto load in assist mode: If enabled, the player will automatically be loaded with the next available item in ASSIST mode. If disabled, the user must load the player manually by dragging an item into it, or using remote control commands.
Auto load on demand: If enabled, the player will not be auto-loaded until a START command is issued, or the START button is clicked.
Only auto-load if all other players are empty: By enabling this option for all (auto-loading) players, only a single player will be loaded at a time. This may help the DJ to identify the next player to start mor easily.
Auto close on STOP in assist mode: If enabled, the player will unload itself when a STOP command is issued in ASSIST mode.
Auto close on ERROR in assist mode: If enabled, the player will unload itself if an item failed to load in ASSIST mode.
Auto close at EOF in assist mode: If enabled, the player will unload itself when playback stops at end of file in ASSIST mode. This overrides the Auto rewind at EOF option below.
Auto rewind at EOF in assist mode: If enabled, the player will rewind and return to LOADED state when reaching EOF in ASSIST mode. The Auto close at EOF option above must not be enabled.
Auto release PAUSE when other player is playing or started: This option can be used together with the PAUSE/STOP commands for remote control. When the DJ closes the fader, the player will initially go into PAUSE state. At this point, the DJ can either choose to open the fader again - then the player will continue to play from that position. Or the DJ can start another player, and then this player will simulate a STOP command and unload itself (depending on the options above).
Auto PFL OFF on START: If enabled, PFL mode will be canceled when on air playback is started in ASSIST mode.
Auto close PFL at EOF: If enabled, PFL mode will be canceled when playback reaches EOF in ASSIST mode. Allow simultaneous playback and PFL (see below) must be enabled as well.
Auto fadeout at Fade Out marker in assist mode: If enabled, playback will automatically fade out at the Fade Out marker even in ASSIST mode, similar to AUTO mode. If disabled, audio will never fade automatically in ASSIST mode, but the DJ is responsible to execute all crossfades manually.
Use in automation mode: Uncheck this option to prevent this player from being used in AUTO mode. Note: There must be at least one player for which this option is enabled, otherwise all players will be used in AUTO mode.
Move item to history when closing paused/EOF player: If enabled, items will be marked as played when it they are ejected from this player after playback.
Move item to history when closing loaded player: If enabled, items will be marked as skipped when it they are ejected from this player without having been played.
Include in logging: If enabled, items played from this player will be injected into the logging subsystem.
Allow simultaneous playback and PFL: Usually, each player can only be playing on air, or playing in PFL mode, but not both at the same time. This is because on air and PFL audio is typically routed to the same mixing console channel. Depending on your setup, you may be using a separate audio channel for PFL operations. In this case, you can enable this option, and PFL mode can be engaged even when the player is currently playing on air.
Only use PFL audio device while player is playing: This option can be used together with the Allow simultaneous playback and PFL option above. It controls which device is used for PFL mode while on air playback is not active. If disabled, PFL mode will always use the player’s PFL device set in Audio Routing. If enabled, PFL mode will use the On Air device when there is no simultaneous on air playback, and the PFL device if both on air and PFL are playing at the same time. This way, you can use the regular mixing console channel for non-simultaneous PFL mode, and a separate channel only for simultaneous PFL.
PFL during playback starts End Mon: If enabled, PFL playback will automatically jump to the last few seconds of the item when you enabled PFL mode during on air playback. This option only has effect if Allow simultaneous playback and PFL is enabled as well.
Loop audio: If enabled, the player will loop between Loop In (or Cue In) and Loop Out (or EOF). Loop mode can be toggled at runtime by using the Loop button the player.
Switch off loop mode when player is closed: If enabled, Loop mode is disabled automatically when the item is ejected.

GUI Options

Auto-truncate time: If enabled, leading zeroes will be removed from all duration and ramp strings.
Show cue editor during PFL: If enabled, the Cue Editor will be displayed in a popup window as long as PFL is active.
Show save buttons in PFL cue dialog: Check this box to add buttons to the Cue Editor to save the item metadata to the database, file tag, or MMD file.
Flash during EOF warning: If enabled, the player will flash during the last few seconds before EOF, according to the setting on the General page.
Show ramp: If enabled, the duration label will turn into a ramp countdown while the ramp part of the item is playing.
Show ramp when idle: If enabled, the ramp countdown will already be displayed in Loaded state, not only after playback was started.
Show only nearest ramp: If enabled, only the next ramp marker from the current playback position (for items with more than one ramp set) will be considered in the countdown.
Swap artist and title: Check this option to swap the artist and title labels in the player object (artist will be on top, title below).
Use item color when idle: If enabled, the color set for the item in the Properties dialog will be used for the player background while it is in Loade state.
Use “stutter” mode while cueing:
Allow dragging: This option will make it possible to drag a loaded item out of the player with the mouse. The Command when clicked setting will not have any effect anymore.
Show volume slider: Check this to enable the volume slider on the right hand side of the player object.
Transparent buttons: This option will make the background of the buttons transparent.

Buttons

On this tab, select the buttons that should be displayed in the player. Deselecting all buttons will hide the button toolbar completely.

Progress Bar

The options on this tab control the progress bar displayed in the player. See the Common Settings section for a description of the available options.

Waveform

These options refer to the waveform display in the player object. See the Common Settings section for a description of the various options.

Peakmeter

These options refer to the peakmeter in the player object. See the Common Settings section for a description.

Item Types

On this tab, select the item types that should be included in the Auto Load function by default. Hint: The right-click menu allows you to select all/no items at once.

2 - Cartwall

This configuration page contains the settings related to the cartwall.

General

To enable the cartwall, the Enable Cartwall box must be checked.

Grid Size

Audio items in the cartwall are arranged in a grid, and each field of the grid serves as a (virtual) cart player – although you can resize individual items so that they span multiple fields in the grid.

The grid size can be adjusted freely. The resulting number of players is the grid with multiplied by the grid height.

Settings

The following settings can be made:

Numbering: The fields in the cartwall grid can be numbered in one of the following ways:
- None: No numbers will be used. This will also disable any CARTWALL <index> ... remote control commands, as well as cart player state feedback for remote control interfaces that support it (e.g. D&R Airlite).
- Left to right: First row of fields has numbers 1, 2, 3, etc.; then numbering continues with the second row, and so on.
- Left to right (occupied positions only): Same as Left to right, but only those fields that actually contain an item receive a number, empty fields are skipped.
- Top to bottom: First column of fields has numbers 1, 2, 3, etc.; then numbering continues with the second column, and so on.
- Top to bottom (occupied positions only): Same as Top to bottom, but only those fields that actually contain an item receive a number, empty fields are skipped.
When a cart player is resized so that it spans multiple fields in the grid, its number will be the one of the top left field it occupies.
Start in mode: The cartwall operates in one of the modes ON, OFF or PFL at any time, which are toggled through remote control commands (CARTWALL MODE ...) or the buttons in the cartwall toolbar. Set the desired mode at program startup here.
EOF warning: Specify the number of seconds before EOF when a player should stat flashing and trigger the OnCartwallPlayerEOFWarning procedure in background scripts.
Fade duration: Enter the duration, in seconds, that the audio should fade out when a FADEOUT command is issued. The value 0 means that the default fade duration from the Misc. Settings page will be used.
Time format and Ramp format: You can adjust the time format strings used for the playback position and ramp countdown here.

Position and Window Options

The cartwall can either be displayed as part of the main window – in which case it will be located below the playlist(s) – or in a separate window.

If you choose to use a separate window for the cartwall, that window can either remember its last position when you restart the software, or mAirList can always maximize it on a particular monitor in multi-screen setups. The Identify Monitors button will help you to identify which monitor is Monitor 1 etc.

Additionally, the follwing options are available:

Always on top: If enabled, and a separate window is used for the cartwall, that windows will always be displayed on top of all other windows.
Remember window position and size: This should be checked if the position set to Separate window - restore last position, so that mAirList records the current window position when you exit the software.
Show Cartwall button in toolbar: If checked, a Cartwall button will be added to the main toolbar of the playout window. Click that button to hide/show the cartwall (for “embedded into main window” mode), or to open the cartwall window and bring it to front (for “separate window” mode).

Options

The Options page contains several tabs with options related to the cartwall.

General

Include in logging: If enabled, items played from the cartwall will be injected into the logging subsystem.
Always show grid: If checked, the grid will always be displayed, even if there are no open tabs.
Always show cart numbers in grid: If checked, the field numbers in the grid will be displayed all the time, even for empty fields. The Always show grid option must be enabled as well.
Show ON button in toolbar: Uncheck to hide the ON button (that toggles between ON and OFF mode) from the cartwall toolbar.
Show PFL button in toolbar: Uncheck to hide the PFL button from the cartwall toolbar.
Show artist: If enabled, the artist of each item will be displayed in the cart players along with the title; otherwise only the title.
Show ramp: If enabled, the duration label will turn into a ramp countdown while the ramp part of the item is playing.
Show ramp when idle: If enabled, the ramp countdown will already be displayed in Loaded state, not only after playback was started.
Show only nearest ramp: If enabled, only the next ramp marker from the current playback position (for items with more than one ramp set) will be considered in the countdown.
Show icon instead of title when available: If enabled, and an icon is set for the item in its Properties dialog, the icon will be displayed instead of the title.
Show volume slider: If enabled, a volume slider will be displayed in each individual cart player.
Flash during EOF warning: If enabled, cart players will flash during the last few seconds of playback (see EOF warning setting on the General page).
Show save confirmation: If checked, a confirmation dialog will appear when you close a tab that has unsaved changes.
Ask for confirmation when closing pages: If checked, a confirmation dialog will appear when you close any changed or unchanged tab.
Prevent leaving ON mode when players are active: If you uncheck this option, ON mode can be canceled at any time (switching to OFF or PFL mode), and all cart players will stop playing as you do so.
Prevent leaving PFL mode when players are active: If you uncheck this option, PFL mode can be canceled at any time (switching to ON or OFF mode), and all cart players will stop playing as you do so.
Automatically switch to ON mode when player is started in OFF mode: When this option is enabled, the cartwall will process remote control start commands and mouse clicks even in OFF mode, and switch to ON mode automatically before it starts playing.
Ignore mouse clicks: By checking this option, you can prevent cart players reacting to mouse clicks. This is for situations where the cartwall should only be controlled by remote control commands.
Allow dragging of items to playlist: If enabled, you can drag items from the cartwall to the playlist with the mouse. Starting and stopping cart players with the mouse will not work anymore.
Only one cart per column can be selected: This option constraints the CARTWALL <number> SELECT command to one cart per column; if you select another cart from the same column, the first one is unchecked automatically.
Selection per column is locked while cart is playing: If enabled, carts cannot be selected or unselected while they are playing.
Auto-reload Favorites: Check this option to re-scan the folders set up in on the Favorites page (see below) every time you open the Favorites menu.

Progress Bar

The options on this tab control the progress bar displayed in the cart players. See the Common Settings section for a description of the available options.

Waveform

These options refer to the waveform display in the cartwall toolbar. See the Common Settings section for a description of the various options.

Peakmeter

These options refer to the peakmeter in the cart players. See the Common Settings section for a description.

Favorites

On this page, you can register one or more files and folders that should be presented in the favorites menu that appears when you click the button with the heart icon in the cartwall toolbar. The button will only appear where there is at least one file/folder registered here.

The following items are supported:

Cartwall Page files (*.mcp)
Cartwall Set files (*.mlc, from earlier version)
Folders – they will be recursively scanned for *.mcp and *.mlc files in them.

3 - GUI

In this section of the configuration you can adjust the appearence of the graphical user interface (GUI) of mAirList.

General

On the General tab, the following settings can be adjusted:

Window position: Choose whether the main window should appear maximized on one of the available monitors, or use the default position (which will possibly be remembered when you close and re-open the software, see option below).
Show GUI in language: mAirList comes with a number of international translations, selecting the appropriate one according to your Windows locale settings. If you want to override this automatic selection, choose a specific language from the dropdown list.
Global progress bar interval: This is how often the progress bar is updated. A shorter interval will result in a smoother display, but also higher CPU load.
Clock time format: Select the display format for the clock; the default is tt which corresponds to the default time display format from the Windows local settings. You can override it using the same variables as available for logging.

Additionally, the following options are available:

Remember window size and position: If enabled, mAirList will remember the last window size and position when you close the software, and restore it in the same place when you re-open it.
Show status bar: Controls whether the status bar (with last log error/warning, ON AIR status and current time) will be displayed in the main window.
Show close confirmations if there are active players: If enabled, an additional warning will be displayed when the user tries to exit the software while there are players playing on air.
Minimize to try: If enabled, the software will move its icon away from the taskbar to the Windows tray when the application window is minimized.
Use small icons: when checked, the toolbar of the main window uses smaller icons, which can save some space on smaller displays.
Use separate tabs for playlists: When more than one playlist is configured, they are usually displayed below each other (or side by side, see next option). With this option enabled, they will be presented on separate tabs instead.
Side-by-side alignment of playlists: Check this option if you want the playlists to be displayed side by side, rather than below each other.

Browser

The options and settings on this page refer to the browser part of the main playout window.

Use full height for the browser: If enabled, the browser will use the full height of the right hand side of the playout window, making the players less wide.
Show Browser button in toolbar: If enabled, a Browser button is displayed in the toolbar which can be used to show/hide the browser.
Visible at startup: Check this option to display the browser by default when the software starts. If unchecked, the user must click the Browser button first to display it.
Use a separate window for the browser: With this option, the browser can be detached from the main window, and displayed in its own separate window.
Separate browser window is always on top: If enabled, the separate browser window will always be on top of the main window.
Allow stack of panes to be minimized: If enabled, the user can minimize browser tabs with the mouse, turning them into small side-by-side buttons, to save screen space.
Show panes as tabs: This option will use plain Windows-style tabs for the browser tabs, rather than the default panes.
Show file durations (may be slow): If enabled, mAirList will read out the duration of all files in directory browsers.
Auto update folder contents: If enabled, mAirList will update the contents of directory browser regularly.
Folder browsers are read only: By default, the directory browsers have a context menu that mimics the behavior of Windows Explorer, and also allow drag/drop of files to copy or move them. Check this option to disabled these features and make the directory browsers entire reay-only.
Disable Windows Explorer colors: Check this option to disabled coloring of files in directory browsers according to Windows Explorer settings.
Keep search history: If enabled, a dropdown with the most recently used search terms will be available in the Database Search browser.
Enable autocompletion for search history: This option enabled autocompletion in the search history of the Database Search browser.

Cue Editor

This section provides settings for the Cue Editor, both in the Item Properties dialog, and in the PFL window that appears when a player is started in PFL mode.

On the Favorites tab, you can select the most frequently used cue marker types. If one or more type is selected, a new tab labeled Favorites is displayed in the Cue Editor with only these types, and the complete list of markers is displayed on another tab labeled All.

On the Options tab, you can enabled “Stutter” mode, which will repeatedly play a small part of the audio as you edit a cue marker, similar to the function found in DJ CD players.

The options on the Waveform tab control the appearance and behavior of the waveform in the Cue Editor. See the Common Settings section for a description of the various options.

Progress Bar

The options on this tab control the “global” progress bar displayed below the playlists. See the Common Settings section for a description of the available options.

Item Colors

On this tab, you can define colors for playlist items, based on their item type (music, jingle, advertising, etc.). These colors will be used when no specific color is defined or a particular item in its properties.

Screen Objects

Screen objects allow you to add additional elements (buttons, labels, utilities, …) to the playout window.

To add a new screen object, use the Add button and select the desired type from the dropdown list. To edit the properties of an existing object, double-click it, or select it from the list and click Configure.

The order of the screen objects can be rearranged by dragging items around with the mouse; this will also affect the order in which they are displayed in the playout GUI.

Common Settings

On the Advanced tab of the screen object properties dialog, there are some settings that are common to all or some types of screen objects:

Position: Select whether the screen objects should be displayed above or below the browser, or in a separate Tools window that can be accesses through the Tools button in the main toolbar (only visible when at least one screen object is set to Tools Window). You can also select the alignment within the Tools window.
Automatically hide or minimize: Some screen object types can automatically hide themselves in situations where there is no information to display. For example, the Countdown to next event object can hide itself when there are no upcoming events. Check this option to enable this automatic hiding. The option is grayed out for those objects that don’t support it.
Border: mAirList can display an optional border around the object. To enable the border, set the border width greater than 0, and select the desired color.
Remote ID: Some screen object types can process remote control commands. For example, the Extended Button object can receive a PRESS command that simulates a click. To enable processing of remote control commands, you must configure a remote ID for that screen object, which will serve as the prefix for the remote control commands. It should be in all capital letters or digits, and should not contain spaces. For example, when you set MYBUTTON as the remote ID, the resulting command will be MYBUTTON PRESS. A list of supported commands is given in the description of the various screen objects below. Please note that, due to the dynamic nature of these commands, they will not appear in the command selection dropdown list of the remote control configuration.

For all text-based and button screen objects (e.g. “Date or time”), the font, font color background color and text alignmenet can be adjusted and previewed on the Appearance page.

Streaming Encoder Status

This screen object displays the the status of the encoder and allows the user connect or disconnect the encoder, and toggle the live (LINE and MIC) inputs.

For more information, see the description of the screen object in the Encoder chapter.

Date or Time

This screen object displays the current date or time, according to the time format which is specified in Delphi’s FormatDateTime formatting. See here for a list of possible formatting variables.

If you want to display static text before or after the time string, enter it into the text format field, and use %s as the placeholder for the actual time string.

LED Clock

This screen object contains a studio-style LED clock. You can adjust the colors for both the dots and the clock background.

Countdown to Top of the Hour

This screen object displays the remaining time until the top of the hour (xx:00:00). The format settings are the same as those for the Date or Time screen object.

Player Countdown

This screen object displays a countdown for the active player. You can choose from the following countdown types:

Remaining time
Elapsed time
Total duration
Remaining ramp
EOF warning
Remaining time to outro

The format settings are the same as those for the Date or Time screen object.

Comment Viewer

This screen object displays the value of the Comment field of the item currently selected in the playlist.

On Air Status

This screen object shows the current ON AIR status (ON AIR or OFF AIR). Fonts and colors can be set individually for both states.

On Air Switch

The same as On Air Status, but you can toggle between ON AIR and OFF AIR by clicking the screen object.

Simple Button

This screen object displays a single Windows-style button. When the user clicks the button, the Actions configured on the Actions tab are executed.

Extended Button

This screen object provides a button with a number of configurable options.

The button can either be a “simple” click button (actions from the Action tab are executed when clicked), or a “toggle” button (button can be toggled between “active” and “inactive”).

You can freely configure the texts and apperance used for each of the possible states (inactive, active, disabled, disabled+active). The default text will be used for all states that don’t have a specific text set.

If the button is configured as a “toggle” button, it will execeute the appropriate action list from the Action tab when it is activated or deactivated, and the following additional options are available:

Active at startup: Check if you want the button to be active when the software is started.
Execute actions when toggled remotely: Determines whether the action lists should be executed when the button is toggled from a remote control command (see below).
Status controlled by script: If checked, the button will not toggle its status on its own when clicked, but only execute the action lists; its state can only be toggled from a remote control command (see below). This can be used for interactions with scripts when you want the button to toggle only if the script processed the action/command successfully.

In order to control the button through remote control commands, set a Remote ID on the Advanced tab, e.g. MYBUTTON. Thereafter the button will process the following commands (prefixed by your Remote ID, e.g. MYBUTTON ENABLE):

DISABLE: Disable the button (user cannot click it with the mouse).
ENABLE: Enable the button again.
ACTIVATE or ON: Switch to active state (toggle button only)
DEACTIVATE or OFF: Switch to inactive state (toggle button only)
ACTIVATE/DEACTIVATE or ON/OFF: Toggle between active and inactive state (toggle button only)
PRESS: Simulate a click and execute actions (simple mode button only)
TEXT <value>: Change the default text of the button. Use "" to clear the text.
INACTIVE TEXT <value>, ACTIVE TEXT <value>, DISABLED TEXT <value>, DISABLEACTIVE TEXT <value>: Change the text for a particular button state. Use "" to clear the text.
FONTNAME <value>: Change the font name.
FONTSIZE <value>: Change the font size.
FONTSTYLE <value>: Change the font style.
FONTCOLOR <HTML color code>: Change the font color.

Static Text

This screen object displays a simple static text.

Status Display

This screen object works similar to the On Air Status, but it is used to display any kind of custom status, controlled by remote control commands and/or a script. To toggle between the states, define a Remote ID and use the commands <REMOTEID> ON and <REMOTEID> OFF.

Image

This screen object displays an image, e.g. station logo. All common image formats (PNG, JPG, SVG, etc.) are supported.

PFL Player

The PFL Player screen object provides a quick way to pre-listen to any audio item by dragging it onto the player.

Talk Timer

This screen object displays a talk timer that can be used as a stopwatch during live shows. The format settings are the same as those for the Date or Time screen object.

The timer can be started or stopped by clicking it with the mouse. Additionally, the following remote control commands are available:

START
STOP
START/STOP (same to mouse click)
RESET

Time of Next Event

This screen object displays the time of the next upcoming event in the Event Scheduler. The format settings are the same as those for the Date or Time screen object.

Countdown to Next Event

This screen object displays the remaining time until the next upcoming event in the Event Scheduler. The format settings are the same as those for the Date or Time screen object.

Countdown to Next Fixed Time

This screen object displays the remaining time until the next upcoming fixed time item im the playlist. The format settings are the same as those for the Date or Time screen object.

Mix Editor

This screen objects provides a fully-functional, embedded Mix Editor, which is automatically loaded with the items currently selected in the playlist.

Web Browser

This screen object provides an embedded web browser It uses Microsoft Edge internally, and the WebView2 Runtime must be downloaded and installed before you can use it.

The browser always starts with a fixed URL, and is it does not provide any address bar or other controls (except the right-click menu), you should only use it to display small dedicated web widgets that do not require a large amout of navigation. Good examples for suitable use are a chat application or a DHD 52 WebView.

Aircheck Recorder

The Aircheck Recorder provides a convenient recording facility for live shows. See here for more information.

Stream Monitor Status

This screen object displays the status (connection list) of the Stream Monitor.

4 - Audio Routing

On this configuration page, the audio routing of all audio-related functions can be adjusted, in particular:

the playback devices for players, cartwall, PFL, etc.;
the record devices for the encoder, live feed inputs, etc.

Routing Tree

The playback and record functions are arrangend on two separate tabs, Playback and Recording, and arranged in a tree-like manner.

In particular, there are nodes/sub-trees for the general default devices, the playlists and their players, the cartwall and its players, etc.

If not specific selection was made for a particular playback or record function, the device will be displayed in gray and italics, and the default device for that audio function will be used instead. This is typically one of the devices from the Default devices section (playback, PFL, or recording), with a few exceptions:

The PFL device of the players and the cartwall will follow the playback/ON AIR device of the same player if not set.
The cartwall has a default set of ON AIR/PFL devices that will be used for all players for which no specific devices are configured.

If Regionalization is enabled, each playback function will have a separate set of sub-nodes, one for each region, where you can select the output device for that particular playback function and region.

Change Assignment

To change the audio device of any playback or record function, double-click the entry in the tree, and a dialog with a list of available devices will be presented. Select the desired device and click OK to save the assignment.

The first entry in the list – Not set (use default device) – will clear the assignment for the selected playback function, so that it reverts to the default device for that function. For example, when you clear the specific assignment for “Cartwall Player 1 ON AIR device”, it will use the “Cartwall ON AIR device” assignment again (displayed in gray).

The device selection dialog as a built-in test function that will help you to identifiy the correct input or output. For playback devices, it will output a 1kHz test tone to the sound card output selected in the list. For record devices, it will open the device and display the audio level received from the selected input in the peakmeter at the bottom of the dialog.

Errors and Warnings

Whenever possible, audio devices are identified by unique ID that is assigned by Windows by the time the device is detected/installed. This is so mAirList can still identify them even when renamed in Windows Control Panel.

There are however situations when Windows unexpectedly re-detects a device, and assigns a new ID to it. In this case, one of following icons may be displayed in the tree:

Yellow warning icon: The originally selected device is no longer available, but another device with the same name was found and is being used instead. You can click the Repair icon in the toolbar to clear these warnings and make the auto-selected new assignment permanent.
Red error icon: The originally selected device is no longer available, and no matching new devices was found. Please select the new device manually.

Load and Save

The audio configuration for playback or recording can be saved and restored to/from an .ini file using the buttons in the toolbar. Only the playback or recording part of the routing will be affected, according to the currently selected tab (Playback or Recording).

5 - Audio Settings

On this configuration page, general audio output settings can be adjusted, as well as the settings and options for all sound cards.

General

mAirList uses the BASS audio library for all audio operations. On this tab, the general parameters for the library can be adjusted. Most of these settings correspond to the BASS_CONFIG_xxx config options of the BASS library. Detailed information on these options can be found in the BASS documentation.

Update period: Corresponds to BASS_CONFIG_UPDATEPERIOD option.
Network buffer size: Corresponds to BASS_CONFIG_NET_BUFFER option.
Network prebuffer amount: Corresponds to BASS_CONFIG_NET_PREBUF option.
Network connection timeout: Corresponds to BASS_CONFIG_NET_TIMEOUT option.
Network read timeout: Corresponds to BASS_CONFIG_NET_READTIMEOUT option.
Asynchronous file buffer: Corresponds to BASS_CONFIG_ASYNCFILE_BUFFER option.
Default recording prebuffer length: Length (in milliseconds) of prebuffered audio when recording from a sound card (e.g. for Live Feed playback).

The Default Recording Format is used for all recording functions in mAirList for which no specific format is configured.

Pitch and tempo adjustment using BASS_FX.DLL: If enabled, all audio is routed through the BASS_FX add-on, to enable pitch and tempo adjustment. This involves additional overhead even if playing at the default pitch and tempo, so it is disabled by default, and any pitch or tempo set in the item properties won’t have any effect until you enable the feature here.
Force high precision cueing for VBR files (BASS_STREAM_PRESCAN): When enabled, all files will be scanned to determine the exact file position for a particular playback position. Enable this option if you deal with variable bitrate (VBR) files a lot, because cueing might be inprecise without it.
Cache remote files (faster opening, needs RAM): If enabled, files played from an HTTP/FTP URL will be cached into RAM during playback.
Use asynchronous file reading: If enabled, the reading of audio files will be performed in a separate background thread, which may improve stability in situations where you encounter audio dropouts.

WASAPI

WASAPI (Windows Audio Session API) is the default audio output method used by mAirList. All soundcards available in the Windows Sound Settings control panel support this output method. It has been available (and the default) since Windows Vista.

Use event-driven buffering: If enabled, the device is opened in “even-driven” mode, which means that WASAPI will pull audio data as required, rather than that the application periodically pushes it to WASAPI periodically.
Raw mode (disable enhancements): If enabled, the device is requested to be opened in “raw mode”, which disables all enhancements set up in Windows Control Panel.

DirectSound

DirectSound is the older audio output method provided by Windows before Windows Vista was released. It is still available as an API in modern Windows version, but you should avoid using it normally, and use WASAPI instead. Internally, Windows will route all DirectSound data through the WASAPI layer anyway, so there is no point in using DirectSound; however there is a small number of older soundcards that may not work properly when accessed directly through WASAPI, so the DirectSound functions are still available in mAirList as a last resort when WASAPI doesn’t work.

To adjust the settings for a playback or record device, switch to the respective tab and select the device from the drop down list. The following settings and options are available:

Sample rate: Select the sample rate to run the soundcard with. This should match the sample rate set up in Windows control panel for this sound card.
Buffer size: (playback only) The size of the output buffer. This is also the playback latency, so it should be set as low as possible, but not too low, or you will hear dropouts.
Force multichannel output: (playback only) If this option is checked, the soundcard is assumed to have 8 channels, and 4 stereo pairs are made available as virtual devices after you restart the software. Use this option if Windows does not report all available stereo pairs correctly.
Enable multichannel device: (playback only) For a 5.1 or 7.1 soundcard, you may enable this option in order to create another multi-channel audio device in the playback routing, which allows you to play 5.1 or 7.1 audio files.
Ignore speaker assignment: (playback only) Sometimes Windows will report the outputs/speakers in a wrong order; check this option to fix this.
Use floating point data (BASS_SAMPLE_FLOAT): If enabled, PCM audio will be passed in 32-bit floating point resolution. If disabled, 16-bit PCM data will be used.

ASIO

ASIO (trademark of Steinberg) is an alternative driver model supported mostly by mid- and high-end audio cards. You can use ASIO if your soundcard doesn’t support WASAPI.

Ignore this device: By default, mAirList will ignore all ASIO devices, as it would usually result in a conflict when the device is used in WASAPI mode at the same time (e.g. by being the Windows default device). So if you are going to use this device in ASIO mode, first unckeck this option, then restart the configuration.
Use floating point data (BASS_SAMPLE_FLOAT): If enabled, PCM audio will be passed in 32-bit floating point resolution. If disabled, 16-bit PCM data will be used.
Use a separate thread for processing.: If you are using more than one ASIO device at the same time, they will usually be processed in a common background thread. By checking this option, a separate thread will be used for this particular device.

Sound Processing

6 - Encoder

On this page, you can find the settings for the integrated streaming encoder.

See here for a description of the configuration.

7 - Remote Control

7.1 - Generic

7.1.1 - Hotkey Remote Control

This article covers the configuration of hotkeys for the remote control of mAirList.

Local and Global (System-Wide) Hotkeys

mAirList supports two kinds of hotkeys, represented by two distinct remote control interfaces:

Local: Hotkeys only work when mAirList application is in the foreground and focused.
System-wide: Hotkeys work regardless of whether the mAirList application is in the foreground or background. System-wide hotkeys are always routed to mAirList, so they cannot be used by any other application anymore.

As a thumb rule, use system-wide hotkeys only for very special shortcuts (e.g. Alt+Ctrl+F1) that are not used in any other software. System-wide hotkeys are often used with programmable POS keyboards.

Configuration

In the configuration app or Control Panel, go to Remote Control and add an interface of the desired type (local or system-wide hotkeys).

To add a new shortcut, click the Shortcut field first, then press the desired key or key combination. It will appear in the Shortcut field. Click Add to add it to the list of hotkeys in the upper part of the dialog.

To assign a remote control command to the shortcut, select it from the drop down menu, or type it manually in the table cell next to the shortcut.

7.1.2 - MIDI

7.1.3 - Serial Port

The serial port remote control allows you to receive raw remote control commands over a serial port.

Configuration

Before you can set up this remote control, you must first configure the serial port parameters (baut rate etc.) in the Miscellaneous section of the configuration.

Thereafter you can add the Serial Port remote control interface, and select the appropriate serial port from the list.

Usage

Commands - e.g. PLAYER 1-1 START - must be sent as plain ASCII text, terminated with a CR character (ASCII 13) each.

7.2 - USB

7.2.1 - Joystick

7.2.2 - IO-Warrior

7.2.3 - Velleman K8055

7.3 - Lawo/Studer

7.3.1 - SAS

7.4 - Barth

7.4.1 - D.MAX

7.5 - DHD

7.5.1 - DHD ECP (Series 52, RM4200D, RM3200D)

7.5.2 - DHD RM2200D

7.6 - Network

7.6.1 - REST

7.6.2 - TCP Server

7.6.3 - TCP Client

7.6.4 - UDP Server

7.6.5 - JSON Server

7.6.6 - JSON Client

7.7 - Livewire

7.7.1 - LWRP

7.7.2 - Telos VX (LWCP)

7.8 - Wheatstone

7.8.1 - WheatNet-IP Mixer

7.8.2 - WheatNet-IP BLADE

7.9 - AEQ

7.9.1 - AEQ Virtual GPIO (Capitol IP, Forum IP)

7.10 - D&R

7.10.1 - D&R AIRENCE

7.10.2 - D&R AIRLAB

7.10.3 - D&R AIRLITE

7.10.4 - D&R WEBSTATION

7.10.5 - D&R AXITE/AXUM (MambaNet)

7.11 - Sonifex

7.11.1 - Sonifex S0

7.12 - Ember+

7.12.1 - Ember+ Consumer

8 - Databases

9 - Background Scripts

10 - Logging

11 - Actions

12 - Voice Tracking

13 - Regionalization

14 - Stream Monitor

15 - Miscellaneous

15.1 - Serial Ports

15.2 - Passwords

15.3 - System Log

15.4 - File Import

15.5 - File Management

15.6 - Hooks

15.7 - Audio Editor

15.8 - Default Directories

15.9 - Auto Cue

15.10 - Normalization

15.11 - E-Mail

15.12 - Runtime Features

15.13 - Settings

15.14 - Options

16 - Advanced

17 - Common Settings

This chapter contains a description of settings that are available in multiple parts of the software. For example, the Progress Bar options are available for both the progress bar in the playlist, the players, and the global progress bar object.

Time Formats

Time format strings (for elapsed and remaining time, ramp, etc.) can use the following variables:

hh - hour
nn - minute
ss - second
z - 1/10th of a second
zz - 1/100th of a second
zzz - milliseconds

These variables (with the exception of z and zz) correspond to those used by the Delphi FormatDateTime function.

An optional ! sign marks the boundary up to which the “Automatically truncate…” options will operate. The part after the ! sign will never be truncated. For example, the format hh:n!n:ss will display a duration of 3 seconds as 0:03.

Progress Bar

Enable progress bar: Uncheck to hide the progress bar.
Show ramp in progress bar: If enabled, the ramp part of the item will be displayed in a different color.
Split progress bar during ramp: If enabled, the progress bar will be split horizontally while the ramp part is playing, with the upper part representing the ramp.
Show only nearest ramp: If enabled, only the next ramp marker that is reached next from the current playback position will be displayed (for items that have more than one Ramp cue marker set).

Waveform

Enable waveform display: Toggles the display of the waveform in the player.
Live update: When enabled, cue markers will be updated immediately as they are dragged, not only when you release the mouse button.
Show current position as line: Toggles the display of the current playback position.
Show segment before current position using a different color: If enabled, a different dark-ish color is used for the elapsed part of the playback, so the waveform can be used as some kind of progress bar.
Show cue markers: If enabled, the set cue markers will be displayed as colored lines.
Show cue marker labels: Check this option to display the name of the cue markers next to the colored lines.
Show cue marker position: Check this option to display the position/value of the cue markers next to the colored lines.
Show fade envelope: If enabled, a graphical representation of the fade (after the Fade Out marker) will be displayed.
Show volume envelope: Enables display end editing of the volume envelope.
Show timeline: Enables dispaly of the timeline at bottom of the waveform.
Show scrollbar: Enables a horizontal scrollbar.
Mouse navigation: If enabled, the user can use the mouse to navigate through the waveform (mouse wheel to to zoom, click and hold to move around).
Allow seek on mouse click: If enabled, the current playback position can be set by clicking into the waveform.
Read only: Checking this option makes the entire waveform read only, e.g. no cue markers, volume envelopes etc. can be adjusted.

Peakmeter

Enable peakmeter: Uncheck to hide the peakmeter.
Show clipping indicator: If checked, a red clipping indicator will be displayed that flashes when the signal exceeds 0 dBFS.