skin.ini Reference

The skin.ini file must be located in the config folder, along with the other ini files managed by the configuration software (e.g. mAirList.ini). You must create it manually using a text editor.

The file uses the typical syntax for .ini files:

[Section1]
Key1=Value
Key2=Value

[Section2]
Key1=Value
Key2=Value

The available section names and key names are given in the reference below.

Please note that some settings currently do not work as described. This mainly concerns the “can be left empty” descriptions.
If you cannot achieve the desired effect here, the entry for each status has to be entered individually. The corresponding passages are – temporarily – crossed out.
We apologize for the inconvenience and ask for your understanding.

All colors are specified in HTML color format, with six hex digits, e.g. #FF0000.

For all fonts, there are four available settings:

In the reference below, we will only give the base name of the font setting, e.g. TitleFont – the available settings are then TitleFontName, TitleFontSize, TitleFontColor and TitleFontStyle.

The following settings can be used to change the appearence of the progress bar in the Playlist, Player, Cartwall and ProgressBar (for the global progress bar) sections.

The following settings apply to all “graphical” buttons (not standard Windows buttons), e.g. the start/stop/… buttons of the players, and toolbars built from these buttons (e.g the playlist control bar).

The button settings are prefixed by a particular button identifier as specified below, e.g. PlayButtonActiveFontName.

The available states are:

You can also leave out the <State> part in the rule name to adjust the settings for all states at the same time. Use only Button as button identifier prefix, e.g. ButtonFontName.

The following settings apply to all toolbars made of graphical buttons – currently only used for the Cartwall toolbar. The individual buttons can be adjusted by prepending their <ID> to the particular settings.

All tree- and list-like components (e.g. the playlist, browsers, …) have a couple of common settings that can be used in the appropriate settings:

For the general settings, use the section [MainWindow].

The section [Toolbar] controls the appearance of the toolbar in the main playout window.

You can also hide the individual buttons in the toolbar (and the separators between them) by setting any of the following values to off:

Use section [Playlist] for settings that will effect all playlists, [Playlist0] only for the first playlist, [Playlist1] for the second, and so on.

The following settings can be used to change the appearance of the rows in the playlist:

Selectors allow you to specify settings that only affect particular rows, based on their type, state, etc. If you are familiar with HTML/CSS, this is pretty much like HTML classes and CSS class selectors.

For example, to change only the font of the “Title” column, use:

TitleFontName=Arial

Another example: Set the background to red for all items that are currently playing:

PlayingRowColor=#FF0000

You can also combine the various selector options – change the font style of the “Title” column for items that are currently playing:

PlayingTitleFontStyle=1

Generally, the selector for RowColor and RowPadding rules has the following form:

[Alternate]<Player State><Item Type><Item Class><Level>

For Font rules, there is an extra Font Category component:

[Alternate]<Player State><Item Type><Item Class><Font Category><Level>

The available options for the various components are described below. You can leave out any component, e.g. Player State, in which case the line will match all player states.

Remember that the skin.ini file is parsed from top to bottom. If there are multiple lines that match a particular row, the last line will have effect. So you should put more general rules to the top, and more specific rules to the bottom of the list.

Rules starting with Alternate will only affect every other row – they allow you to create a striped table like this:

RowColor=#FFFFFF
AlternateRowColor=#F0F0F0

(Note that the – more general – RowColor rule comes first, it would override the AlternateRowColor rule otherwise.)

The following values can be used for Player State in order to select a row based on the state of the player in which the item is loaded:

There are two special “Player State” values that are used for rows that do not represent playlist items:

This component selects a row based on the Item Type as set in the item properties. Currently, the following values are available:

Unknown
Music
Voice
News
Weather
Traffic
Advertising
Package
Jingle
Sound
Effect
Trailer
Promo
Sponsorship
Sweeper
Drop
StationID
Bed
Instrumental
Show
Stream
Container
Playlist
Command
Break
Dummy
Silence
Error
Other
Custom1
Custom2
Custom3

In addition to the Item Type (which the user can edit in the Properties dialog), you can also select rows based on the Class of the playlist item:

File
Stream
Break
Command
Container
Dummy
Other

The following fonts can be adjusted through the skin:

When the Expandable Containers GUI option is turned on, and you click the + button to expand a container, there will be a hierachy of playlist items, and the playlist will act like a tree. (And the container could have another container inside!)

