Music Tracks (Extendeder)

Music Tracks (Extendeder)

Event Kind

• 36787: Music Track (addressable)

Music Track Event

A music track is an addressable event containing metadata about an audio file.

Format

The .content field MAY contain lyrics and production credits in plain text.

Tags

Required:

• d - Unique identifier for this track
• title - Track title
• artist - Artist name
• url - Direct URL to the audio file
• t - At least one tag with value "music"

Optional:

• alt - Human-readable description (NIP-31)
• image - URL to album artwork
• video - URL to music video file
• lyrics - URL to SRT file (SubRip subtitle file)
• album - Album name
• **album_artist** - The primary artist for the album (used for compilations)
• track_number - Position in album
• **disc_number** - The disc number in a multi-disc set
• released - ISO 8601 date (YYYY-MM-DD)
• license - License name and URL. Commonly used licenses: All Rights Reserved, CC0 1.0, CC-BY 4.0, CC BY-SA 4.0, CC BY-ND 4.0, CC BY-NC 4.0, CC BY-NC-SA 4.0, CC BY-NC-ND 4.0
• t - Additional genre/category tags
• language - ISO 639-1 language code
• explicit - Set to "true" for explicit content
• ai_generated - Set to "true" for AI generated content
• duration - Track length in seconds
• format - Audio format (mp3, flac, m4a, ogg)
• bitrate - Audio bitrate (e.g., "320kbps")
• sample_rate - Sample rate in Hz
• **fallback** - Alternative URL(s) to the audio file for redundancy (Multiple allowed)
• zap - Lightning address for zap splits (multiple allowed, see Zap Splits)

Example

{
  "kind": 36787,
  "content": "Lyrics:\n[Verse 1]\n...\n\nCredits:\nProducer: John Doe",
  "tags": [
    ["d", "summer-nights-2024"],
    ["title", "Summer Nights"],
    ["url", "https://cdn.blossom.example/audio/abc123.mp3"],
    ["fallback", "https://alternate.example/audio/abc123.mp3"],
    ["image", "https://cdn.blossom.example/img/artwork.jpg"],
    ["video", "https://cdn.blossom.example/video/abc123.mp4"],
    ["lyrics", "https://cdn.blossom.example/lyrics/abc123.srt"],
    ["artist", "The Midnight Collective"],
    ["album", "Endless Summer"],
    ["album_artist", "The Midnight Collective"],
    ["track_number", "3"],
    ["disc_number", "1"],
    ["released", "2024-06-15"],
    ["license", "CC BY 4.0", "https://creativecommons.org/licenses/by/4.0/"],
    ["explicit", "true"],
    ["ai_generated", "true"],
    ["duration", "245"],
    ["format", "mp3"],
    ["t", "music"],
    ["t", "electronic"],
    ["alt", "Music track: Summer Nights by The Midnight Collective"]
  ]
}