Get the global settings (in-memory snapshot)

GET /settings

Get the global settings (in-memory snapshot)

cURL

curl --request GET \
  --url http://localhost:6063/settings

200

{
  "music_dir": "/Users/tsirysandratraina/Music",
  "volume_limit": 320,
  "balance": 0,
  "bass": 1,
  "treble": 0,
  "channel_config": 0,
  "stereo_width": 100,
  "crossfade": 5,
  "crossfade_fade_in_delay": 7,
  "crossfade_fade_out_delay": 7,
  "crossfade_fade_in_duration": 1,
  "crossfade_fade_out_duration": 1,
  "playlist_shuffle": false,
  "repeat_mode": 846620009,
  "eq_enabled": true,
  "eq_precut": 7,
  "eq_band_settings": [
    {
      "cutoff": -16,
      "q": 64,
      "gain": 10
    },
    {
      "cutoff": 9,
      "q": 125,
      "gain": 10
    },
    {
      "cutoff": 21,
      "q": 250,
      "gain": 10
    },
    {
      "cutoff": 9,
      "q": 500,
      "gain": 10
    },
    {
      "cutoff": -35,
      "q": 1000,
      "gain": 10
    },
    {
      "cutoff": -81,
      "q": 2000,
      "gain": 10
    },
    {
      "cutoff": -41,
      "q": 4000,
      "gain": 10
    },
    {
      "cutoff": 1,
      "q": 8000,
      "gain": 10
    },
    {
      "cutoff": 15,
      "q": 16000,
      "gain": 7
    },
    {
      "cutoff": 24,
      "q": 0,
      "gain": 0
    }
  ],
  "replaygain_settings": {
    "noclip": true,
    "type": 0,
    "preamp": 0
  },
  "compressor_settings": {
    "threshold": -24,
    "makeup_gain": 0,
    "ratio": 4,
    "knee": 1,
    "release_time": 300,
    "attack_time": 5
  },
  "dithering_enabled": true,
  "timestretch_enabled": false,
  "play_frequency": 3400,
  "surround_enabled": 0,
  "surround_balance": -25
}

Response

200 - application/json

Settings

Live global_settings snapshot. Fields mirror apps/settings.h.

music_dir · string

audio_output · enum<string>

Available options: builtin, fifo, airplay, squeezelite, chromecast, snapcast_tcp, upnp

volume · integer<int32>

volume_limit · integer<int32>

balance · integer<int32>

channel_config · integer<int32>

stereo_width · integer<int32>

playlist_shuffle · boolean

repeat_mode · integer<int32>

crossfade · integer<int32>

eq_enabled · boolean

eq_precut · integer<int32>

eq_band_settings · object[]

Show child attributes

replaygain_settings · object

Show child attributes

compressor_settings · object

Show child attributes