The optional Level component in the selector allows you to define rules only for a particular level in that tree, e.g. to use a smaller font for the items inside the container. Level 0 is the top level, level 1 is for the items inside a container on top level, level 2 for items inside a container inside a container and so on.

DefaultRowColor and RowColor appear to do the same thing, as they define the color for all nodes that have no specific skin.ini setting (note that RowColor has an empty selector, so it matches all rows). But there are two differences:

1. DefaultRowColor only affects playlist item nodes, no “region” or “underrun” nodes.
2. When the GUI option /Item-specific colors have priority over skin.ini/ is turned off (so that skin has always priority over item-specific colors/, and you have a plain RowColor rule, that rule would always override the item-specific colors. Use DefaultRowColor instead in this situation (it has always lower priority than the item-specific color).

The following settings control the position and appearence of the ramp/EOF overlay display:

Use the progress bar color settings described in the General section above.

To adjust the control bar (toolbar) of the playlist, add section [PlaylistToolbar] and use the following settings:

The available buttons are:

You can leave out the <Button> part to adjust all buttons at the same time.

Use the section [Player] to adjust the appearance of all players, [Player0_0] only for the first player of the first playlist (PLAYER 1-1, in terms of remote control), and so on.

The background color of the player can be adjusted with the following settings:

Unfortunately, the following option is currently not available due to changes in mAirlist skin programming.
Player State can be left empty to adjust all colors at the same time, or use one of the following values:

The fonts for the individual states can be adjusted as follows:

where <Font Category> is one of the following (or empty to adjust all fonts at the same time):

For <Player State> use one of the values from the table in the Colors section above, or leave empty to adjust all states at the same time.

Use the progress bar color settings described in the General section above.

Use the waveform settings described in the General section above, prefix all settings with Waveform, e.g. WaveformInactiveColor=….

See the list in the General section for the available button settings.

<Button> can be one of the following (or empty to adjust all buttons at the same time):

(todo)

Cartwall settings go into the [Cartwall] section.

The following colors can be adjusted based on the current “on air” mode:

where <Mode> is empty (adjust all modes at the same time) or one of the following:

Work in progress, reference might be incorrect.

These settings take effect from Version 6.2 Build 4111 on.

TabColorBackground takes precedence over TabColorActive and TabColorBrdBottom.
TabColorBrdBottom takes precedence over TabColorBrdInActive.

The color of TabColorBrdHot changes the border color of the empty “new page” tab.

Use the settings described in the General section of this document,

To hide the cartwall toolbar, please use ToolbarVisible=off in the [Cartwall] section (see above).

The cartwall toolbar can be adjusted through the [CartwallToolbar] section. For the settings, see section Button toolbars above. The IDs of the available buttons/elements in the toolbar are:

Menu
Favorites
NewPage
OpenPage
SavePage
DesignMode
Color
Waveform
OnAir
PFL
Next

Unless otherwise noted, all settings go into the [Browser] section.

You can also adjust the tree/list colors as described in the General section.

The following settings have only effect for the “new-style” browser window:

The settings for the browser toolbar go into the [BrowserToolbar] section.

For the Library browser and Playlist view in the mAirListDB window, there are

The settings go either into the [DatabaseLibrary] (Library list only), [DatabaseTree] (Library tree), [LibraryPlaylist] (playlist) or [Database] (all three) section.

Some of the custom screen objects have additional skin settings.

Section name for this settings is [EncoderStatus].

The Mix Editor will respect all color settings in the [Waveform] section. See section on Waveform above. There are some extra color settings for the Mix Editor:

Mix-Editor-specific color settings can be added to the [MixEditor] section:

[MixEditor]
WaveformInactiveColor=#000000

The Mix Editor in v6.0 and above allows editing of nested playlist items (containers). You can use separate settings for nested items by specifying the level number (first level has index 0):

[MixEditor]
Waveform0InactiveColor=#000000
Waveform1InactiveColor=#0F0F0F

The toolbar of the Mix Editor can be adjusted through the [MixEditorToolbar] section (see Button Toolbars above).

Names of the buttons are, from left to right:

Pause
Play
Elapsed
Total
JumpPrevious
JumpNext
ZoomIn
ZoomOut
ZoomOutFull
Undo
Redo
OK
Cancel