Skip to content

Settings Guide

Elijah Lopez edited this page Dec 24, 2024 · 20 revisions

This page exists to provide some clarity for some settings that can be changed in the settings tab. Also listed on this document are some settings fields that can only be modified in settings.json.

Populate Queue on Startup

Shuffle queues the music files in the music folders you have selected when Music Caster starts.

Save Queue Between Sessions

The next time Music Caster starts, the music queue is the same as the last time/state Music Caster was running.

This settings overrides "Populate Queue on Startup"

Smart Queue

Auto-skips tracks that have been skipped manually 3 times before 5 seconds. The counter is reset if the track is consciously selected by the user. It can't read your mind unfortunately, so this is good for people who like to offload music selection to the player rather than choose what tracks to play every session.

Reversed Play Next

When this setting is enabled, whichever track is selected to be played next, will be played ahead of the previous track selected to be played next. By default, this setting is disabled, imitating the behaviour of Spotify. I like this personally, but most music players use the most recently selected behaviour.

Left-Side Music Controls

The controls that are by default on the right side (now playing, volume slider, scrubber) show up on the left side. Applies to the mini-mode as well.

Use Cover.* For Album Art

If a cover.png, cover.jpg, or cover.jpeg exists in the same folder as the file being played, use that as the album cover instead of the files' own embedded album cover.

Exit app on GUI close

When this setting is checked, whenever the user closes the GUI, the app itself exits. This setting is unchecked by default.

Show Track Number

Shows the track number of files in the queue (e.g. [1] Artist - Title) and for the current track playing (e.g. 3. Artist - Title).

Settings.json

In addition to the settings that can be changed in the window, there are some that can be modified in the settings.json file for finer control.

Track Format

Format how tracks in the queue will show up using &trck for track number, &title for title, &artist for artist. &alb has been supported since v5.5.3.

"track_format": "&artist - &title"

Theme [Experimental]

This changes the appearance of the native GUI.

    "theme": {
        "accent": "#00bfff",
        "background": "#121212",
        "text": "#d7d7d7"
    }