# app.rocksky.rockbox.defs

> Published by [rocksky.app](https://lexicon.garden/identity/did:plc:vegqomyce4ssoqs7zwqvgqty)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.rockbox.defs)
- [Documentation](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.rockbox.defs/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.rockbox.defs/examples)

## Definitions

### `app.rocksky.rockbox.defs#settingsView`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `tone` | `ref` → `app.rocksky.rockbox.defs#toneSettings` | No | Tone control settings (bass, treble, balance, channels) |
| `createdAt` | `string` (datetime) | Yes | When this settings record was first created. |
| `crossfade` | `ref` → `app.rocksky.rockbox.defs#crossfadeSettings` | No | Crossfade settings |
| `equalizer` | `ref` → `app.rocksky.rockbox.defs#equalizerSettings` | No | Equalizer settings |
| `updatedAt` | `string` (datetime) | No | When this settings record was last updated. |
| `replayGain` | `ref` → `app.rocksky.rockbox.defs#replayGainSettings` | No | Replay gain settings |

### `app.rocksky.rockbox.defs#toneSettings`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `bass` | `integer` | No | Bass level in dB |
| `treble` | `integer` | No | Treble level in dB |
| `balance` | `integer` | No | Left/right balance. Negative = left, positive = right |
| `channels` | `string` | No | Channel configuration: stereo \| mono \| monoLeft \| monoRight \| karaoke \| wide |

### `app.rocksky.rockbox.defs#equalizerBand`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `q` | `integer` | Yes | Q factor × 10 (e.g. 7 = Q 0.7) |
| `gain` | `integer` | Yes | Band gain in tenths of dB (e.g. 30 = +3.0 dB) |
| `frequency` | `integer` | Yes | Center frequency in Hz |

### `app.rocksky.rockbox.defs#crossfadeSettings`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `mode` | `string` | No | Crossfade mode: disabled \| enabled \| shuffle \| albumChange \| trackChange |
| `fadeInDelay` | `integer` | No | Fade-in delay in ms |
| `fadeOutDelay` | `integer` | No | Fade-out delay in ms |
| `fadeInDuration` | `integer` | No | Fade-in duration in ms |
| `fadeOutMixMode` | `string` | No | Fade-out mix mode: crossfade \| mix |
| `fadeOutDuration` | `integer` | No | Fade-out duration in ms |

### `app.rocksky.rockbox.defs#equalizerSettings`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `bands` | `array` | No | Up to 10 EQ bands |
| `precut` | `integer` | No | Pre-amplification cut in tenths of dB applied before EQ bands (e.g. -60 = -6.0 dB) |
| `enabled` | `boolean` | No | Whether the equalizer is enabled |

### `app.rocksky.rockbox.defs#replayGainSettings`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `mode` | `string` | No | Replay gain mode: disabled \| track \| album \| trackIfShuffling |
| `preamp` | `integer` | No | Pre-amplification in tenths of dB (e.g. 15 = +1.5 dB) |
| `preventClipping` | `boolean` | No | Whether to prevent clipping by reducing volume |

## Raw Schema

```json
{
  "id": "app.rocksky.rockbox.defs",
  "defs": {
    "settingsView": {
      "type": "object",
      "required": [
        "createdAt"
      ],
      "properties": {
        "tone": {
          "ref": "app.rocksky.rockbox.defs#toneSettings",
          "type": "ref",
          "description": "Tone control settings (bass, treble, balance, channels)"
        },
        "createdAt": {
          "type": "string",
          "format": "datetime",
          "description": "When this settings record was first created."
        },
        "crossfade": {
          "ref": "app.rocksky.rockbox.defs#crossfadeSettings",
          "type": "ref",
          "description": "Crossfade settings"
        },
        "equalizer": {
          "ref": "app.rocksky.rockbox.defs#equalizerSettings",
          "type": "ref",
          "description": "Equalizer settings"
        },
        "updatedAt": {
          "type": "string",
          "format": "datetime",
          "description": "When this settings record was last updated."
        },
        "replayGain": {
          "ref": "app.rocksky.rockbox.defs#replayGainSettings",
          "type": "ref",
          "description": "Replay gain settings"
        }
      }
    },
    "toneSettings": {
      "type": "object",
      "properties": {
        "bass": {
          "type": "integer",
          "maximum": 24,
          "minimum": -24,
          "description": "Bass level in dB"
        },
        "treble": {
          "type": "integer",
          "maximum": 24,
          "minimum": -24,
          "description": "Treble level in dB"
        },
        "balance": {
          "type": "integer",
          "maximum": 100,
          "minimum": -100,
          "description": "Left/right balance. Negative = left, positive = right"
        },
        "channels": {
          "type": "string",
          "description": "Channel configuration: stereo | mono | monoLeft | monoRight | karaoke | wide"
        }
      }
    },
    "equalizerBand": {
      "type": "object",
      "required": [
        "frequency",
        "gain",
        "q"
      ],
      "properties": {
        "q": {
          "type": "integer",
          "maximum": 640,
          "minimum": 5,
          "description": "Q factor × 10 (e.g. 7 = Q 0.7)"
        },
        "gain": {
          "type": "integer",
          "maximum": 240,
          "minimum": -240,
          "description": "Band gain in tenths of dB (e.g. 30 = +3.0 dB)"
        },
        "frequency": {
          "type": "integer",
          "maximum": 22000,
          "minimum": 20,
          "description": "Center frequency in Hz"
        }
      }
    },
    "crossfadeSettings": {
      "type": "object",
      "properties": {
        "mode": {
          "type": "string",
          "description": "Crossfade mode: disabled | enabled | shuffle | albumChange | trackChange"
        },
        "fadeInDelay": {
          "type": "integer",
          "maximum": 7000,
          "minimum": 0,
          "description": "Fade-in delay in ms"
        },
        "fadeOutDelay": {
          "type": "integer",
          "maximum": 7000,
          "minimum": 0,
          "description": "Fade-out delay in ms"
        },
        "fadeInDuration": {
          "type": "integer",
          "maximum": 15000,
          "minimum": 0,
          "description": "Fade-in duration in ms"
        },
        "fadeOutMixMode": {
          "type": "string",
          "description": "Fade-out mix mode: crossfade | mix"
        },
        "fadeOutDuration": {
          "type": "integer",
          "maximum": 15000,
          "minimum": 0,
          "description": "Fade-out duration in ms"
        }
      }
    },
    "equalizerSettings": {
      "type": "object",
      "properties": {
        "bands": {
          "type": "array",
          "items": {
            "ref": "app.rocksky.rockbox.defs#equalizerBand",
            "type": "ref"
          },
          "description": "Up to 10 EQ bands"
        },
        "precut": {
          "type": "integer",
          "maximum": 0,
          "minimum": -240,
          "description": "Pre-amplification cut in tenths of dB applied before EQ bands (e.g. -60 = -6.0 dB)"
        },
        "enabled": {
          "type": "boolean",
          "description": "Whether the equalizer is enabled"
        }
      }
    },
    "replayGainSettings": {
      "type": "object",
      "properties": {
        "mode": {
          "type": "string",
          "description": "Replay gain mode: disabled | track | album | trackIfShuffling"
        },
        "preamp": {
          "type": "integer",
          "maximum": 120,
          "minimum": -120,
          "description": "Pre-amplification in tenths of dB (e.g. 15 = +1.5 dB)"
        },
        "preventClipping": {
          "type": "boolean",
          "description": "Whether to prevent clipping by reducing volume"
        }
      }
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```