2.8 KiB
NIP-0a
Audio Events
draft
optional
This NIP defines several new event kinds representing different types of audio track. These events are parameterized replaceable as defined in NIP-01 and deletable per NIP-09.
Unlike a kind 1
event with audio attached, audio events are intended to be surfaced in an audio-specific context
rather than in a general micro-blogging context.
The following kinds are defined by this NIP:
31337
represents a music track31338
represents a podcast episode
The following tags are required:
d
is a unique identifier randomly generated by the client.media
is the url of the media. This SHOULD NOT be read, but is required for backwards compatibility reasons.imeta
is as described in NIP 92. Multipleimeta
tags MAY be included to provide for different use cases (e.g. streaming vs download).title
is the title of the audio tracksubject
is the title of the audio track (deprecated, but required for compatibility)
The following tags are optional:
i
is an external GUID in the format defined here.c
is the track's value as defined by a given category.website
is an external url to a website related to the track.duration
is the duration of the audio track, in seconds.published_at
is a timestamp representing the track's original publish date.
Expected categories may include (but are not limited to):
genre
subgenre
artist
record_label
producer
composer
album
track_number
tracks
bpm
year
Note that artists, producers, SHOULD be referred to using both a plaintext c
tag AND a conventional p
tag when pubkey is available. When doing so, the p
tag's petname MUST be the same as the c
tag's value. In this way c
tags can be used to indicate genre, as well as artist, producer, etc.
If included, genre
and subgenre
SHOULD be based on this list.
content
SHOULD be summary or description of the audio content.
Example:
{
"id": <event_id>,
"pubkey": <author_pubkey>,
"created_at": <created_at>,
"kind": 31337,
"content": "Chill beats",
"tags": [
["d", "<id>"],
["c", "Pop", "genre"],
["c", "EDM", "subgenre"],
["c", "Columbia Records", "record_label"],
["c", "AC/DC", "artist"],
["i", "podcast:item:guid:123", "https://fountain.fm/episode/30uEXC25615Ze2ELjY2p"],
["p", "2a07724d42fd8004b5c97b62ba03b6baf3919f9e8211667039987866997e97ad", "wss://my-relay.com", "AC/DC"],
["title", "Platinum Robots on the Moon"],
["subject", "Platinum Robots on the Moon"],
["published_at", "<published_at>"],
["imeta", "url https://example.com/my-track.m3u8", "x <hash>", ...]
]
}