Specification
Examples
Each file shows a situation people are in today, such as songs liked on a streaming service, a record shelf, a DJ's files or music followed on the fediverse. The data is made up, and every file passes the validator.
album-collection.mix.ndjson
DownloadA collection of albums only (no recordings, each with release_type): Qobuz favourite albums as a saved list of releases, a list of the person's own, and a note on one album.
{"type":"mix","version":"2.0","generated_at":"2026-10-20T09:00:00Z","generator":{"name":"Example Streaming Exporter","url":"https://exporter.example.com"},"counts":{"sources":1,"items":3,"recordings":0,"releases":3,"l…
{"type":"source","id":"src-qobuz","platform":"qobuz","name":"Qobuz","account":"2210045","account_name":"example-listener"}
{"type":"item","id":"itm-1001","kind":"release","title":"Harbour Lights","artists":[{"name":"Lumen Arcade"}],"release_type":"album","release_date":"2026-03-06","label":"Tidewater Tapes","ids":{"upc":"000000260001"},"a…
{"type":"item","id":"itm-1002","kind":"release","title":"Cold Weather Songs","artists":[{"name":"Odile Marsh"}],"release_type":"album","release_date":"2024-12-01","label":"Halvard Records","ids":{"upc":"000000241002"}…
{"type":"item","id":"itm-1003","kind":"release","title":"Brass Meridian","artists":[{"name":"Ottilie Brandt Quartet"}],"release_type":"album","release_date":"1979","label":"Example Jazz Archive","ids":{"upc":"00000079…
{"type":"list","id":"lst-favourite-albums","name":"Favourite albums","ordered":true,"role":"saved","source":"src-qobuz","entries":[{"item":"itm-1001","ref":"0example-qobuz-1001","added_at":"2026-03-07T08:00:00Z"},{"it…1 more lines in the file.
bandcamp-collection.mix.ndjson
DownloadStore purchases as ownership: digital copies (refs are Bandcamp's numeric ids) with 24-bit FLAC file info, the collection as a library list, and a wishlist (role: wanted) of ownership: none copies.
{"type":"mix","version":"2.0","generated_at":"2026-10-18T09:30:00Z","generator":{"name":"Example Store Exporter"},"counts":{"sources":1,"items":6,"recordings":4,"releases":2,"lists":2}}
{"type":"source","id":"src-bandcamp","platform":"bandcamp","name":"Bandcamp","account":"4417001","account_name":"example-fan"}
{"type":"item","id":"itm-0101","kind":"release","title":"Harbour Lights","artists":[{"name":"Lumen Arcade"}],"release_date":"2026-03-06","label":"Tidewater Tapes","ids":{"upc":"000000260001"},"added_at":"2026-03-06T12…
{"type":"item","id":"itm-0102","kind":"recording","title":"Glass Tides","artists":[{"name":"Lumen Arcade"}],"album":"Harbour Lights","duration_ms":214000,"ids":{"isrc":"XXEXA2600001"},"added_at":"2026-03-06T12:00:00Z"…
{"type":"item","id":"itm-0103","kind":"recording","title":"Salt Road","artists":[{"name":"Odile Marsh"}],"album":"Cold Weather Songs","duration_ms":233400,"release_date":"2024-12-01","label":"Halvard Records","ids":{"…
{"type":"item","id":"itm-0104","kind":"recording","title":"Lowlight","artists":[{"name":"Kasimir Vane"}],"duration_ms":402000,"release_date":"2026-07","genres":["techno"],"added_at":"2026-07-19T22:05:00Z","copies":[{"…4 more lines in the file.
box-set.mix.ndjson
DownloadA three-CD box set on a hand-catalogued shelf (platform: shelf): one physical copy of the release, and tracks with disc_number, track_number and printed positions (2-03).
{"type":"mix","version":"2.0","generated_at":"2026-10-20T09:00:00Z","generator":{"name":"Example Record Shelf Exporter"},"counts":{"sources":1,"items":7,"recordings":6,"releases":1,"lists":0}}
{"type":"source","id":"src-shelf","platform":"shelf","name":"My records"}
{"type":"item","id":"itm-0801","kind":"release","title":"The Halvard Sessions 1998–2004","artists":[{"name":"Odile Marsh"}],"release_date":"2025-11","label":"Halvard Records","catalog_number":"HALV BOX 1","country":"N…
{"type":"item","id":"itm-0811","kind":"recording","title":"Salt Road (1998 demo)","artists":[{"name":"Odile Marsh"}],"album":"The Halvard Sessions 1998–2004","copies":[{"source":"src-shelf","ref":"box-halvard-sessions…
{"type":"item","id":"itm-0812","kind":"recording","title":"Harbour Song","artists":[{"name":"Odile Marsh"}],"album":"The Halvard Sessions 1998–2004","copies":[{"source":"src-shelf","ref":"box-halvard-sessions/1-02","o…
{"type":"item","id":"itm-0821","kind":"recording","title":"Cold Weather","artists":[{"name":"Odile Marsh"}],"album":"The Halvard Sessions 1998–2004","copies":[{"source":"src-shelf","ref":"box-halvard-sessions/2-01","o…3 more lines in the file.
chorus-release.mix.ndjson
DownloadAn album kept from a label's Chorus feed (Feeds module), as tools/feeds maps it: copies on tidewater-tapes.example (ref <feed URL>#<$id>) and on the shop it links to, the tracks' audio in each copy's media, a featured artist, and the artist with its profiles.
{"type":"mix","version":"2.0","generated_at":"2026-11-11T10:05:00Z","generator":{"name":"Example Collection Host","url":"https://host.example.org"},"counts":{"sources":2,"artists":1,"items":3,"recordings":2,"releases"…
{"type":"source","id":"tidewater-tapes.example","platform":"tidewater-tapes.example","name":"tidewater-tapes.example"}
{"type":"source","id":"shop.harbour-records.example","platform":"shop.harbour-records.example","name":"shop.harbour-records.example"}
{"type":"artist","id":"a1","name":"Lumen Arcade","url":"https://tidewater-tapes.example/artists/lumen-arcade/","artwork_url":"https://tidewater-tapes.example/static/lumen-arcade-icon.png","profiles":[{"platform":"tide…
{"type":"item","id":"r2","kind":"release","title":"Harbour Lights - Deluxe","artists":[{"name":"Lumen Arcade","artist":"a1","join":" feat. "},{"name":"Odile Marsh"}],"release_date":"2026-03-06","label":"Tidewater Tape…
{"type":"item","id":"t2","kind":"recording","title":"Harbour Lights","artists":[{"name":"Lumen Arcade","artist":"a1","join":" feat. "},{"name":"Odile Marsh"}],"album":"Harbour Lights - Deluxe","duration_ms":241500,"co…2 more lines in the file.
collector.mix.ndjson
DownloadA collector's shelf with the Collector module: what each record cost and where it came from (acquired), one lent to a friend (still physical), and one sold (gone, so ownership: none).
{"type":"mix","version":"2.0","generated_at":"2026-10-20T09:00:00Z","generator":{"name":"Example Record Shelf Exporter"},"counts":{"sources":1,"items":3,"recordings":0,"releases":3,"lists":1},"modules":{"org.openmusic…
{"type":"source","id":"src-shelf","platform":"shelf","name":"My records"}
{"type":"item","id":"itm-1201","kind":"release","title":"Brass Meridian","artists":[{"name":"Ottilie Brandt Quartet"}],"release_date":"1979","label":"Example Jazz Archive","catalog_number":"EJA 1979","country":"US","a…
{"type":"item","id":"itm-1202","kind":"release","title":"Harbour Lights","artists":[{"name":"Lumen Arcade"}],"release_date":"2026-03-06","label":"Tidewater Tapes","catalog_number":"TWT 012","country":"GB","added_at":"…
{"type":"item","id":"itm-1203","kind":"release","title":"Night Ferry EP","artists":[{"name":"The Quiet Harbors"}],"release_date":"2025-05","label":"Tidewater Tapes","catalog_number":"TWT 009","country":"GB","added_at"…
{"type":"list","id":"lst-shelf","name":"My records","ordered":false,"role":"library","source":"src-shelf","entries":[{"item":"itm-1201","ref":"shelf-1201"},{"item":"itm-1202","ref":"shelf-1202"},{"item":"itm-1203","re…
discogs-vinyl.mix.ndjson
DownloadA record shelf: releases with catalog_number and country, physical copies with format, format_details, condition and location, tracks with refs <release id>/<position> and position (vinyl sides, a CD's track number), a release in the File format as digital, a wantlist (role: wanted) of ownership: none copies, and a folder as an unordered list.
{"type":"mix","version":"2.0","generated_at":"2026-10-20T09:00:00Z","generator":{"name":"Example Record Shelf Exporter"},"counts":{"sources":1,"items":12,"recordings":4,"releases":8,"lists":3}}
{"type":"source","id":"src-discogs","platform":"discogs","name":"Discogs","account":"7700042","account_name":"example-collector"}
{"type":"item","id":"itm-0201","kind":"release","title":"Harbour Lights","artists":[{"name":"Lumen Arcade"}],"release_date":"2026-03-06","label":"Tidewater Tapes","catalog_number":"TWT 012","country":"GB","genres":["e…
{"type":"item","id":"itm-0211","kind":"recording","title":"Glass Tides","artists":[{"name":"Lumen Arcade"}],"album":"Harbour Lights","duration_ms":214000,"ids":{"isrc":"XXEXA2600001"},"copies":[{"source":"src-discogs"…
{"type":"item","id":"itm-0212","kind":"recording","title":"Pier at Four","artists":[{"name":"Lumen Arcade"}],"album":"Harbour Lights","duration_ms":262000,"copies":[{"source":"src-discogs","ref":"900201/A2","ownership…
{"type":"item","id":"itm-0213","kind":"recording","title":"Harbour Lights","artists":[{"name":"Lumen Arcade"}],"album":"Harbour Lights","duration_ms":401000,"copies":[{"source":"src-discogs","ref":"900201/B1","ownersh…11 more lines in the file.
dj-library.mix.ndjson
DownloadA DJ's USB folder (platform: local, relative-path refs): tempo and key (ID3 TKEY: Am, F#m) with provenance, a file's audio_hash and fingerprint, cues, compact beat grids and measured analysis in the DJ module's copy ext, an item note, sets in a folder (one plays a track twice, with entry notes), colour tags in a "Colours" folder, a smart list with a filter, and a history list in year and month folders.
{"type":"mix","version":"2.0","generated_at":"2026-10-18T09:30:00Z","generator":{"name":"Mixwell 4 (example DJ app)","url":"https://mixwell.example"},"counts":{"sources":1,"items":5,"recordings":5,"releases":0,"lists"…
{"type":"source","id":"src-usb","platform":"local","name":"DJ USB: Music"}
{"type":"item","id":"itm-0301","kind":"recording","title":"Lowlight (Original Mix)","artists":[{"name":"Kasimir Vane"}],"duration_ms":402000,"genres":["techno"],"bpm":128,"key":"Am","provenance":{"bpm":{"origin":"anal…
{"type":"item","id":"itm-0302","kind":"recording","title":"Copper Hour (Extended Mix)","artists":[{"name":"Kasimir Vane"},{"name":"Odile Marsh"}],"album":"Copper Hour","album_artists":[{"name":"Kasimir Vane"}],"compos…
{"type":"item","id":"itm-0303","kind":"recording","title":"Tidal Index","artists":[{"name":"Neon Fjord"}],"duration_ms":361000,"genres":["techno"],"bpm":131.5,"key":"F#m","provenance":{"bpm":{"origin":"user"},"key":{"…
{"type":"item","id":"itm-0304","kind":"recording","title":"Glass Tides (Club Edit)","artists":[{"name":"Lumen Arcade"}],"duration_ms":330000,"genres":["electronica"],"bpm":124,"key":"Cm","provenance":{"bpm":{"origin":…14 more lines in the file.
dj-mix.mix.ndjson
DownloadA recorded DJ mix as a recording (a SoundCloud upload, by its numeric track id, and a file), with its tracklist in the DJ module's mix: lines naming recordings in the collection, an unidentified "ID", and a track the DJ doesn't have.
{"type":"mix","version":"2.0","generated_at":"2026-10-20T09:00:00Z","generator":{"name":"Mixwell 4 (example DJ app)","url":"https://mixwell.example"},"counts":{"sources":2,"items":3,"recordings":3,"releases":0,"lists"…
{"type":"source","id":"src-soundcloud","platform":"soundcloud","name":"SoundCloud","account":"880001","account_name":"anna-k-example"}
{"type":"source","id":"src-usb","platform":"local","name":"DJ USB: Music"}
{"type":"item","id":"itm-1101","kind":"recording","title":"Lowlight (Original Mix)","artists":[{"name":"Kasimir Vane"}],"duration_ms":402000,"bpm":128,"copies":[{"source":"src-usb","ref":"Techno/Kasimir Vane - Lowligh…
{"type":"item","id":"itm-1102","kind":"recording","title":"Tidal Index","artists":[{"name":"Neon Fjord"}],"duration_ms":361000,"bpm":131.5,"copies":[{"source":"src-usb","ref":"Techno/Neon Fjord - Tidal Index.mp3","own…
{"type":"item","id":"itm-1103","kind":"recording","title":"Basement, March","artists":[{"name":"Anna K"}],"duration_ms":5400000,"genres":["techno"],"release_date":"2026-03-30","added_at":"2026-03-30T12:00:00Z","copies…1 more lines in the file.
download-store.mix.ndjson
DownloadA Beatport purchase: the release and its tracks as digital copies with file info, and the downloaded AIFF again as a file copy in a local Downloads folder.
{"type":"mix","version":"2.0","generated_at":"2026-10-20T09:00:00Z","generator":{"name":"Example Store Exporter"},"counts":{"sources":2,"items":3,"recordings":2,"releases":1,"lists":1}}
{"type":"source","id":"src-beatport","platform":"beatport","name":"Beatport","account":"5520031","account_name":"example-dj"}
{"type":"source","id":"src-downloads","platform":"local","name":"Downloads"}
{"type":"item","id":"itm-0901","kind":"release","title":"Copper Hour","artists":[{"name":"Kasimir Vane"},{"name":"Odile Marsh"}],"release_date":"2026-08-28","label":"Vane Audio","catalog_number":"VANE 004","ids":{"upc…
{"type":"item","id":"itm-0911","kind":"recording","title":"Copper Hour (Extended Mix)","artists":[{"name":"Kasimir Vane"},{"name":"Odile Marsh"}],"album":"Copper Hour","duration_ms":395800,"bpm":122,"key":"Am","genres…
{"type":"item","id":"itm-0912","kind":"recording","title":"Copper Hour (Dub)","artists":[{"name":"Kasimir Vane"}],"album":"Copper Hour","duration_ms":402000,"bpm":122,"key":"Am","ids":{"isrc":"XXEXA2600912"},"added_at…1 more lines in the file.
fediverse-follows.mix.ndjson
DownloadFollows (Feeds module) of a Funkwhale channel by its acct: handle, an artist's Chorus feed, a label's JSON Feed and a person's picks (paused), with the artist records they point at, and a release and track kept from the channel: copies on open.audio, refs the ActivityPub objects' ids.
{"type":"mix","version":"2.0","generated_at":"2026-11-11T10:00:00Z","generator":{"name":"Example Collection Host","url":"https://host.example.org"},"counts":{"sources":1,"artists":2,"items":2,"recordings":1,"releases"…
{"type":"source","id":"src-open-audio","platform":"open.audio","name":"open.audio"}
{"type":"artist","id":"art-lumen","name":"Lumen Arcade","profiles":[{"platform":"open.audio","ref":"https://open.audio/federation/actors/lumenarcade","url":"https://open.audio/channels/lumenarcade"},{"platform":"open.…
{"type":"artist","id":"art-neon-fjord","name":"Neon Fjord","url":"https://neon-fjord.example/","profiles":[{"platform":"neon-fjord.example","ref":"https://neon-fjord.example/chorus.json#artist-neon-fjord","url":"https…
{"type":"item","id":"itm-1101","kind":"release","title":"Harbour Sessions","artists":[{"name":"Lumen Arcade","artist":"art-lumen"}],"release_date":"2026-11-08","added_at":"2026-11-10T19:00:00Z","copies":[{"source":"sr…
{"type":"item","id":"itm-1102","kind":"recording","title":"Glass Tides (Live at the Harbour)","artists":[{"name":"Lumen Arcade","artist":"art-lumen"}],"album":"Harbour Sessions","duration_ms":251000,"added_at":"2026-1…4 more lines in the file.
feeds/be68-outbox-page.json
DownloadAn ActivityPub outbox page with FEP-be68 Audio Objects as a Funkwhale pod publishes them (fictional pod and people): two credits with a join phrase, a public Audio and one only followers may play, and a Delete.
{
"@context": ["https://www.w3.org/ns/activitystreams", "https://funkwhale.audio/ns"],
"type": "OrderedCollectionPage",
"id": "https://pod.example/federation/actors/mira/outbox?page=1",
"partOf": "https://pod.example/federation/actors/mira/outbox",
"orderedItems": [
{
"type": "Create",
"id": "https://pod.example/federation/activities/7f2c",
"actor": "https://pod.example/federation/actors/mira",
"object": {
"type": "Audio",
"id": "https://pod.example/federation/music/uploads/7f2c",
"published": "2026-11-09T18:00:00Z",
"size": 9012345,
"bitrate": 320000,
"duration": "PT5M12S",
"library": "https://pod.example/federation/music/libraries/pub",
feeds/chorus-tidewater.json
DownloadA label's Chorus 0.3.2 feed: label, artist, two releases and their tracks, $refs, audio media, purchase links (one to a shop, one to Bandcamp, which a reader can only make a copy of once it has Bandcamp's id), $deleted and a WebSub hub.
{
"$lang": "en-GB",
"$protocol": "Chorus",
"$version": "0.3.2",
"$type": "collection",
"links": [
{ "rel": "self", "href": "https://tidewater-tapes.example/chorus.json" },
{ "rel": "websub", "href": "https://hub.example/" }
],
"$items": [
{
"$type": "label",
"$id": "lbl-tidewater",
"name": "Tidewater Tapes",
"url": "https://tidewater-tapes.example/",
"images": { "thumb": [{ "src": "/static/tidewater-logo.png", "alt": "A wave over a cassette", "width": 512, "height": 512 }] },
"$items": [
{
feeds/feed.json
DownloadA label's feed in JSON Feed 1.1: two release entries carry their MIX item in _mix, with copies by platform (the label's own page among them); one entry is a demo with an audio attachment and no record (a reader guesses a recording); one is plain news. Check it with npm run validate -- feed examples/feeds/feed.json. feeds/feed.atom is the same feed in Atom, without records, as most feeds are.
{
"version": "https://jsonfeed.org/version/1.1",
"title": "Tidewater Tapes",
"home_page_url": "https://tidewater-tapes.example",
"feed_url": "https://tidewater-tapes.example/feed.json",
"description": "New releases from Tidewater Tapes.",
"icon": "https://tidewater-tapes.example/icon-512.png",
"authors": [{ "name": "Tidewater Tapes", "url": "https://tidewater-tapes.example" }],
"hubs": [{ "type": "WebSub", "url": "https://hub.example/" }],
"items": [
{
"id": "tidal-index",
"url": "https://tidewater-tapes.example/releases/tidal-index",
"title": "Neon Fjord: Tidal Index",
"content_text": "Neon Fjord's first album, out 7 November. Pre-order now.",
"image": "https://tidewater-tapes.example/covers/tidal-index.jpg",
"date_published": "2026-10-15T08:00:00Z",
"_mix": {
multi-source.mix.ndjson
DownloadOne song with copies on Spotify, Bandcamp and a local folder; a list mixing songs and an album; an item with no copies yet; a com.example.moods extension; an artist record (MusicBrainz id, profiles) that a release's credit and a follow point at; Feeds module follows; header modules.
{"type":"mix","version":"2.0","generated_at":"2026-10-18T09:30:00Z","generator":{"name":"Example Collection Host","url":"https://host.example.org"},"counts":{"sources":3,"artists":1,"items":4,"recordings":3,"releases"…
{"type":"source","id":"src-spotify","platform":"spotify","name":"Spotify","account":"31exampl3listener0000a","account_name":"example-listener"}
{"type":"source","id":"src-bandcamp","platform":"bandcamp","name":"Bandcamp","account":"4417001","account_name":"example-fan"}
{"type":"source","id":"src-flac","platform":"local","name":"My FLAC folder"}
{"type":"artist","id":"art-odile","name":"Odile Marsh","sort_name":"Marsh, Odile","ids":{"musicbrainz":"00000000-0000-4000-8000-000000000f01"},"url":"https://odile-marsh.example","profiles":[{"platform":"bandcamp","re…
{"type":"item","id":"itm-0401","kind":"recording","title":"Glass Tides","artists":[{"name":"Lumen Arcade"}],"album":"Harbour Lights","duration_ms":214000,"release_date":"2026-03-06","label":"Tidewater Tapes","ids":{"i…6 more lines in the file.
opensubsonic-pod.mix.ndjson
DownloadWhat a home imports from a Funkwhale pod over OpenSubsonic (Delivery module) for one person: their uploads as file copies in the library list, one favourite of someone else's track (none, in the saved list) and their own playlist. Refs are the server's ids, since the source has the person's account. Other people's public albums and playlists on the pod are left out: they are for search.
{"type":"mix","version":"2.0","generated_at":"2026-11-11T10:00:00Z","generator":{"name":"Example Collection Host","url":"https://host.example.org"},"counts":{"sources":1,"artists":2,"items":5,"recordings":4,"releases"…
{"type":"source","id":"src-pod","platform":"pod.example.net","name":"Anna's pod","account":"anna"}
{"type":"artist","id":"art-mira","name":"Mira Holt","ids":{"musicbrainz":"5c0a1f6e-0000-4000-8000-00000000a001"},"profiles":[{"platform":"pod.example.net","ref":"https://pod.example.net/federation/music/artists/4","ur…
{"type":"artist","id":"art-quiet-hours","name":"The Quiet Hours","profiles":[{"platform":"pod.example.net","ref":"https://pod.example.net/federation/music/artists/9","url":"https://pod.example.net/library/artists/9"}]}
{"type":"item","id":"itm-1201","kind":"release","title":"Night Drive EP","artists":[{"name":"Mira Holt","artist":"art-mira"}],"release_date":"2026-11-09","release_type":"ep","added_at":"2026-11-09T18:00:00Z","copies":…
{"type":"item","id":"itm-1202","kind":"recording","title":"Night Drive","artists":[{"name":"Mira Holt","artist":"art-mira"}],"album":"Night Drive EP","duration_ms":312000,"ids":{"musicbrainz":"b3b9c3e4-0000-4000-8000-…6 more lines in the file.
own-server/collection.mix.ndjson
Download{"type":"mix","version":"2.0","generated_at":"2026-10-18T09:30:00Z","generator":{"name":"Mira's Room","url":"https://music.mirasroom.example"},"counts":{"sources":1,"items":3,"recordings":2,"releases":1,"lists":2}}
{"type":"source","id":"src-home","platform":"music.mirasroom.example","name":"Mira's own server","account":"guest-example","descriptor":"https://music.mirasroom.example/.well-known/mix-source.json"}
{"type":"item","id":"itm-0501","kind":"recording","title":"Kitchen Demo No. 3","artists":[{"name":"Mira Holt"}],"duration_ms":171000,"release_date":"2026-09","copies":[{"source":"src-home","ref":"tracks/example-0501",…
{"type":"item","id":"itm-0502","kind":"recording","title":"Night Drive","artists":[{"name":"Mira Holt"}],"album":"Night Drive EP","duration_ms":312000,"release_date":"2026-10-10","ids":{"isrc":"XXEXA2600502"},"copies"…
{"type":"item","id":"itm-0503","kind":"release","title":"Night Drive EP","artists":[{"name":"Mira Holt"}],"release_date":"2026-10-10","ids":{"upc":"000000260502"},"copies":[{"source":"src-home","ref":"releases/example…
{"type":"list","id":"lst-home-library","name":"Everything on the server","ordered":false,"role":"library","source":"src-home","entries":[{"item":"itm-0501","ref":"tracks/example-0501"},{"item":"itm-0502","ref":"tracks…1 more lines in the file.
own-server/source-descriptor.json
DownloadProtocols mix-access and opensubsonic, media.stream) and a collection.mix.ndjson whose source points at it with descriptor. A descriptor is optional: fediverse-follows has a host-name source without one.
{
"mix": "2.0",
"platform": "music.mirasroom.example",
"name": "Mira's Room",
"homepage": "https://music.mirasroom.example",
"icon": "https://music.mirasroom.example/icon-256.png",
"capabilities": ["link", "library.read", "lists.read", "lists.write", "lists.create", "search", "media.stream", "media.download"],
"protocols": {
"mix-access": {
"version": "0.3",
"base_url": "https://music.mirasroom.example/mix/v1"
},
"opensubsonic": {
"base_url": "https://music.mirasroom.example/rest"
}
}
}
own-values-and-guesses.mix.ndjson
DownloadValues of an app's own (ownership: com.example.app/borrowed, role: com.example.app/backlog), a SoundCloud date marked estimated on the copy and the item, and an entry an email-reading app guessed, marked inferred.
{"type":"mix","version":"2.0","generated_at":"2026-10-20T09:00:00Z","generator":{"name":"Example Collection Host","url":"https://host.example.org"},"counts":{"sources":2,"items":3,"recordings":1,"releases":2,"lists":2}}
{"type":"source","id":"src-shelf","platform":"shelf","name":"My records"}
{"type":"source","id":"src-soundcloud","platform":"soundcloud","name":"SoundCloud","account":"880002","account_name":"example-listener"}
{"type":"item","id":"itm-1301","kind":"release","title":"Cold Weather Songs","artists":[{"name":"Odile Marsh"}],"release_date":"2024-12-01","label":"Halvard Records","added_at":"2026-10-05T17:00:00Z","copies":[{"sourc…
{"type":"item","id":"itm-1302","kind":"recording","title":"Undertow","artists":[{"name":"Neon Fjord"}],"duration_ms":361000,"added_at":"2026-06-01T00:00:00Z","copies":[{"source":"src-soundcloud","ref":"1876543210","ur…
{"type":"item","id":"itm-1303","kind":"release","title":"Tidal Index","artists":[{"name":"Neon Fjord"}],"release_date":"2026-11-07","label":"Tidewater Tapes","copies":[{"source":"src-soundcloud","ref":"neon-fjord-exam…2 more lines in the file.
promos-and-rips.mix.ndjson
DownloadFiles with no release: a label's promo (with via), an unidentified rip with an empty title and no artists, and an "ID" recorded at a gig, in a list to identify.
{"type":"mix","version":"2.0","generated_at":"2026-10-20T09:00:00Z","generator":{"name":"Mixwell 4 (example DJ app)","url":"https://mixwell.example"},"counts":{"sources":1,"items":3,"recordings":3,"releases":0,"lists"…
{"type":"source","id":"src-promos","platform":"local","name":"Promos and rips"}
{"type":"item","id":"itm-0601","kind":"recording","title":"Undertow (Promo Edit)","artists":[{"name":"Neon Fjord"}],"duration_ms":347000,"label":"Tidewater Tapes","added_at":"2026-10-14T09:12:00Z","copies":[{"source":…
{"type":"item","id":"itm-0602","kind":"recording","title":"","artists":[],"duration_ms":284000,"copies":[{"source":"src-promos","ref":"Rips/Unknown tape side B/track07.wav","ownership":"file","file":{"mime":"audio/wav…
{"type":"item","id":"itm-0603","kind":"recording","title":"ID (warehouse rip)","artists":[],"bpm":130,"copies":[{"source":"src-promos","ref":"Rips/2026-09-12 warehouse/ID 03.flac","ownership":"file","file":{"mime":"au…
{"type":"list","id":"lst-to-identify","name":"To identify","ordered":false,"entries":[{"item":"itm-0602"},{"item":"itm-0603"}]}
spotify-export.mix.ndjson
DownloadA streaming export: Liked Songs (role: saved), two playlists (curated, with the platform's ref), and a saved album as a kind: release item in a saved list, which a song's copy names as its release. The source has a stable account and an account_name for people.
{"type":"mix","version":"2.0","generated_at":"2026-10-18T09:30:00Z","generator":{"name":"Example Streaming Exporter","url":"https://exporter.example.com"},"counts":{"sources":1,"items":6,"recordings":5,"releases":1,"l…
{"type":"source","id":"src-spotify","platform":"spotify","name":"Spotify","account":"31exampl3listener0000a","account_name":"example-listener"}
{"type":"item","id":"itm-0001","kind":"recording","title":"Glass Tides","artists":[{"name":"Lumen Arcade"}],"album":"Harbour Lights","duration_ms":214000,"release_date":"2026-03-06","ids":{"isrc":"XXEXA2600001"},"adde…
{"type":"item","id":"itm-0002","kind":"recording","title":"Paper Satellites","artists":[{"name":"Velvet Static"}],"album":"Paper Satellites","duration_ms":198500,"release_date":"2025-11-14","ids":{"isrc":"XXEXA2500002…
{"type":"item","id":"itm-0003","kind":"recording","title":"Northbound Static","artists":[{"name":"Odile Marsh"}],"album":"Cold Weather Songs","duration_ms":251000,"release_date":"2024","ids":{"isrc":"XXEXA2400003"},"a…
{"type":"item","id":"itm-0004","kind":"recording","title":"Low Orbit Lullaby","artists":[{"name":"The Quiet Harbors"}],"duration_ms":187000,"added_at":"2026-06-30T23:11:00Z","copies":[{"source":"src-spotify","ref":"0e…6 more lines in the file.
various-artists.mix.ndjson
DownloadA Various Artists compilation (release_type: compilation): the release credits "Various Artists", each track its own artists (one "feat.", as a credit's join), album_artists for display, one track its composers and ISWC, and every track's copy names the release with its track_number.
{"type":"mix","version":"2.0","generated_at":"2026-10-20T09:00:00Z","generator":{"name":"Example Streaming Exporter","url":"https://exporter.example.com"},"counts":{"sources":1,"items":5,"recordings":4,"releases":1,"l…
{"type":"source","id":"src-spotify","platform":"spotify","name":"Spotify","account":"31exampl3listener0000a","account_name":"example-listener"}
{"type":"item","id":"itm-0701","kind":"release","title":"Low Tide, Vol. 1","artists":[{"name":"Various Artists"}],"release_type":"compilation","release_date":"2026-07-31","label":"Tidewater Tapes","catalog_number":"TW…
{"type":"item","id":"itm-0711","kind":"recording","title":"Glass Tides (Low Tide Version)","artists":[{"name":"Lumen Arcade"}],"album":"Low Tide, Vol. 1","album_artists":[{"name":"Various Artists"}],"ids":{"isrc":"XXE…
{"type":"item","id":"itm-0712","kind":"recording","title":"Salt Road","artists":[{"name":"Odile Marsh"}],"album":"Low Tide, Vol. 1","album_artists":[{"name":"Various Artists"}],"composers":[{"name":"Odile Marsh"},{"na…
{"type":"item","id":"itm-0713","kind":"recording","title":"Ferry Lights","artists":[{"name":"The Quiet Harbors","join":" feat. "},{"name":"Mira Holt"}],"album":"Low Tide, Vol. 1","album_artists":[{"name":"Various Arti…2 more lines in the file.