Examples

A 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":"omc","version":"1.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":["Lumen Arcade"],"release_type":"album","release_date":"2026-03-06","label":"Tidewater Tapes","ids":{"upc":"000000260001"},"added_at":…
{"type":"item","id":"itm-1002","kind":"release","title":"Cold Weather Songs","artists":["Odile Marsh"],"release_type":"album","release_date":"2024-12-01","label":"Halvard Records","ids":{"upc":"000000241002"},"added_a…
{"type":"item","id":"itm-1003","kind":"release","title":"Brass Meridian","artists":["Ottilie Brandt Quartet"],"release_type":"album","release_date":"1979","label":"Example Jazz Archive","ids":{"upc":"000000791003"},"a…
{"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.

Store 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":"omc","version":"1.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":["Lumen Arcade"],"release_date":"2026-03-06","label":"Tidewater Tapes","ids":{"upc":"000000260001"},"added_at":"2026-03-06T12:00:00Z",…
{"type":"item","id":"itm-0102","kind":"recording","title":"Glass Tides","artists":["Lumen Arcade"],"album":"Harbour Lights","duration_ms":214000,"ids":{"isrc":"XXEXA2600001"},"added_at":"2026-03-06T12:00:00Z","copies"…
{"type":"item","id":"itm-0103","kind":"recording","title":"Salt Road","artists":["Odile Marsh"],"album":"Cold Weather Songs","duration_ms":233400,"release_date":"2024-12-01","label":"Halvard Records","ids":{"isrc":"XX…
{"type":"item","id":"itm-0104","kind":"recording","title":"Lowlight","artists":["Kasimir Vane"],"duration_ms":402000,"release_date":"2026-07","genres":["techno"],"added_at":"2026-07-19T22:05:00Z","copies":[{"source":"…

4 more lines in the file.

A 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":"omc","version":"1.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":["Odile Marsh"],"release_date":"2025-11","label":"Halvard Records","catalog_number":"HALV BOX 1","country":"NO","ids":…
{"type":"item","id":"itm-0811","kind":"recording","title":"Salt Road (1998 demo)","artists":["Odile Marsh"],"album":"The Halvard Sessions 1998–2004","copies":[{"source":"src-shelf","ref":"box-halvard-sessions/1-01","o…
{"type":"item","id":"itm-0812","kind":"recording","title":"Harbour Song","artists":["Odile Marsh"],"album":"The Halvard Sessions 1998–2004","copies":[{"source":"src-shelf","ref":"box-halvard-sessions/1-02","ownership"…
{"type":"item","id":"itm-0821","kind":"recording","title":"Cold Weather","artists":["Odile Marsh"],"album":"The Halvard Sessions 1998–2004","copies":[{"source":"src-shelf","ref":"box-halvard-sessions/2-01","ownership"…

3 more lines in the file.

A 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":"omc","version":"1.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":["Ottilie Brandt Quartet"],"release_date":"1979","label":"Example Jazz Archive","catalog_number":"EJA 1979","country":"US","added_at":…
{"type":"item","id":"itm-1202","kind":"release","title":"Harbour Lights","artists":["Lumen Arcade"],"release_date":"2026-03-06","label":"Tidewater Tapes","catalog_number":"TWT 012","country":"GB","added_at":"2026-03-1…
{"type":"item","id":"itm-1203","kind":"release","title":"Night Ferry EP","artists":["The Quiet Harbors"],"release_date":"2025-05","label":"Tidewater Tapes","catalog_number":"TWT 009","country":"GB","added_at":"2025-06…
{"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…

A 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":"omc","version":"1.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":["Lumen Arcade"],"release_date":"2026-03-06","label":"Tidewater Tapes","catalog_number":"TWT 012","country":"GB","genres":["electronic…
{"type":"item","id":"itm-0211","kind":"recording","title":"Glass Tides","artists":["Lumen Arcade"],"album":"Harbour Lights","duration_ms":214000,"ids":{"isrc":"XXEXA2600001"},"copies":[{"source":"src-discogs","ref":"9…
{"type":"item","id":"itm-0212","kind":"recording","title":"Pier at Four","artists":["Lumen Arcade"],"album":"Harbour Lights","duration_ms":262000,"copies":[{"source":"src-discogs","ref":"900201/A2","ownership":"physic…
{"type":"item","id":"itm-0213","kind":"recording","title":"Harbour Lights","artists":["Lumen Arcade"],"album":"Harbour Lights","duration_ms":401000,"copies":[{"source":"src-discogs","ref":"900201/B1","ownership":"phys…

11 more lines in the file.

A 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":"omc","version":"1.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":["Kasimir Vane"],"duration_ms":402000,"genres":["techno"],"bpm":128,"key":"Am","provenance":{"bpm":{"origin":"analysis","by…
{"type":"item","id":"itm-0302","kind":"recording","title":"Copper Hour (Extended Mix)","artists":["Kasimir Vane","Odile Marsh"],"album":"Copper Hour","album_artists":["Kasimir Vane"],"composers":["Kasimir Vane","Odile…
{"type":"item","id":"itm-0303","kind":"recording","title":"Tidal Index","artists":["Neon Fjord"],"duration_ms":361000,"genres":["techno"],"bpm":131.5,"key":"F#m","provenance":{"bpm":{"origin":"user"},"key":{"origin":"…
{"type":"item","id":"itm-0304","kind":"recording","title":"Glass Tides (Club Edit)","artists":["Lumen Arcade"],"duration_ms":330000,"genres":["electronica"],"bpm":124,"key":"Cm","provenance":{"bpm":{"origin":"analysis…

14 more lines in the file.

A 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":"omc","version":"1.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":["Kasimir Vane"],"duration_ms":402000,"bpm":128,"copies":[{"source":"src-usb","ref":"Techno/Kasimir Vane - Lowlight (Origin…
{"type":"item","id":"itm-1102","kind":"recording","title":"Tidal Index","artists":["Neon Fjord"],"duration_ms":361000,"bpm":131.5,"copies":[{"source":"src-usb","ref":"Techno/Neon Fjord - Tidal Index.mp3","ownership":"…
{"type":"item","id":"itm-1103","kind":"recording","title":"Basement, March","artists":["Anna K"],"duration_ms":5400000,"genres":["techno"],"release_date":"2026-03-30","added_at":"2026-03-30T12:00:00Z","copies":[{"sour…

1 more lines in the file.

A 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":"omc","version":"1.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":["Kasimir Vane","Odile Marsh"],"release_date":"2026-08-28","label":"Vane Audio","catalog_number":"VANE 004","ids":{"upc":"000000260901"},…
{"type":"item","id":"itm-0911","kind":"recording","title":"Copper Hour (Extended Mix)","artists":["Kasimir Vane","Odile Marsh"],"album":"Copper Hour","duration_ms":395800,"bpm":122,"key":"Am","genres":["melodic house"…
{"type":"item","id":"itm-0912","kind":"recording","title":"Copper Hour (Dub)","artists":["Kasimir Vane"],"album":"Copper Hour","duration_ms":402000,"bpm":122,"key":"Am","ids":{"isrc":"XXEXA2600912"},"added_at":"2026-0…

1 more lines in the file.

A label's feed in JSON Feed 1.1 (Feeds module): each release entry carries its OMC item in _omc, with copies by platform; one entry is plain news. feeds/feed.atom is the same feed in Atom, with the items in omc:item.

{
  "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/" }],
  "_omc": { "version": "0.2", "kind": "label" },
  "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",

One 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; Feeds module follows; header modules.

{"type":"omc","version":"1.0","generated_at":"2026-10-18T09:30:00Z","generator":{"name":"Example Collection Host","url":"https://host.example.org"},"counts":{"sources":3,"items":4,"recordings":3,"releases":1,"lists":1…
{"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":"item","id":"itm-0401","kind":"recording","title":"Glass Tides","artists":["Lumen Arcade"],"album":"Harbour Lights","duration_ms":214000,"release_date":"2026-03-06","label":"Tidewater Tapes","ids":{"isrc":"XXE…
{"type":"item","id":"itm-0402","kind":"release","title":"Cold Weather Songs","artists":["Odile Marsh"],"release_date":"2024-12-01","label":"Halvard Records","added_at":"2025-01-15T19:40:00Z","copies":[{"source":"src-b…

5 more lines in the file.

{"type":"omc","version":"1.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/omc-source.json"}
{"type":"item","id":"itm-0501","kind":"recording","title":"Kitchen Demo No. 3","artists":["Mira Holt"],"duration_ms":171000,"release_date":"2026-09","copies":[{"source":"src-home","ref":"tracks/example-0501","url":"ht…
{"type":"item","id":"itm-0502","kind":"recording","title":"Night Drive","artists":["Mira Holt"],"album":"Night Drive EP","duration_ms":312000,"release_date":"2026-10-10","ids":{"isrc":"XXEXA2600502"},"copies":[{"sourc…
{"type":"item","id":"itm-0503","kind":"release","title":"Night Drive EP","artists":["Mira Holt"],"release_date":"2026-10-10","ids":{"upc":"000000260502"},"copies":[{"source":"src-home","ref":"releases/example-night-dr…
{"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.

Access and Delivery modules, media.stream) and a collection.omc.ndjson whose source points at it with descriptor.

{
  "omc": "1.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"],
  "modules": {
    "org.openmusiccollection.access": { "version": "0.1", "base_url": "https://music.mirasroom.example/omc" },
    "org.openmusiccollection.delivery": { "version": "0.1", "base_url": "https://music.mirasroom.example/omc" }
  }
}

Values 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":"omc","version":"1.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":["Odile Marsh"],"release_date":"2024-12-01","label":"Halvard Records","added_at":"2026-10-05T17:00:00Z","copies":[{"source":"src-s…
{"type":"item","id":"itm-1302","kind":"recording","title":"Undertow","artists":["Neon Fjord"],"duration_ms":361000,"added_at":"2026-06-01T00:00:00Z","copies":[{"source":"src-soundcloud","ref":"1876543210","url":"https…
{"type":"item","id":"itm-1303","kind":"release","title":"Tidal Index","artists":["Neon Fjord"],"release_date":"2026-11-07","label":"Tidewater Tapes","copies":[{"source":"src-soundcloud","ref":"neon-fjord-example/sets/…

2 more lines in the file.

Files 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":"omc","version":"1.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":["Neon Fjord"],"duration_ms":347000,"label":"Tidewater Tapes","added_at":"2026-10-14T09:12:00Z","copies":[{"source":"src-prom…
{"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"}]}

A share (Share module): a label sends its new EP, with a message and who it's from in the header.

{"type":"omc","version":"1.0","generated_at":"2026-10-20T09:00:00Z","generator":{"name":"Lumen Records"},"ext":{"org.openmusiccollection.share":{"from":{"name":"Lumen Records","url":"https://lumen-records.example"},"m…
{"type":"source","id":"s1","platform":"bandcamp","name":"Bandcamp"}
{"type":"item","id":"r1","kind":"release","title":"Night Drive EP","artists":["Mira Holt"],"release_date":"2026-10-20","label":"Lumen Records","ids":{"upc":"000000261020"},"copies":[{"source":"s1","ref":"3170425711","…
{"type":"item","id":"t1","kind":"recording","title":"Night Drive","artists":["Mira Holt"],"album":"Night Drive EP","duration_ms":312000,"ids":{"isrc":"XXEXA2601020"},"copies":[{"source":"s1","ref":"2854920395","url":"…

A 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":"omc","version":"1.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":["Lumen Arcade"],"album":"Harbour Lights","duration_ms":214000,"release_date":"2026-03-06","ids":{"isrc":"XXEXA2600001"},"added_at":"20…
{"type":"item","id":"itm-0002","kind":"recording","title":"Paper Satellites","artists":["Velvet Static"],"album":"Paper Satellites","duration_ms":198500,"release_date":"2025-11-14","ids":{"isrc":"XXEXA2500002"},"added…
{"type":"item","id":"itm-0003","kind":"recording","title":"Northbound Static","artists":["Odile Marsh"],"album":"Cold Weather Songs","duration_ms":251000,"release_date":"2024","ids":{"isrc":"XXEXA2400003"},"added_at":…
{"type":"item","id":"itm-0004","kind":"recording","title":"Low Orbit Lullaby","artists":["The Quiet Harbors"],"duration_ms":187000,"added_at":"2026-06-30T23:11:00Z","copies":[{"source":"src-spotify","ref":"0exampleTra…

6 more lines in the file.

A Various Artists compilation (release_type: compilation): the release credits "Various Artists", each track its own artists, album_artists for display, one track its composers and ISWC, and every track's copy names the release with its track_number.

{"type":"omc","version":"1.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":["Various Artists"],"release_type":"compilation","release_date":"2026-07-31","label":"Tidewater Tapes","catalog_number":"TWT C01","i…
{"type":"item","id":"itm-0711","kind":"recording","title":"Glass Tides (Low Tide Version)","artists":["Lumen Arcade"],"album":"Low Tide, Vol. 1","album_artists":["Various Artists"],"ids":{"isrc":"XXEXA2600071"},"copie…
{"type":"item","id":"itm-0712","kind":"recording","title":"Salt Road","artists":["Odile Marsh"],"album":"Low Tide, Vol. 1","album_artists":["Various Artists"],"composers":["Odile Marsh","Halvard Lie"],"ids":{"isrc":"X…
{"type":"item","id":"itm-0713","kind":"recording","title":"Ferry Lights","artists":["The Quiet Harbors","Mira Holt"],"album":"Low Tide, Vol. 1","album_artists":["Various Artists"],"ids":{"isrc":"XXEXA2600073"},"copies…

2 more lines in the file.