# fm.freemix.release.track

> Published by [lex-publisher.freemix.fm](https://lexicon.garden/identity/did:plc:bt7c6cqevgefnvej5cmgke4g)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:bt7c6cqevgefnvej5cmgke4g/fm.freemix.release.track)
- [Documentation](https://lexicon.garden/lexicon/did:plc:bt7c6cqevgefnvej5cmgke4g/fm.freemix.release.track/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:bt7c6cqevgefnvej5cmgke4g/fm.freemix.release.track/examples)

## Definitions

### `fm.freemix.release.track`

**Type**: `record`

A music track record on FreeMix

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `key` | `string` | No | Musical key (e.g., 'Am', 'F#m', 'Bb') |
| `isrc` | `string` | No | International Standard Recording Code |
| `tags` | `array` | No | Freeform tags |
| `genre` | `array` | No | Genre classifications |
| `title` | `string` | Yes | Track title |
| `artist` | `string` | Yes | Artist name |
| `buyLink` | `string` (uri) | No | URL to purchase or stream (Bandcamp, Beatport, Spotify, etc.) |
| `license` | `string` (at-uri) | Yes | AT URI to the license grant record |
| `audioUrl` | `string` (uri) | Yes | R2 URL to the audio file |
| `audioHash` | `string` | Yes | SHA-256 hash of the audio file content |
| `bpmCentis` | `integer` | No | Beats per minute in centiBPM (multiply actual BPM by 100, e.g., 174.50 BPM = 17450) |
| `createdAt` | `string` (datetime) | Yes | Record creation timestamp |
| `isReleased` | `boolean` | No | Whether this track was previously released outside FreeMix |
| `stemAccess` | `string` | No | Who can access stems. Defaults to 'open'. Phase 1 only supports 'open' and 'community'. |
| `audioFormat` | `string` | Yes | Audio file format |
| `coverArtUrl` | `string` (uri) | No | URL to cover art image |
| `description` | `string` | No | Track description |
| `releaseDate` | `string` (datetime) | No | Original release date (ISO 8601) |
| `coverArtHash` | `string` | No | SHA-256 hash of the cover art |
| `releaseLabel` | `string` | No | Label name (e.g., 'Vizual Records', 'self-released') |
| `aiDeclaration` | `object` | No | Declaration of AI involvement in creation |
| `catalogNumber` | `string` | No | Catalog number (e.g., 'VIZ-042') |
| `audioSizeBytes` | `integer` | Yes | Size of the audio file in bytes |
| `audioDurationMs` | `integer` | No | Duration of the track in milliseconds |

## Raw Schema

```json
{
  "id": "fm.freemix.release.track",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "title",
          "artist",
          "audioUrl",
          "audioHash",
          "audioFormat",
          "audioSizeBytes",
          "license",
          "createdAt"
        ],
        "properties": {
          "key": {
            "type": "string",
            "maxLength": 10,
            "description": "Musical key (e.g., 'Am', 'F#m', 'Bb')"
          },
          "isrc": {
            "type": "string",
            "maxLength": 100,
            "description": "International Standard Recording Code"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 50
            },
            "maxLength": 10,
            "description": "Freeform tags"
          },
          "genre": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 50
            },
            "maxLength": 5,
            "description": "Genre classifications"
          },
          "title": {
            "type": "string",
            "maxLength": 300,
            "description": "Track title"
          },
          "artist": {
            "type": "string",
            "maxLength": 200,
            "description": "Artist name"
          },
          "buyLink": {
            "type": "string",
            "format": "uri",
            "maxLength": 500,
            "description": "URL to purchase or stream (Bandcamp, Beatport, Spotify, etc.)"
          },
          "license": {
            "type": "string",
            "format": "at-uri",
            "maxLength": 3000,
            "description": "AT URI to the license grant record"
          },
          "audioUrl": {
            "type": "string",
            "format": "uri",
            "maxLength": 3000,
            "description": "R2 URL to the audio file"
          },
          "audioHash": {
            "type": "string",
            "maxLength": 200,
            "description": "SHA-256 hash of the audio file content"
          },
          "bpmCentis": {
            "type": "integer",
            "maximum": 99900,
            "minimum": 2000,
            "description": "Beats per minute in centiBPM (multiply actual BPM by 100, e.g., 174.50 BPM = 17450)"
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "maxLength": 100,
            "description": "Record creation timestamp"
          },
          "isReleased": {
            "type": "boolean",
            "description": "Whether this track was previously released outside FreeMix"
          },
          "stemAccess": {
            "type": "string",
            "maxLength": 100,
            "description": "Who can access stems. Defaults to 'open'. Phase 1 only supports 'open' and 'community'.",
            "knownValues": [
              "open",
              "community",
              "request",
              "pro"
            ]
          },
          "audioFormat": {
            "type": "string",
            "maxLength": 100,
            "description": "Audio file format",
            "knownValues": [
              "wav",
              "flac",
              "mp3",
              "aac",
              "ogg",
              "aiff"
            ]
          },
          "coverArtUrl": {
            "type": "string",
            "format": "uri",
            "maxLength": 3000,
            "description": "URL to cover art image"
          },
          "description": {
            "type": "string",
            "maxLength": 5000,
            "description": "Track description"
          },
          "releaseDate": {
            "type": "string",
            "format": "datetime",
            "description": "Original release date (ISO 8601)"
          },
          "coverArtHash": {
            "type": "string",
            "maxLength": 200,
            "description": "SHA-256 hash of the cover art"
          },
          "releaseLabel": {
            "type": "string",
            "maxLength": 255,
            "description": "Label name (e.g., 'Vizual Records', 'self-released')"
          },
          "aiDeclaration": {
            "type": "object",
            "required": [
              "category"
            ],
            "properties": {
              "tools": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 100
                },
                "maxLength": 10,
                "description": "AI tools used"
              },
              "category": {
                "type": "string",
                "maxLength": 100,
                "description": "Level of AI involvement",
                "knownValues": [
                  "none",
                  "assisted",
                  "augmented",
                  "generated"
                ]
              },
              "description": {
                "type": "string",
                "maxLength": 1000,
                "description": "Creator's description of how AI was used"
              }
            },
            "description": "Declaration of AI involvement in creation"
          },
          "catalogNumber": {
            "type": "string",
            "maxLength": 100,
            "description": "Catalog number (e.g., 'VIZ-042')"
          },
          "audioSizeBytes": {
            "type": "integer",
            "description": "Size of the audio file in bytes"
          },
          "audioDurationMs": {
            "type": "integer",
            "description": "Duration of the track in milliseconds"
          }
        }
      },
      "description": "A music track record on FreeMix"
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```