# cafe.thunderbird.audio.track

> A piece of audio with its file on the author's PDS. The basic fields use the names plyr.fm's fm.plyr.track uses, so music apps can read it with little code; note that here `artist` is the performer, not the uploader. Concert recordings add the optional `recording` section.

- Kind: record
- Record key: tid
- Authority: audio.thunderbird.cafe
- Lexicon: 1
- Published by [thunderbird.cafe](https://lexicon.garden/identity/did:plc:6vxjigxrqizmbo56gojxico3), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:6vxjigxrqizmbo56gojxico3/cafe.thunderbird.audio.track)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:6vxjigxrqizmbo56gojxico3/cafe.thunderbird.audio.track/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:6vxjigxrqizmbo56gojxico3/cafe.thunderbird.audio.track/analytics)

## Record (`cafe.thunderbird.audio.track`)

Type: record · key tid

### Properties

- `album` (string): The show or album the track belongs to, for example "Galactic · Moguls · 1997-08-15".
  - Constraints: maxLength: 256
- `artist` (string): The performer (for example the band), not the account that uploaded it.
  - Constraints: minLength: 1, maxLength: 256
- `audioBlob` (blob, required): The audio file (the Foundry's importer stores Opus in WebM). Servers may hold files to a smaller limit (Bluesky-hosted accounts: 50 MB).
  - Constraints: maxSize: 100000000, accept: audio/webm, audio/ogg, audio/mpeg, audio/mp4, audio/flac, audio/wav
- `createdAt` (string · datetime, required): When the track was added.
- `description` (string): Liner notes, show notes, setlist or lineage notes.
  - Constraints: maxLength: 5000
- `duration` (integer): Duration in seconds.
  - Constraints: minimum: 1
- `fileType` (string): The audio file's format, for example webm.
  - Constraints: minLength: 1, maxLength: 16
- `imageBlob` (blob): Cover artwork.
  - Constraints: maxSize: 10000000, accept: image/png, image/jpeg, image/webp, image/gif
- `recording` (ref)
  - Reference: `#recording`
- `tags` (array): The creator's tags.
  - Constraints: maxLength: 20
  - `items` (string)
    - Constraints: maxLength: 50
- `title` (string, required): The track's title.
  - Constraints: minLength: 1, maxLength: 256
- `trackNumber` (integer): The track's place in its show or album.
  - Constraints: minimum: 1, maximum: 999

## #recording (`cafe.thunderbird.audio.track#recording`)

Type: object

Where and how a live recording was made (for example a Live Music Archive show).

### Properties

- `archiveUrl` (string · uri): The show's page, for example on the Live Music Archive.
  - Constraints: maxLength: 2000
- `date` (string): The performance date: YYYY-MM-DD, YYYY-MM or YYYY.
  - Constraints: maxLength: 10
- `place` (string): City and state or country.
  - Constraints: maxLength: 256
- `policyUrl` (string · uri): The performer's sharing policy.
  - Constraints: maxLength: 2000
- `set` (string): For example Set 1, Set 2, Encore.
  - Constraints: maxLength: 64
- `source` (string): Soundboard or audience, and the lineage (microphones, equipment, transfers).
  - Constraints: maxLength: 1000
- `taper` (string): Who recorded it.
  - Constraints: maxLength: 256
- `venue` (string)
  - Constraints: maxLength: 256

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A piece of audio with its file on the author's PDS. The basic fields use the names plyr.fm's fm.plyr.track uses, so music apps can read it with little code; note that here `artist` is the performer, not the uploader. Concert recordings add the optional `recording` section.",
      "key": "tid",
      "record": {
        "properties": {
          "album": {
            "description": "The show or album the track belongs to, for example \"Galactic · Moguls · 1997-08-15\".",
            "maxLength": 256,
            "type": "string"
          },
          "artist": {
            "description": "The performer (for example the band), not the account that uploaded it.",
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "audioBlob": {
            "accept": [
              "audio/webm",
              "audio/ogg",
              "audio/mpeg",
              "audio/mp4",
              "audio/flac",
              "audio/wav"
            ],
            "description": "The audio file (the Foundry's importer stores Opus in WebM). Servers may hold files to a smaller limit (Bluesky-hosted accounts: 50 MB).",
            "maxSize": 100000000,
            "type": "blob"
          },
          "createdAt": {
            "description": "When the track was added.",
            "format": "datetime",
            "type": "string"
          },
          "description": {
            "description": "Liner notes, show notes, setlist or lineage notes.",
            "maxLength": 5000,
            "type": "string"
          },
          "duration": {
            "description": "Duration in seconds.",
            "minimum": 1,
            "type": "integer"
          },
          "fileType": {
            "description": "The audio file's format, for example webm.",
            "maxLength": 16,
            "minLength": 1,
            "type": "string"
          },
          "imageBlob": {
            "accept": [
              "image/png",
              "image/jpeg",
              "image/webp",
              "image/gif"
            ],
            "description": "Cover artwork.",
            "maxSize": 10000000,
            "type": "blob"
          },
          "recording": {
            "ref": "#recording",
            "type": "ref"
          },
          "tags": {
            "description": "The creator's tags.",
            "items": {
              "maxLength": 50,
              "type": "string"
            },
            "maxLength": 20,
            "type": "array"
          },
          "title": {
            "description": "The track's title.",
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "trackNumber": {
            "description": "The track's place in its show or album.",
            "maximum": 999,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "title",
          "audioBlob",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    },
    "recording": {
      "description": "Where and how a live recording was made (for example a Live Music Archive show).",
      "properties": {
        "archiveUrl": {
          "description": "The show's page, for example on the Live Music Archive.",
          "format": "uri",
          "maxLength": 2000,
          "type": "string"
        },
        "date": {
          "description": "The performance date: YYYY-MM-DD, YYYY-MM or YYYY.",
          "maxLength": 10,
          "type": "string"
        },
        "place": {
          "description": "City and state or country.",
          "maxLength": 256,
          "type": "string"
        },
        "policyUrl": {
          "description": "The performer's sharing policy.",
          "format": "uri",
          "maxLength": 2000,
          "type": "string"
        },
        "set": {
          "description": "For example Set 1, Set 2, Encore.",
          "maxLength": 64,
          "type": "string"
        },
        "source": {
          "description": "Soundboard or audience, and the lineage (microphones, equipment, transfers).",
          "maxLength": 1000,
          "type": "string"
        },
        "taper": {
          "description": "Who recorded it.",
          "maxLength": 256,
          "type": "string"
        },
        "venue": {
          "maxLength": 256,
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "description": "A piece of audio (a song, a live track, a recording) with its audio file on the author's PDS.",
  "id": "cafe.thunderbird.audio.track",
  "lexicon": 1
}
```
