Playback 
Section titled “Playback ”Settings → Players → Playback holds the defaults every player follows. The behaviour when playing or enqueuing items is determined by the settings on this page. Smart shuffle, autoplay, crossfade and volume normalization are set on a global level here and can be overridden for each player in its own playback settings. Only administrators see this page.
Some settings are only shown when the Show advanced settings toggle in the header of the Options card is on, and the toggle is remembered for your user.

Generic
Section titled “Generic”- Volume step size. Defaults to zero which enables an adaptive mode where the step size is smaller at the ends of the range. When set, this determines how much the volume change when an up or down command is received (e.g. mouse wheel click, slider tap, HA action)
Items to select
Section titled “Items to select”- Items to select when you play a (in-library) artist. The options are
All tracks from all providers [default],Artist top tracks only,In-library tracks for the artist onlyandPrefer library, fall back to top - Order to play an artist in. The options are
Shuffled tracks [default],Albums in random order, each album in track orderandAlbums by release year, oldest first.Shuffled tracksplays the tracks picked by the artist selection in random order. The album orders play the artist’s albums one after another, either picked at random or from the oldest to the newest, with albums without a year last - Items to select when you play a (in-library) album. The options are
All tracks for album on (streaming) provider [default]andOnly in-library tracks
With either album order:
- The artist selection picks the artist’s own albums. The in-library selections play the albums in your library.
All tracks from all providersalso plays the albums found only on a provider. - Each album plays as it does on its own, following Items to select when you play a (in-library) album.
- Each album plays once, even when your library and a provider both have it.
- If one copy of an album can’t play, another copy plays instead. With
Only in-library tracksas the album selection, an album in your library plays only your saved tracks. - Singles are left out, as their songs are mostly on the albums.
- Compilations in your library still play. Compilations found only on a provider are left out, as their songs are already on the albums.
Artist top tracks onlystill plays shuffled tracks.- An artist without albums plays shuffled tracks instead. For example, an artist with only singles, or one that only appears on another artist’s albums. If the artist’s albums can’t be listed because a provider is offline or fails, and your library has none of them, nothing plays.
An album order switches shuffle off for the queue, as when you play an album. An artist without albums keeps the queue’s shuffle, and so does Artist top tracks only. Asking for shuffle when you start the artist still shuffles it. The setting does not apply to authors and narrators, as they play audiobooks.
Default enqueue option
Section titled “Default enqueue option”What happens to the queue when an item is played. There is one setting each for Artist, Album, Track, Genre, Playlist, and Radio and Live Input items (radio stations and live sources such as Spotify Connect and AirPlay Receiver). Each can be Play (and replace queue) or Play (and keep queue). Tracks default to keeping the queue and everything else defaults to replacing it.
Click actions
Section titled “Click actions”- What clicking an artist / album / track / genre / radio / playlist does. One setting per item type.
Open it [default]opens the item,Play itstarts playing it straight away - What playing a track from an album does.
Play from this track onwards [default]continues with the rest of the album,Play only this trackplays just the chosen track - What playing a track from a playlist does. The same two options, for tracks in a playlist
Smart shuffle
Section titled “Smart shuffle”Smart Shuffle enhances standard shuffle behavior by intelligently reducing repetition. Instead of selecting tracks purely at random, songs and artists that have been played recently are deprioritized, resulting in a more evenly distributed listening experience and reducing the likelihood of the same tracks being repeated when playlists are replayed. Smart Shuffle is always applied when playing a dynamic playlist, regardless of this setting.
- Smart shuffle.
Disabled [default]orEnabled. When enabled, the shuffle button uses Smart Shuffle instead of a plain random shuffle - Avoid replaying the same song heard within. How long a song that has already been heard is pushed toward the back of the queue. From
Offto4 weeks, default1 week - Avoid replaying the same artist heard within. The same for artists. From
Offto2 hours, default30 minutes - Minimum gap before repeating a deliberately-duplicated song. When the same song is added to the queue more than once on purpose, this is the shortest time before it may play again. From
Offto24 hours, default3 hours. Setting is only visible when the advanced toggle is on
Optimize order for Smart Fades is an optional Smart Shuffle setting. When Smart crossfade is active, Music Assistant uses existing Smart Fades analysis to arrange upcoming tracks so Smart Fades has a better chance of creating a smooth transition between consecutive tracks. It considers tempo, musical key and how the energy changes from the end of one track to the start of the next. Songs and artists played recently are still deprioritized according to the Smart Shuffle settings. No new analysis is started for this, and tracks without analysis are neither preferred nor penalized. Smart Fades still decides how the actual transition is mixed when the tracks play.
Autoplay
Section titled “Autoplay”A setting is available to enable Autoplay by default on all queues. Each queue can still turn it on or off from the player controls, and Autoplay is always active when a dynamic playlist is playing. The Autoplay source setting has five options as follows:
-
Automatic — similar tracks, falling back to your library (default). New tracks similar to what was recently played are requested from the music providers. If no provider is able to supply similar-track recommendations (for example, when only local files are used), an endless mix drawn from the library is used instead, so playback will not stop
-
Similar to what you played. Tracks that resemble the most recently played items in the queue are fetched from the connected music providers and appended to the queue. This mode relies on a provider that offers similar-track recommendations; if none is available, no tracks are added
-
Infinite mix from your library. Tracks are selected from the local library, with preference given to those that have been played the least. The selection is biased towards the genres of the items that were played most recently; when too few matching tracks are found, the mix is topped up with random tracks from across the whole library.
-
Tracks from a playlist. Tracks are taken from the playlist chosen in the Autoplay playlist box, which appears when this option is selected
-
Similar artists. When the queue runs out, a similar artist of the last track’s artist is added, one with no track in the queue yet. It is queued the same way as playing that artist. With an album order in Order to play an artist in, all its albums play whole, one after the other, if shuffle is off. Autoplay does not change the queue’s shuffle. If no similar artist is left, no tracks are added. This option needs a music provider that supplies similar artists
Crossfade
Section titled “Crossfade”Crossfade can be enabled or disabled by default on all queues via a setting here and also can be turned on and off via the button at the top of the Now Playing view. Which crossfade mode will be enabled can be set here on a global level but can be overridden on a per player basis as well. Smart crossfade is the default. Smart Fades automatically analyzes each track’s tempo and beats to create seamless, musically aligned transitions between songs. It adjusts BPM, aligns downbeats, and applies EQ-based mixing for smoother fades—falling back to standard crossfade if analysis fails. Standard crossfade smoothly overlaps the end of one song with the start of the next using a simple volume fade. The Standard crossfade duration (default 8 seconds) appears when Standard crossfade is selected, and this is the only place it can be set.
- Allow crossfade between tracks from the same album. Not enabled by default as it may not be desirable particularly for live albums
Volume normalization
Section titled “Volume normalization”Volume normalization (EBU-R128 based). Volume Normalization is enabled by default and works to eliminate volume differences between media items and sources. It can be overridden on an individual queue basis.
How it is done is set with Volume normalization method for tracks and Volume normalization method for radio streams, which you set independently.
The best result comes from a loudness measurement of the audio. Tracks tagged with ReplayGain or R128 loudness values supply one directly, and Music Assistant uses those in preference to measuring anything itself. Everything else it measures on its own: your local library automatically in a nightly background scan, and anything played, including streaming services, while it plays, so those are covered from the second play onwards. The options differ mainly in what happens before a value exists:
- Fallback dynamic (default) — use the measurement when there is one, otherwise adjust loudness on the fly. Always evens things out; the on-the-fly path is slightly less precise and can be heard as the volume drifting during a track the first time it is played
- Fallback fixed gain — use the measurement when there is one, otherwise apply the fixed adjustment below
- Measured loudness — only adjust when a measurement exists. Anything not yet analysed plays at its original loudness
- Dynamic — always adjust on the fly, ignoring measurements
- Fixed gain — never analyse; apply the same fixed adjustment to everything
- Disabled — leave loudness untouched
Once a measurement exists it is used, whichever of the two fallback options is selected. Two other things are worth knowing: live radio is rarely measured, so the radio setting in practice runs on whichever fallback you choose, and volume normalization also has to be switched on for the player itself. These settings control how it’s done, not whether. How the value is chosen, and when album gain is used instead of track gain, is covered on the Technical Information page.
Fixed/fallback gain adjustment for tracks / radio streams.
How much to raise or lower the volume, in dB, whenever the fixed-gain path is used. That’s either the Fixed gain method, or Fallback fixed gain when no measurement is available. Negative values make things quieter. The range is −20 to +10 dB and the default is −6. Other methods ignore it. Again, separate values exist for tracks and radio.

