An open standard for packaging rich media releases. Albums, films, publications — complete with artwork, liner notes, and metadata.
ARK is a modern packaging format for creative works. Think of it as "EPUB for media" — a single file containing everything a release needs.
One .ark file contains audio, video, artwork, liner notes, credits, and metadata. Everything travels together.
Standard ZIP container means any tool can open it. No special software required to extract contents.
Human-readable manifest.json describes the package structure. Easy to parse, easy to validate.
Support for multiple quality levels — hi-res, lossless, and standard — in a single package.
Markdown-based liner notes, credits, and lyrics. Renders beautifully everywhere.
URL-namespaced extensions allow custom metadata without breaking compatibility.
Every ARK package follows a consistent directory layout.
First file in archive, uncompressed. Contains: application/vnd.ark+zip
The heart of the package. Describes all contents, metadata, and structure.
Audio, video, and image files organized by type and quality level.
Cover art, back cover, inserts, and gallery images.
Markdown files for liner notes, credits, lyrics, and per-track notes.
Package integrity: checksums, signatures, and validation data.
Miles Davis — In A Silent Way (1969). A real ARK package demonstrating every feature.
{
"$schema": "https://ark.format/schema/v1/manifest.json",
"ark_version": "1.0",
"work": {
"type": "album",
"title": "In A Silent Way",
"creators": [
{
"name": "Miles Davis",
"role": "artist",
"identifiers": {
"isni": "0000000114598529",
"musicbrainz": "561d854a-6a28-4aa7-8c99-323e6ce46c2a"
}
}
],
"release_date": "1969-07-30",
"genres": ["Jazz", "Fusion", "Jazz-Rock"],
"identifiers": {
"upc": "074646987520",
"catalog_number": "CS 9875",
"musicbrainz": "78a1b0e7-26df-4be4-a316-9e11e2e60ed9"
},
"duration": "PT38M07S"
},
"contents": {
"type": "ordered",
"items": [
{
"number": 1,
"title": "Shhh/Peaceful",
"duration": "PT18M17S",
"files": {
"lossless-hires": "media/audio/lossless-hires/01-shhh-peaceful.flac",
"lossless": "media/audio/lossless/01-shhh-peaceful.flac",
"standard": "media/audio/standard/01-shhh-peaceful.mp3"
}
},
{
"number": 2,
"title": "In A Silent Way/It's About That Time",
"duration": "PT19M50S",
"files": {
"lossless-hires": "media/audio/lossless-hires/02-in-a-silent-way.flac",
"lossless": "media/audio/lossless/02-in-a-silent-way.flac",
"standard": "media/audio/standard/02-in-a-silent-way.mp3"
}
}
]
},
"artwork": {
"cover": {
"file": "artwork/cover.jpg",
"dimensions": { "width": 770, "height": 770 }
}
},
"text": {
"notes": "text/notes.md",
"credits": "text/credits.md"
},
"extensions": {
"https://ark.format/ns/music": {
"recording_date": "1969-02-18",
"recording_location": {
"studio": "CBS 30th Street Studio",
"city": "New York City"
},
"personnel": [
{ "name": "Miles Davis", "instrument": "trumpet" },
{ "name": "Wayne Shorter", "instrument": "soprano saxophone" },
{ "name": "John McLaughlin", "instrument": "electric guitar" },
{ "name": "Herbie Hancock", "instrument": "electric piano" },
{ "name": "Chick Corea", "instrument": "electric piano" },
{ "name": "Joe Zawinul", "instrument": "organ" },
{ "name": "Dave Holland", "instrument": "bass" },
{ "name": "Tony Williams", "instrument": "drums" }
]
}
}
}
text/notes.md
text/chapters/01.md and text/chapters/02.md
Key fields in the manifest.json file.
| Field | Type | Description |
|---|---|---|
type required |
string | Content type: album, single, ep, compilation, film, series, book |
title required |
string | Primary title of the work |
creators required |
array | Artists/authors with name, role, and optional identifiers |
release_date |
ISO 8601 | Official release date |
identifiers |
object | UPC, ISBN, ISRC, catalog number, MusicBrainz ID, etc. |
| Field | Type | Description |
|---|---|---|
type |
string | "ordered" (sequential) or "unordered" (collection) |
items required |
array | List of content items (tracks, chapters, episodes) |
items[].files |
object | Quality variants: lossless-hires, lossless, standard |
| Namespace | Purpose |
|---|---|
https://ark.format/ns/music |
Recording info, personnel, production credits, awards |
https://ark.format/ns/video |
Resolution, codec, aspect ratio, subtitles |
https://ark.format/ns/blockchain |
On-chain mapping: contract address, chain ID, token ID |
https://your-domain.com/ns/custom |
Any custom extension using URL namespace |
Experience a complete ARK package with the Miles Davis player.