Faircamp 2.0 Docs
On this page

Manifests

Six different types of so called manifests are used in order to specify metadata and settings:

  • artist.eno manifests each go into a separate directory that is dedicated to an artist.
  • catalog.eno manifests each go into a seperate directory that is dedicated to presenting a collection of releases on the site (presently always all of them, but this will be expanded in the future to allow hand picking a selection of releases).
  • defaults.eno manifests can be placed in purely organizational directories that contain any number of artists, catalogs, multitracks or tracks. They contain settings that are passed on as defaults to all subdirectories.
  • multitrack.eno manifests are placed in directories that contain multiple audio files, either directly or spread across their own track directories, representing for instance an album, or a podcast
  • site.eno is a singular manifest file which always is placed at the root of the site directory, providing settings that apply to the site in general, as well as to all entities within it through default setting inheritance
  • track.eno manifests always go into track directories, which may exist as stand-alone track releases, or as tracks within a multitrack directory. A track directory may contain at most one audio file, or none if the audio is not yet available.
Directory Site/
Manifest site.eno
Directory Homepage/
Manifest catalog.eno
Directory An Artist/
Manifest artist.eno
Directory Another Artist/
Manifest artist.eno
Directory First Release/
Manifest multitrack.eno
Audio file track_1.mp3
Audio file track_2.mp3
Audio file track_3.mp3
Directory Second Release/
Manifest multitrack.eno
Audio file track_1.mp3
Audio file track_2.mp3
Directory Track 3/
Manifest track.eno
Audio file track_3.mp3
Directory Third Release/
Manifest track.eno
Audio file track.mp3

In the example above, everything defined in site.eno applies to Homepage, An Artist, Another Artist, First Release, Second Release and Third Release, but the artist.eno, catalog.eno, multitrack.eno and track.eno manifests can selectively override settings for the 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 (at the multitrack or site-level).

Here is an example multitrack.eno manifest to give you an idea of how they work:

title: Second Release

cover: cover.jpg
cover_description: An ink drawing of a barren tree with monkeys in its branches

download_formats:
- 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 docs should get you there without any problems though, the examples given are as complex as it gets.