Chapter 8. Configuration

Table of Contents

8.1. Playlists
8.2. Player
8.2.1. Output Devices
8.3. Cartwall
8.4. Browser
8.5. Remote Control
8.5.1. Hotkeys
8.5.2. Joystick/Gameport
8.5.3. MIDI
8.5.4. Network
8.5.5. SAS
8.6. HotDirs
8.7. Logging
8.7.1. Start and Stop Logging
8.7.2. Database Logging
8.8. Databases
8.8.1. iTunes
8.8.2. eldoDB
8.8.3. radioDB
8.8.4. On-the-fly Databases
8.9. Scripting
8.10. BASS.DLL
8.11. Miscellaneous
8.12. Advanced Options
8.12.1. Preferred Default Directories
8.12.2. Customizing the Toolbars

mAirList does not store its configuration in the Windows Registry, but in the configuration file mAirList.ini, located in the same directory as mAirList.exe. That file is read by mAirList when the program starts. Changes to the configuration cannot be made during run-time, but you have to restart mAirList in order to reload the changed configuration (though a number of options can be changed while mAirList runs, such as the appearance of the playlist, the automation mode, and so on).

Configuration is assisted by the configuration dialog, displayed when mAirList.exe is run with the -config parameter. For your convenience, a batch filed named mAirListConfig.bat is supplied in the distribution archive that runs mAirList with this parameter.

The configuration dialog is divided into various categories, which can be accessed through the left-hand menu tree, and which are described in the following sections.

8.1. Playlists

The playlist is the most important element in mAirList's main window. It holds the scheduled playlist items and distributes them among the assigned players. By default, mAirList displays one main playlist, but you can choose to set up multiple playlists.

mAirList as a Standalone Cartwall

You can also set the number of playlists to 0. In that case, mAirList will turn into a pure cartwall.

For each defined playlist, there is an item in the menu tree on the left of the configuration dialog, displaying the playlist options page. In particular, the following settings can be made:

Player count

Each playlist goes along with a number of players which are used to broadcast the elements in the playlist. For each player, a new item appears in the menu tree, from which you can access the player details page (see below).

Number of items to keep in the playlist history

Set the number of items to keep in the main playlist after having been played. The items are drawn in gray at moved to the Played Items list later. Set to 0 to move any played item to the Played Items list immediately.

The further options are:

Extended display mode*

If checked, mAirList uses a two rows to display each playlist item (one for the title, one for the artist). Otherwise, title and artist are displayed in the same row.

Backtiming display*

If checked, the first column is used to display the scheduled, real or calculated starting time of each item.

Display progress bar*

If checked, an additional progress bar is displayed below the playlist item while it is playing in one of the players.

Show playlist item comments*

This option must be checked in order to make the playlist item's comment appear in the playlist.

Allow automation

Uncheck this option to prevent the user from activating the automation mode.

Separate ASSIST/AUTO buttons

If checked, two buttons labeled “ASSIST” and “AUTO” will be displayed to switch between assist and autmation mode. Otherwise, there's only one button to toggle between these modes.

Toolbar position: bottom

Display the playlist toolbar below the playlist instead of above the playlist (which is the default).

Clear history when opening or starting a new file

If checked, the playlist history is cleared when you start a new file or open a playlist.

Always show duration

If checked, “0:00:00” is displayed in the duration column if the duration of an item is unknown or unset. Otherwise, the cell is left blank.

Always show ramp

If checked, “0:00” is displayed in the ramp column if no ramp is set. Otherwise, the cell is left blank.

Spacebar triggers AUTOMATION NEXT

If checked, the spacebar can be used in automation mode to fade out the current and start the next item.

The options marked with * can be toggled at run-time through the playlist context menu.

Finally, you can specify the prefixes to use in the left-most playlist column in backtiming mode depending on the type of starting time calculated for an item: Fixed (if a fixed time was entered in the Properties dialog), absolute (real time, calculated from the real starting time of the active player), or relative (offset from the top of the playlist).