- Target level for volume normalization. The loudness, in LUFS, that volume normalization aims for. The default is -14 LUFS and a value between -23 and -12 LUFS is recommended. See Technical Information. Setting is only visible when the advanced toggle is on
Playback
Section titled “Playback”- Stop a paused player after (seconds). How long a player may stay paused before Music Assistant stops it to free the audio it holds. It starts at 30 seconds. Once stopped, the player shows as idle, and pressing play still continues where you paused. Not every player can stay paused for long. Setting is only visible when the advanced toggle is on
- Audio buffer size. Controls how much audio is buffered in memory. A larger buffer improves playback stability and seeking but uses more memory. The options are
Maximum [default],MinimalandBalanced. The options are filtered depending upon system RAM. Minimal (60s buffer) is always available, Balanced (300s) requires a nominal 4 GB of RAM, and Maximum (1200s) requires a nominal 8 GB of RAM. If total memory can’t be determined then all three presets are offered although the default in that case is, conservatively, Minimal.
Announcements
Section titled “Announcements”- Announcement text-to-speech engine. Which engine is used to generate announcements sent from within Music Assistant. The engines on offer come from your plugins, such as the Home Assistant Plugin. Unless you pick one, it follows the default text-to-speech engine from Settings → AI
This website uses privacy-first analytics to help us improve the site. You can view all data in our public dashboard.
