Manifests
Four different types of so called manifests are used in order to specify metadata and settings:
- A single
catalog.eno
file, which always is placed at the root of the catalog directory, provides settings that apply to the site in general, as well as to all releases, tracks and artists on that site. - The
release.eno
manifests, which are always placed alongside audio files (that is, in release directories), allow specifying options that apply to that specific release only, and they can override options that were set in thecatalog.eno
file. - The
track.eno
manifests, which can be used to set and override options on specific tracks if needed. In order to use this type of manifest, wrap an audio file in a release into its own track directory and place thetrack.eno
file next to it, within its track directory. - The
artist.eno
manifests each go into a separate directory that is dedicated to a single artist (note that this is mostly relevant if you have a site that features multiple artists and uses label mode. As you'd expect, this is where you specify options and metadata for that specific artist.
Catalog/
├─ catalog.eno
├─ An Artist/
│ └─ artist.eno
├─ Another Artist/
│ └─ artist.eno
├─ First Release/
│ ├─ release.eno
│ ├─ track_1.mp3
│ ├─ track_2.mp3
│ └─ track_3.mp3
└─ Second Release/
├─ release.eno
├─ track_1.mp3
├─ track_2.mp3
└─ Track 3/
├─ track.eno
└─ track_3.mp3
In the example above, everything defined in catalog.eno
applies to An Artist
,
Another Artist
, First Release
and Second Release
, but the artist.eno
and release.eno
manifests can selectively override options for the artist/release
directories they are placed in. Inside Second Release
one of the audio files is
additionally wrapped into its own track directory with its own track.eno
file,
which augments and/or overrides any settings made to it at a higher level (release
or catalog-wide).
Here is an example release.eno
manifest to give you an idea of how they work:
title: Second Release
cover:
description = An ink drawing of a barren tree with monkeys in its branches
file = cover.jpg
release_downloads:
- mp3
- opus
-- more
Recorded in the summer of '94 at West Callaghan Ranch, XE.
Featuring Ted Tukowsky on Trombone and Lisa Merringfield on Theremin.
-- more
For details on the syntax used in the manifest files see the eno language guide on the eno website, simply modifying the examples in the manual should get you there without any problems though, the example here is pretty much as complex as it gets.