# computer.localnetwork.dj.defs

> Definitions DJ records share: tracks (with their artists and how each came in), keys, the people a DJ plays with, shares and counts.

- Kind: defs
- Authority: dj.localnetwork.computer
- Lexicon: 1
- Published by [localnetwork.computer](https://lexicon.garden/identity/did:plc:d42l64gsczg6qh2vo243xv5l), not the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:d42l64gsczg6qh2vo243xv5l/computer.localnetwork.dj.defs)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:d42l64gsczg6qh2vo243xv5l/computer.localnetwork.dj.defs/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:d42l64gsczg6qh2vo243xv5l/computer.localnetwork.dj.defs/analytics)

## #artist (`computer.localnetwork.dj.defs#artist`)

Type: object

One artist a track credits, shaped as teal.fm's artist.

### Properties

- `artistMbId` (string): The MusicBrainz artist ID: a lowercase, hyphenated UUID, as teal.fm writes it. Early records may have it as mbid:<uuid>.
  - Constraints: maxLength: 64
- `artistName` (string, required)
  - Constraints: minLength: 1, maxLength: 2560, maxGraphemes: 256

## #camelotKey (`computer.localnetwork.dj.defs#camelotKey`)

Type: string

A key on the Camelot wheel, 1A to 12B (8A is A minor, 8B C major).

Constraints: maxLength: 3, knownValues: 1A | 1B | 2A | 2B | 3A | 3B | 4A | 4B | 5A | 5B | 6A | 6B | 7A | 7B | 8A | 8B | 9A | 9B | 10A | 10B | 11A | 11B | 12A | 12B

## #count (`computer.localnetwork.dj.defs#count`)

Type: object

How many: count when exact, atLeast when rounded down to a round number. One of the two.

### Properties

- `atLeast` (integer)
  - Constraints: minimum: 0
- `count` (integer)
  - Constraints: minimum: 0

## #partner (`computer.localnetwork.dj.defs#partner`)

Type: object

Someone a DJ played with.

### Properties

- `did` (string · did): Their account, when known.
- `name` (string, required): The name they play under.
  - Constraints: maxLength: 640, maxGraphemes: 64

## #share (`computer.localnetwork.dj.defs#share`)

Type: object

A name (a genre, label or artist) and its share of plays.

### Properties

- `name` (string, required)
  - Constraints: maxLength: 1000, maxGraphemes: 200
- `share` (integer, required): Percent of plays.
  - Constraints: minimum: 0, maximum: 100

## #track (`computer.localnetwork.dj.defs#track`)

Type: object

One track: named (a title, usually an artist), or unidentified. isrc, recordingMbId, releaseName, releaseMbId and artists are named and shaped as in teal.fm's records, so readers can map them.

### Properties

- `artist` (string): The artist credit as the track is tagged: one line, however many artists it names.
  - Constraints: maxLength: 3000, maxGraphemes: 300
- `artists` (array): The artists the credit names, one by one in its order, when the writer can tell them apart.
  - Constraints: maxLength: 32
  - `items` (ref)
    - Reference: `#artist`
- `bpmCentis` (integer): Its tempo as the writer's analysis has it, in hundredths of a BPM (12800 is 128 BPM).
  - Constraints: minimum: 0
- `isrc` (string): The recording's ISRC.
  - Constraints: minLength: 12, maxLength: 12
- `key` (ref)
  - Reference: `#camelotKey`
- `recordingMbId` (string): The MusicBrainz recording ID: a lowercase, hyphenated UUID, as teal.fm writes it. Early records may have it as mbid:<uuid>.
  - Constraints: maxLength: 64
- `releaseMbId` (string): The MusicBrainz release ID: a lowercase, hyphenated UUID, as teal.fm writes it. Early records may have it as mbid:<uuid>.
  - Constraints: maxLength: 64
- `releaseName` (string): The release (album, EP or single) it's from.
  - Constraints: maxLength: 2560, maxGraphemes: 256
- `startSeconds` (integer): When it starts, in seconds from the start of the set or mix it's in (known from a recording).
  - Constraints: minimum: 0
- `title` (string)
  - Constraints: maxLength: 3000, maxGraphemes: 300
- `transitionIn` (ref): How it was brought in over the track before it. Absent on the first track, and when unknown.
  - Reference: `#transition`
- `unidentified` (boolean): Not named: the DJ chose not to say what it is (an unreleased promo, an edit), so only its place is published.

## #transition (`computer.localnetwork.dj.defs#transition`)

Type: object

How a track was brought in over the one before it, named and shaped as skaists' performance transition (technique, durationMs), with what a recording also tells: how the keys and tempo moved. Absent means unknown, not a cut.

### Properties

- `durationMs` (integer): How long both tracks were heard together, in milliseconds.
  - Constraints: minimum: 0, maximum: 600000
- `harmony` (string): How the keys heard relate on the Camelot wheel (after any pitch change from the tempo). sameKey: the same key. adjacent: one step round the wheel. relative: the same number, minor to major or back. energyBoost: two steps up, or a semitone up. clash: none of those.
  - Constraints: maxLength: 32, knownValues: sameKey | adjacent | relative | energyBoost | clash
- `technique` (string, required): How it was mixed in. unknown: the writer heard the change but can't tell how it was made.
  - Constraints: maxLength: 32, knownValues: blend | cut | loopRoll | echoOut | spinback | filterSweep | drop | acapellaOver | unknown
- `tempoChangePermille` (integer): How much the tempo played changed, in tenths of a percent (25 is 2.5% faster, -10 is 1% slower).

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "artist": {
      "description": "One artist a track credits, shaped as teal.fm's artist.",
      "properties": {
        "artistMbId": {
          "description": "The MusicBrainz artist ID: a lowercase, hyphenated UUID, as teal.fm writes it. Early records may have it as mbid:<uuid>.",
          "maxLength": 64,
          "type": "string"
        },
        "artistName": {
          "maxGraphemes": 256,
          "maxLength": 2560,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "artistName"
      ],
      "type": "object"
    },
    "camelotKey": {
      "description": "A key on the Camelot wheel, 1A to 12B (8A is A minor, 8B C major).",
      "knownValues": [
        "1A",
        "1B",
        "2A",
        "2B",
        "3A",
        "3B",
        "4A",
        "4B",
        "5A",
        "5B",
        "6A",
        "6B",
        "7A",
        "7B",
        "8A",
        "8B",
        "9A",
        "9B",
        "10A",
        "10B",
        "11A",
        "11B",
        "12A",
        "12B"
      ],
      "maxLength": 3,
      "type": "string"
    },
    "count": {
      "description": "How many: count when exact, atLeast when rounded down to a round number. One of the two.",
      "properties": {
        "atLeast": {
          "minimum": 0,
          "type": "integer"
        },
        "count": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "type": "object"
    },
    "partner": {
      "description": "Someone a DJ played with.",
      "properties": {
        "did": {
          "description": "Their account, when known.",
          "format": "did",
          "type": "string"
        },
        "name": {
          "description": "The name they play under.",
          "maxGraphemes": 64,
          "maxLength": 640,
          "type": "string"
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    },
    "share": {
      "description": "A name (a genre, label or artist) and its share of plays.",
      "properties": {
        "name": {
          "maxGraphemes": 200,
          "maxLength": 1000,
          "type": "string"
        },
        "share": {
          "description": "Percent of plays.",
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "name",
        "share"
      ],
      "type": "object"
    },
    "track": {
      "description": "One track: named (a title, usually an artist), or unidentified. isrc, recordingMbId, releaseName, releaseMbId and artists are named and shaped as in teal.fm's records, so readers can map them.",
      "properties": {
        "artist": {
          "description": "The artist credit as the track is tagged: one line, however many artists it names.",
          "maxGraphemes": 300,
          "maxLength": 3000,
          "type": "string"
        },
        "artists": {
          "description": "The artists the credit names, one by one in its order, when the writer can tell them apart.",
          "items": {
            "ref": "#artist",
            "type": "ref"
          },
          "maxLength": 32,
          "type": "array"
        },
        "bpmCentis": {
          "description": "Its tempo as the writer's analysis has it, in hundredths of a BPM (12800 is 128 BPM).",
          "minimum": 0,
          "type": "integer"
        },
        "isrc": {
          "description": "The recording's ISRC.",
          "maxLength": 12,
          "minLength": 12,
          "type": "string"
        },
        "key": {
          "ref": "#camelotKey",
          "type": "ref"
        },
        "recordingMbId": {
          "description": "The MusicBrainz recording ID: a lowercase, hyphenated UUID, as teal.fm writes it. Early records may have it as mbid:<uuid>.",
          "maxLength": 64,
          "type": "string"
        },
        "releaseMbId": {
          "description": "The MusicBrainz release ID: a lowercase, hyphenated UUID, as teal.fm writes it. Early records may have it as mbid:<uuid>.",
          "maxLength": 64,
          "type": "string"
        },
        "releaseName": {
          "description": "The release (album, EP or single) it's from.",
          "maxGraphemes": 256,
          "maxLength": 2560,
          "type": "string"
        },
        "startSeconds": {
          "description": "When it starts, in seconds from the start of the set or mix it's in (known from a recording).",
          "minimum": 0,
          "type": "integer"
        },
        "title": {
          "maxGraphemes": 300,
          "maxLength": 3000,
          "type": "string"
        },
        "transitionIn": {
          "description": "How it was brought in over the track before it. Absent on the first track, and when unknown.",
          "ref": "#transition",
          "type": "ref"
        },
        "unidentified": {
          "description": "Not named: the DJ chose not to say what it is (an unreleased promo, an edit), so only its place is published.",
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "transition": {
      "description": "How a track was brought in over the one before it, named and shaped as skaists' performance transition (technique, durationMs), with what a recording also tells: how the keys and tempo moved. Absent means unknown, not a cut.",
      "properties": {
        "durationMs": {
          "description": "How long both tracks were heard together, in milliseconds.",
          "maximum": 600000,
          "minimum": 0,
          "type": "integer"
        },
        "harmony": {
          "description": "How the keys heard relate on the Camelot wheel (after any pitch change from the tempo). sameKey: the same key. adjacent: one step round the wheel. relative: the same number, minor to major or back. energyBoost: two steps up, or a semitone up. clash: none of those.",
          "knownValues": [
            "sameKey",
            "adjacent",
            "relative",
            "energyBoost",
            "clash"
          ],
          "maxLength": 32,
          "type": "string"
        },
        "technique": {
          "description": "How it was mixed in. unknown: the writer heard the change but can't tell how it was made.",
          "knownValues": [
            "blend",
            "cut",
            "loopRoll",
            "echoOut",
            "spinback",
            "filterSweep",
            "drop",
            "acapellaOver",
            "unknown"
          ],
          "maxLength": 32,
          "type": "string"
        },
        "tempoChangePermille": {
          "description": "How much the tempo played changed, in tenths of a percent (25 is 2.5% faster, -10 is 1% slower).",
          "type": "integer"
        }
      },
      "required": [
        "technique"
      ],
      "type": "object"
    }
  },
  "description": "Definitions DJ records share: tracks (with their artists and how each came in), keys, the people a DJ plays with, shares and counts.",
  "id": "computer.localnetwork.dj.defs",
  "lexicon": 1
}
```
