Skip to content

sound_system_tracks:

This is a config file reference. Click for instructions.

This page is reference material which explains every setting and option for this section of an MPF yaml config file. See the instructions for config files for formatting and other details. See our guide to config file examples for more examples of real configs in action.

Valid in
machine config files NO 🚫
mode config files NO 🚫

The tracks: settings in your sound_system: section of your config is where you configure which tracks exist in your machine.

Optional settings

The following sections are optional in the sound_system_tracks: section of your config. (If you don't include them, the default will be used).

crossfade_time:

Single value, type: time string (secs) (Instructions for entering time strings). Default: 0

Time to crossfade between to songs on your playlist.

The settings is specific to playlist audio tracks. It will ignored in other track types.

ducking:

Single value, type: sound_ducking:.

Default ducking settings for this track. Those can be overwritten per sound. See ducking for details.

events_when_paused:

List of one (or more) events.

A list of one or more names of events that MPF will post when the track is paused. Enter the list in the MPF config list format. These events are posted exactly as they're entered.

events_when_played:

List of one (or more) events.

A list of one or more names of events that MPF will post when the track is played or resumed after being stopped/paused. Enter the list in the MPF config list format. These events are posted exactly as they're entered.

events_when_resumed:

List of one (or more) events.

A list of one or more names of events that MPF will post when the track is resumed. Enter the list in the MPF config list format. These events are posted exactly as they're entered.

events_when_stopped:

List of one (or more) events.

A list of one or more names of events that MPF will post when the track is stopped. Enter the list in the MPF config list format. These events are posted exactly as they're entered.

max_layers:

Single value, type: integer. Default: 8

Maximum number of layers in your loop which can play in parallel.

The settings is specific to sound_loop audio tracks. It will ignored in other track types.

simultaneous_sounds:

Single value, type: integer. Default: 8

This sets the maximum number of simultaneous sounds that can be played on this track. The example config file above shows the music and voice tracks with a max of 1 simultaneous sound playing, since if you have two music clips or voice callouts playing at the same time, it will sound like gibberish. A sound effects track, on the other hand, can probably have a few sounds playing at once. Note that MPF gives you detailed control over what happens if a new sound wants to play when the max simultaneous sounds are already playing on that track. Should the new sound break in and stop an existing sound? Should it wait until the existing sound is done? How long should it wait? You can control all this on a per sound basis (see the :doc:\~sounds: \~ documentation for more information).

The settings is specific to standard audio tracks. It will ignored in other track types.

type:

Single value, type: one of the following options: standard, sound_loop, playlist. Default: standard

The track type: setting determines what type of audio track will be used. For more detailed

volume:

Single value, type: gain setting (-inf, db, or float between 0.0 and 1.0). Default: 0.5

This is the volume setting for this track (how loud will it be), as either a value between 0.0 and 1.0 or a decibel value between -inf and 0.0 db. Note that each track's volume will be combined with the overall system volume. So if your MPF master volume is set to 0.8 (80%) and you have a track set to 0.5 (50%), sounds on that track will play at 40% overall volume (50% of 80%).


Something missing or wrong? You can fix it!

This website is edited by people like you! Is something wrong or missing? Is something out of date, or can you explain it better?

Please help us! You can fix it yourself and be an official "open source" contributor!

It's easy! See our Beginner's guide to editing the docs.

Page navigation via the keyboard: < >

You can navigate this site via the keyboard. There are two modes:

General navigation, when search is not focused:

  • F , S , / : open search dialog
  • P , , : go to previous page
  • N , . : go to next page

While using the search function:

  • Down , Up : select next / previous result
  • Esc , Tab : close search
  • Enter : go to highlighted page in the results