> ## Documentation Index
> Fetch the complete documentation index at: https://rockboxzig.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get the global settings (in-memory snapshot)



## OpenAPI

````yaml /api-reference/openapi.json get /settings
openapi: 3.1.0
info:
  title: Rockbox HTTP API
  version: 1.0.0
  summary: >-
    HTTP REST API for rockboxd — playback, library, playlists, devices,
    settings.
  description: >-
    Rockbox Daemon exposes its full feature surface over HTTP REST on port 6063
    (configurable via `ROCKBOX_TCP_PORT`). It complements the GraphQL API on
    :6062 and the gRPC API on :6061 — all three speak to the same in-process
    state.


    All handlers are defined in `crates/server/src/handlers/` and registered in
    `crates/server/src/lib.rs:run_http_server()`.
  contact:
    name: Rockbox Daemon
    url: https://github.com/tsirysndr/rockboxd
  license:
    name: GPL-2.0
    url: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
servers:
  - url: http://localhost:6063
    description: Default local rockboxd
security: []
tags:
  - name: Albums
  - name: Artists
  - name: Tracks
  - name: Search
  - name: Browse
  - name: Player
  - name: Playlist (queue)
  - name: Saved playlists
  - name: Smart playlists
  - name: Track stats
  - name: Devices
  - name: Settings
  - name: System
  - name: Bluetooth
paths:
  /settings:
    get:
      tags:
        - Settings
      summary: Get the global settings (in-memory snapshot)
      operationId: getSettings
      responses:
        '200':
          description: Settings
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GlobalSettings'
              example:
                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
components:
  schemas:
    GlobalSettings:
      type: object
      description: Live `global_settings` snapshot. Fields mirror `apps/settings.h`.
      additionalProperties: true
      properties:
        music_dir:
          type: string
        audio_output:
          type: string
          enum:
            - builtin
            - fifo
            - airplay
            - squeezelite
            - chromecast
            - snapcast_tcp
            - upnp
        volume:
          type: integer
          format: int32
        volume_limit:
          type: integer
          format: int32
        balance:
          type: integer
          format: int32
        channel_config:
          type: integer
          format: int32
        stereo_width:
          type: integer
          format: int32
        playlist_shuffle:
          type: boolean
        repeat_mode:
          type: integer
          format: int32
        crossfade:
          type: integer
          format: int32
        eq_enabled:
          type: boolean
        eq_precut:
          type: integer
          format: int32
        eq_band_settings:
          type: array
          items:
            $ref: '#/components/schemas/EqBandSetting'
        replaygain_settings:
          $ref: '#/components/schemas/ReplaygainSettings'
        compressor_settings:
          $ref: '#/components/schemas/CompressorSettings'
    EqBandSetting:
      type: object
      properties:
        cutoff:
          type: integer
          format: int32
          description: Centre / cutoff frequency in Hz
        q:
          type: integer
          format: int32
          description: Q × 10 (fixed-point)
        gain:
          type: integer
          format: int32
          description: Gain × 10 in dB (fixed-point)
    ReplaygainSettings:
      type: object
      properties:
        noclip:
          type: boolean
        type:
          type: integer
          format: int32
          description: 0=Track 1=Album 2=Track-shuffle 3=Off
        preamp:
          type: integer
          format: int32
          description: dB × 10
    CompressorSettings:
      type: object
      properties:
        threshold:
          type: integer
          format: int32
          description: dB
        makeup_gain:
          type: integer
          format: int32
        ratio:
          type: integer
          format: int32
        knee:
          type: integer
          format: int32
        release_time:
          type: integer
          format: int32
          description: ms
        attack_time:
          type: integer
          format: int32
          description: ms

````