Faircamp

https://simonrepp.com/faircamp/manual/
Admin
Faircamp is a static site generator that helps musicians and record labels create and host their own...
Tokens:24,817
Snippets:399
Trust Score:8.5
Update:6 months ago
Show doc for...
Tokens:
Raw
### Example release.eno Manifest

Source: https://simonrepp.com/faircamp/manual/manifests.html

Demonstrates the structure and content of a release.eno manifest file, used to specify options for a specific release.

```yaml
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

```

--------------------------------

### Synopsis Example

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Provide a short, plain-text introduction for the artist using the `-- synopsis` markers.

```text
-- synopsis
A mysterious artist of many talents.
-- synopsis
```

--------------------------------

### Faircamp Catalog Structure Example

Source: https://simonrepp.com/faircamp/manual/getting-started.html

Illustrates the expected directory and file organization for Faircamp input. Directories containing audio files are treated as releases.

```text
The Artist/               <--- Top directory ("Catalog")
├─ Greatest Hits/           <--- Nested Directory ("Release")
│  ├─ One Hit Wonder.mp3      <--- Audio File ("Track")
│  ├─ Summer Hit.mp3
│  └─ Underrated Cult Song.mp3
└─ Bootlegs/                <-- Extra nesting (optional)
   └─ Live in Megacity/       <--- Nested Directory ("Release")
      ├─ Best Ballad Ever.mp3   <--- Audio File ("Track")
      ├─ Another Summer Hit.mp3
      ├─ CD Sleeve.jpg          <--- Cover image (optional)
      └─ Booklet.pdf            <--- Extra files to include (optional)

```

--------------------------------

### Release Manifest Configuration

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Example of a comprehensive release manifest file (`release.eno`) demonstrating various configuration options for a specific release. This includes title, permalink, date, release artists, download formats, embed options, and theme customization.

```yaml
title: Ape Affairs (Bonus Track Edition)
permalink: ape-affairs-bonus-track-edition
date: 2019-11-03

release_artist: Heston Exchange

release_downloads:
- flac
- mp3
- opus

m3u: disabled
more_label: Liner Notes
track_numbering: arabic-dotted

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

-- synopsis
Nobody thought it possible, until somebody did it. The release that started it all!
-- synopsis

-- more
Recorded in the summer of '94 at West Callaghan Ranch, XE.

Featuring Ted Tukowsky on Trombone and Lisa Merringfield on Theremin.
-- more

theme:
accent_brightening = 85
accent_chroma = 50
accent_hue = 23
base = light
base_chroma = 34
base_hue = 180

```

--------------------------------

### Define a full artist manifest

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Example of a complete artist.eno file defining name, permalink, aliases, image, and extended description.

```eno
name: Alice
permalink: alice-artist

aliases:
- Älice
- Alice (feat. Bob)

image:
description = Alice in a field
file = example.jpg

-- more
Alice is a classic recording artist from the 70ies.

Over the years she has appeared in various collaborations, most notably with Bob.
-- more
```

--------------------------------

### Timecode Linking Syntax Details

Source: https://simonrepp.com/faircamp/manual/linking-to-timecodes-tracks.html

These examples demonstrate the basic syntax for linking to timecodes and tracks. The first track is assumed if no track number is specified.

```url
#time=30s
```

```url
#track=2
```

```url
#track=2&time=30s
```

--------------------------------

### Define a track directory structure

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Example of the directory hierarchy for a release containing a track with its own manifest and assets.

```text
Example EP/               <--- Release directory
├─ cover.jpg                 <--- Release cover image
├─ release.eno               <--- Release manifest
├─ 01 First Track/           <--- Track directory
│  ├─ cover.jpg                 <--- Track cover image
│  ├─ track.eno                 <--- Track manifest
│  └─ 01 First Track.mp3        <--- Track audio file
├─ 02 Second Track.mp3       <--- Track audio file
└─ 03 Third Track.mp3        <--- Track audio file
```

--------------------------------

### Visual Guide for Home Image Content Visibility

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Diagram illustrating aspect ratios for `home_image` to ensure content remains visible across different screen sizes. Place critical content within the 2.25:1 aspect ratio at the center of a 5:1 image.

```text
|<-------  5:1 (e.g. 1500×300)  ------->|
┌─────────────┬───────────┬─────────────┐
│             │           │             │
│   CROPPED   │ LOGO SAFE │   CROPPED   │
│             │           │             │
└─────────────┴───────────┴─────────────┘
              |<--------->|
           2.25:1 (e.g. 675×300)

```

--------------------------------

### Set Website Language

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Configure the `language` option to set the primary language for the Faircamp website. For example, setting it to 'fr' will display the site in French.

```yaml
language: fr
```

--------------------------------

### Run Faircamp Preview Command

Source: https://simonrepp.com/faircamp/manual/getting-started.html

Execute this command within your catalog directory to build the site and automatically open it in your browser. Press Ctrl+C to stop the preview server.

```bash
faircamp --preview

```

--------------------------------

### Set Home Image and Description

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Configure the `home_image` to display a logo or photo on the homepage. The `file` specifies the image path, and `description` serves as alt text for accessibility.

```yaml
home_image:
description = Me in my studio
file = studio_3.png
```

--------------------------------

### Basic catalog.eno Configuration

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Sets global site properties like title, base URL, and language. Enables features like embedding and M3U playlists. Defines default release download formats and includes optional sections for home images, links, synopses, and themes.

```eno
title: My music
base_url: https://example.com/my-music/
language: en

label_mode
show_support_artists

embedding: disabled
m3u: enabled
more_label: About

release_downloads:
- flac
- mp3
- opus

home_image:
description = Me in my studio
file = studio_3.png

link:
url = https://example.com/my-music-elsewhere/

link:
label = Blog
url = https://example.com/my-blog/

-- synopsis
Just some of my music
-- synopsis

-- more
Some of my music released between 1999-2005.

For further information check out my [website](https://example.com)
-- more

theme:
accent_brightening = 85
accent_chroma = 50
accent_hue = 23
base = light
base_chroma = 34
base_hue = 180

```

--------------------------------

### Internal Links for Release 'more' Field

Source: https://simonrepp.com/faircamp/manual/linking-to-timecodes-tracks.html

When editing the 'more' field for an episode or release, use these markdown-style links to navigate to specific timecodes within the audio. Ensure the links start with '#'.

```markdown
-- more
In today's episode I talk to Alice about Foo, enjoy!

[Introduction](#time=1m20s)
[What is Foo anyway](#time=14m)
[Practical strategies for using Foo](#time=52m12s)
[Discussing the impacts of Foo](#time=1h26m3s)
[Farewell and preview for the next episode](#time=2h7m)
-- more
```

--------------------------------

### Implement Soft Paycurtain for Downloads

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Require users to pass a soft paycurtain before downloading. This involves setting a price and payment instructions using `track_price` and `payment_info`.

```config
track_download_access: paycurtain
```

--------------------------------

### Configure All Feeds

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Set `feeds` to `all` to generate Atom, generic RSS, and Podcast RSS feeds. Requires `base_url` to be set.

```yaml
feeds: all
```

--------------------------------

### Protect Downloads with a Code

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Set downloads to require a code for access. Configure the specific codes using the `download_code(s)` option and provide instructions via `payment_info`.

```config
track_download_access: code
```

--------------------------------

### Manage Release Extras

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Configure how additional files in the release directory are handled during downloads.

```yaml
release_extras: disabled
```

```yaml
release_extras: separate
```

```yaml
release_extras:
- bundled
- separate
```

--------------------------------

### Enable Free Track Downloads

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Sets the default track download access to free downloads. This is the default behavior and can be explicitly re-enabled in a manifest.

```toml
track_download_access: "free"
```

--------------------------------

### Catalog Manifest Configuration

Source: https://simonrepp.com/faircamp/manual/artist-download-codes.html

The catalog.eno file defines site-wide metadata, external links, and theme settings.

```eno
title: Say the Magic Word
base_url: https://example.com

link:
label = Become a Patron
url = https://example.com/become-patron/

-- synopsis
The Say the Magic Word EP is out. Stream here, and to access downloads get a
download code by becoming a patron!
-- synopsis

theme:
accent_brightening = 13
accent_chroma = 20
accent_hue = 163
base = light
base_chroma = 14
base_hue = 116
```

--------------------------------

### Link to Release Page with Specific Track and Time

Source: https://simonrepp.com/faircamp/manual/linking-to-timecodes-tracks.html

Use this format to link to a release page, automatically opening a specific track at a given timecode. The track number and time are appended to the release URL.

```url
https://example.com/release/#track=3&time=20s
```

--------------------------------

### Release Manifest Configuration (release.eno) - Enter the Maze

Source: https://simonrepp.com/faircamp/manual/artist-soft-paycurtain.html

Defines specific details for a music release, including its permalink, release date, price, and cover art information.

```eno
permalink: enter-the-maze
date: 2023-05-15

release_price: 4+ USD

cover:
description = Enter the maze
file = enterthemaze.png
```

--------------------------------

### Set Background Image and Opacity

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Specify a background image for the Faircamp site and control its opaqueness using background_alpha. Choose images carefully to maintain readability.

```yaml
theme:
background_alpha = 23
background_image = squiggly_monsters_texture.jpg
```

--------------------------------

### Set Background Image and Opacity

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Specify a background image for the site and control its opaqueness. Ensure the image and its opacity do not hinder site readability.

```toml
theme:
  background_alpha = 23
  background_image = "squiggly_monsters_texture.jpg"
```

--------------------------------

### Define release synopsis

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Provide a short, plain-text introduction for a release.

```text
-- synopsis
Nobody thought it possible, until somebody did it. The release that started it all!
-- synopsis
```

--------------------------------

### Set permalink

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Defines the URL slug for the release.

```yaml
permalink: example-ep
```

--------------------------------

### Enable playback speed controls with speed_controls

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Toggle playback speed controls for audio players, useful for podcasts or audiobooks.

```yaml
speed_controls: enabled
```

--------------------------------

### Catalog Directory Structure

Source: https://simonrepp.com/faircamp/manual/artist-download-codes.html

The file system layout for a Faircamp project, including the catalog manifest and release subdirectories.

```text
saythemagicword/             <--- Catalog
├─ catalog.eno                 <--- Catalog manifest
├─ MagicSansV1.3-Book.woff2    <--- Custom font
└─ saythemagicword-ep/           <--- Release
   ├─ release.eno                <--- Release manifest
   ├─ ep-cover.png               <--- Release cover
   ├─ booklet.pdf                <--- Extra
   ├─ 01.flac                    <--- Track
   ├─ 02.flac                    <--- Track
   ├─ 03.flac                    <--- Track
   ├─ 04.flac                    <--- Track
   └─ 05.flac                    <--- Track
```

--------------------------------

### Configure visual theme

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Adjust the visual appearance of the site, including base color scheme and dynamic range.

```yaml
theme:
base = light
```

```yaml
theme:
dynamic_range = 24
```

--------------------------------

### Release Date Configuration

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Sets the release date, which is used for sorting releases on the homepage and artist pages. Dates must be in `YYYY-MM-DD` format.

```yaml
date: 1999-12-31

```

--------------------------------

### Release Manifest with Download Codes

Source: https://simonrepp.com/faircamp/manual/artist-download-codes.html

The release.eno file configures specific download formats and defines the valid access codes for the release.

```eno
permalink: say-the-magic-word-ep
date: 2023-11-15

cover:
description = My dog Winston with a paper party hat (he's tiny)
file = ep-cover.png

release_downloads:
- flac
- mp3
- opus

> The artist offers two different tiers of patronage. On the standard tier,
> they give access to the first EP released (these patrons received the
> download code "magicfanlove"). Supporters that paid extra, are in the
> special tier and got the download code "magicsuperfanspectacular" which
> the artist will then also add to the upcoming releases, so these patrons
> can access all downloads by the artist.
release_download_access: code
download_codes:
- magicfanlove
- magicsuperfanspectacular

> This is the text that is shown on the page where visitors need to enter
> a code to access the downloads.
-- unlock_info
You can obtain a download code by [becoming a patron](https://tinyurl.com/say-support)!
-- unlock_info
```

--------------------------------

### Release Manifest Configuration (release.eno) - Dark Cybernetic Beings

Source: https://simonrepp.com/faircamp/manual/artist-soft-paycurtain.html

Sets up a music release, specifying its permalink, date, price, and cover art. This release is also priced at 0+ USD.

```eno
permalink: network-angst
date: 2022-09-02

release_price: 0+ USD

cover:
description = An abstract depiction of a crowd of people in a backalley, like in matrix, but more sinister
file = darkcyberneticbeings.png
```

--------------------------------

### Configure Specific Feeds

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Use a list for the `feeds` option to specify exactly which feeds to generate, such as generic RSS and Podcast RSS. Requires `base_url` to be set.

```yaml
feeds:
- generic_rss
- podcast_rss
```

--------------------------------

### Enable Track Extras

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Enable track extras to be offered as separate downloads. This is the default behavior and includes additional files like artwork or liner notes.

```yaml
track_extras: enabled
```

--------------------------------

### Set Multiple Download Codes

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Provide a list of codes for download access using the `download_codes` option. Ensure `release_download_access` or `track_download_access` is also set.

```yaml
download_codes:
- GOLDsupporter
- SILVERsupporter
```

--------------------------------

### Configure cover image

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Set the track cover image and its accessibility description.

```eno
cover:
description = An ink drawing of a barren tree with monkeys in its branches
file = cover.jpg
```

--------------------------------

### Faircamp Catalog Directory Structure

Source: https://simonrepp.com/faircamp/manual/manifests.html

Illustrates the hierarchical organization of Faircamp catalog files, including manifests and audio files.

```text
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

```

--------------------------------

### Remove All Tags

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Configure Faircamp to produce entirely untagged files for streaming and download. Use this if you want to strip all metadata.

```yaml
tags: remove
```

--------------------------------

### Configure External Download Link

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Use an external URL for the download button to redirect users to a different site for downloads. This is useful when tracks are hosted elsewhere.

```config
track_download_access: https://example.com/artist/purchase/
```

--------------------------------

### Catalog Manifest (catalog.eno)

Source: https://simonrepp.com/faircamp/manual/artist-free-downloads.html

Defines global settings for the artist site, including title, base URL, home image, and available download formats for all releases. This file applies to all releases in the directory hierarchy.

```yaml
title: Free Metal
base_url: https://example.com/

home_image:
description = The band, looking tough
file = so-tough.jpg

release_downloads:
- opus
- mp3

-- synopsis
Hey Metalheads! Check our newest releases "Much Doublebass" and "Very Tapping" - we've
got them out for free download for you cuties! xoxo, Free Metal
-- synopsis

```

--------------------------------

### Set Light Theme Base

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Configure the base theme to 'light'. This sets the overall appearance of the Faircamp site.

```yaml
theme:
base = light
```

--------------------------------

### Add a track synopsis with synopsis

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Provide a short, plain-text introduction for the track, limited to 256 characters.

```text
-- synopsis
Nobody thought it possible, until somebody did it. The track that started it all!
-- synopsis
```

--------------------------------

### Configure download codes

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Set single or multiple download codes for track access.

```eno
download_code: crowdfunding2023
```

```eno
download_codes:
- GOLDsupporter
- SILVERsupporter
```

--------------------------------

### Set Multiple Track Download Formats

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Configure multiple download formats for individual tracks. This allows users to choose their preferred format.

```yaml
track_downloads:
- flac
- mp3
- opus
```

--------------------------------

### Configure Cache Optimization Strategy

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Sets the cache optimization strategy for Faircamp's asset cache. Options include 'delayed', 'immediate', 'wipe', and 'manual' for managing build artifacts.

```eno
cache_optimization: delayed

```

--------------------------------

### Configure Download URL Freezing

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Use `freeze_download_urls` to generate unique download URLs. The provided text is used for randomization and can be updated to invalidate old URLs. A date is a common choice for this text.

```yaml
freeze_download_urls: [put-any-text-here]
```

--------------------------------

### Catalog Manifest Configuration (catalog.eno)

Source: https://simonrepp.com/faircamp/manual/artist-soft-paycurtain.html

Defines site-wide settings including title, base URL, streaming quality, download formats, payment options, and artist information.

```eno
title: Electric Curtain
base_url: https://curtain.electric/

> To save bandwidth and storage, the artist here reduces the
> streaming quality a little bit.
streaming_quality: frugal

-- more
Hailing from the small town of Welkenraedt, Electric Curtain sucks you into
a gigantesque dystopian world of hard and harsh bass-driven synth.

Support me on [ko-fi](https://ko-fi.com/electriccurtainisfiction)
-- more

release_download_access: paycurtain

> These settings apply to all releases, here we just set
> the download format for all of them. As each of them
> has a different price, that setting is individually set
> in each of the .eno files alongside the releases.
release_downloads: flac

> For each release these two payment options will be shown,
> as the settings here apply to all releases
-- payment_info
Option 1: Pay via [ko-fi](https://ko-fi.com/electriccurtainisfiction)

Option 2: Pay via [paypal](https://paypal.me/electriccurtainisfiction)
-- payment_info

> The artist uses a short-form artist declaration here, because the only
> needed adjustments here concern the name and aliases, which can be done
> with the short form. (With a page in label mode, when artists are featured
> with their own pages, including images and longer texts, a separate
> artist.eno manifest file per artist is the way to go instead)
external_artist:
> On the page we stylize the name with upside-down pentagrams, because.
name = ⛧ Electric Curtain ⛧
> Any release or track that has artist metadata matching one of
> the three aliases below will be associated with this artist.
alias = Electric Curtain
alias = Electric Curtain feat. Miley Vaniley
alias = Electric Curtain × Die Arbeit der Nacht

> There are two guest artists, for which the artist also uses a short-form
> artist definition in order to correctly associate them with the
> respective tracks (which specify an artist name that actually mixes two
> artists together, and as such couldn't be auto-detected as two artists)

external_artist:
name = Miley Vaniley
> One track features Miley Vaniley, and through an alias
> we correctly associate it with them.
alias = Electric Curtain feat. Miley Vaniley

external_artist:
name = Die Arbeit der Nacht
> One track features Die Arbeit der Nacht, and through an alias
> we correctly associate it with them.
alias = Electric Curtain × Die Arbeit der Nacht

theme:
background_alpha = 36
background_image = abstractsyntaxthreat.png
> The dark theme with high dynamic range (= deep black) nicely fits the darkness of the music
base = dark
dynamic_range = 100
```

--------------------------------

### Separate Release Extras Downloads

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

To provide release extras as separate downloads only, set `release_extras` to `separate`.

```yaml
release_extras: separate
```

--------------------------------

### Configure release download formats

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Specifies the file formats available for downloading entire releases as archives.

```yaml
release_downloads: flac
```

```yaml
release_downloads:
- flac
- mp3
- opus
```

--------------------------------

### Configure artist aliases

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Use aliases to map different artist name variations to a single profile.

```eno
alias: Älice
```

```eno
aliases:
- Älice
- Alice (feat. Bob)
```

--------------------------------

### Configure system fonts

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Use visitor system fonts instead of the default Barlow font.

```yaml
theme:
system_font = sans
```

```yaml
theme:
system_font = mono
```

--------------------------------

### Configure Podcast RSS Feed

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Set `feeds` to `podcast_rss` to generate a single Podcast RSS feed. Ensure your `base_url` is set and that releases contain only a single track for proper feed generation.

```yaml
feeds: podcast_rss
```

--------------------------------

### Release Manifest Configuration (release.eno) - Network Angst

Source: https://simonrepp.com/faircamp/manual/artist-soft-paycurtain.html

Configures a music release with its permalink, release date, price, and cover art details. This release is offered at 0+ USD.

```eno
permalink: network-angst
date: 2022-12-20

release_price: 0+ USD

cover:
description = A 56k modem in neon colors
file = networkangst.png
```

--------------------------------

### Copy All Tags

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Configure Faircamp to transfer all tags 1:1 from the source file to the transcoded files. This is useful when you want to preserve all existing metadata.

```yaml
tags: copy
```

--------------------------------

### Bundled and Separate Release Extras

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

To provide release extras both bundled with archives and as separate downloads, list `bundled` and `separate` under `release_extras`.

```yaml
release_extras:
- bundled
- separate
```

--------------------------------

### Set Single Track Download Format

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Configure a single download format for individual tracks. Ensure this is set to enable separate track downloads.

```yaml
track_downloads: flac
```

--------------------------------

### Set Single Download Code

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Use the `download_code` option to specify a single code for accessing downloads. Remember to activate download codes using `release_download_access` or `track_download_access`.

```yaml
download_code: crowdfunding2023
```

--------------------------------

### Enable Feature/Support Artists Linking

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Set the `feature_support_artists` flag to enable linking for featured/support artists and give them their own pages. This option is only relevant in label mode.

```yaml
feature_support_artists
```

--------------------------------

### Configure playback speed controls

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Enable or disable playback speed controls for audio players.

```yaml
speed_controls: enabled
```

```yaml
speed_controls: disabled
```

--------------------------------

### Adjust Detail Color Settings

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Customize the "colorfulness" and base hue of the site, as well as the accent color's brightness, chroma, and hue. `base_chroma` controls overall colorfulness, `base_hue` sets the base color, `accent_chroma` and `accent_hue` adjust accent colors, and `accent_brightening` controls accent color lightness.

```toml
theme:
  accent_brightening = 85
  accent_chroma = 50
  accent_hue = 23
  base_chroma = 34
  base_hue = 180
```

--------------------------------

### Release Manifest (release.eno) - Much Doublebass

Source: https://simonrepp.com/faircamp/manual/artist-free-downloads.html

Specifies details for a specific release, such as title, permalink, date, cover image, and synopsis. The permalink is used to construct the release's URL. This manifest overrides or supplements catalog-level settings.

```yaml
title: Much Doublebass (Deluxe Edition)
permalink: much-doublebass-album
date: 2023-10-13

cover:
description = The band, looking tough (with yellow plush hats)
file = cover.jpg

-- synopsis
We're so excited to share our latest release with you, enjoy!
-- synopsis

-- more
Mastered by our good friends at the Doom Dungeon.
-- more

```

--------------------------------

### Configure track links

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Add external or internal links to the track page header.

```eno
link: https://example.com/this/track/elsewhere/

link:
url = https://example.com/this/track/elsewhere/

link:
label = A review for this track
url = https://example.com/some-blog/some-review/

link:
label = Staff
url = #staff
```

--------------------------------

### Cover Image Configuration

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Specifies the cover image file and its description for accessibility. The description serves as alt text for the image.

```yaml
cover:
description = An ink drawing of a barren tree with monkeys in its branches
file = cover.jpg

```

--------------------------------

### Customize more label

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Changes the default 'More' link label to a custom string.

```yaml
more_label: Liner Notes
```

--------------------------------

### Set Custom Favicon

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Specify a custom favicon file (e.g., `.png`, `.ico`) using the `favicon` option. Use `favicon: none` to omit the favicon entirely.

```yaml
favicon: my_favicon.png
```

--------------------------------

### Include Site Assets

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Specify arbitrary files for inclusion in the build's root directory using `site_assets`. This can be used for analytics scripts, custom stylesheets, or font files.

```yaml
site_assets:
- analytics.js
- custom.css
- my_font.woff2
```

```yaml
site_assets: custom.css
```

--------------------------------

### Use System Monospace Font

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Configures the site to use the visitor's default system monospace font. Requires manual integration via `site_assets` and `site_metadata`.

```toml
theme:
  system_font = "mono"
```

--------------------------------

### Release Manifest (release.eno) - Very Tapping

Source: https://simonrepp.com/faircamp/manual/artist-free-downloads.html

Defines metadata for the 'Very Tapping' release, including its permalink, date, and cover image. This manifest demonstrates how to set release-specific details.

```yaml
permalink: very-tapping-album
date: 2022-07-01

cover:
description = The band, looking not so tough for a change
file = album.jpg

```

--------------------------------

### Configure payment information with payment_info

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Provide external links for payments or donations when using the paycurtain download access setting. Supports Markdown.

```text
-- payment_info
Most easily you can transfer the money for your purchase
via my [liberapay account](https://liberapay.com/somewhatsynthwave)

Another option is supporting me through my [ko-fi page](https://ko-fi.com/satanclaus92)

If you're in europe you can send the money via SEPA, contact me at
[lila@thatawesomeartist42.com](mailto:lila@thatawesomeartist42.com) and I'll
send you the account details.

On Dec 19th I'm playing a show at *Substage Indenhoven* - you can get the
digital album now and meet me at the merch stand in december in person to give
me the money yourself as well, make sure to make a note of it though! :)
-- payment_info
```

--------------------------------

### Set Base URL for Site

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Configures the base URL for the Faircamp site, essential for generating embeds, M3U playlists, and feeds.

```eno
base_url: https://example.com

```

--------------------------------

### Enable M3U Playlists

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Control the generation of M3U playlists. Options include enabling for the entire catalog, only for releases, or disabling them entirely.

```yaml
m3u: enabled
```

```yaml
m3u: catalog
```

```yaml
m3u: releases
```

--------------------------------

### Set Unlock Information for Download Codes

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Customize the text displayed to users when they are prompted for a download code. Use this to provide instructions on obtaining codes.

```text
-- unlock_info
You should have received a download code in your confirmation mail
for this year's crowdfunding. Stay tuned in case you missed it,
we're currently planning the next run!
-- unlock_info
```

--------------------------------

### Define site synopsis

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Provide a short, plain-text introduction for the catalog, limited to 256 characters.

```text
-- synopsis
My self hosted faircamp site, presenting some of my music.
Thanks for stopping by!
-- synopsis
```

--------------------------------

### Display Support Artists

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Use the `show_support_artists` flag to include support artists (features, guest artists, collaborators) in listings.

```yaml
show_support_artists
```

--------------------------------

### Configure site_metadata with external assets

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Use site_metadata to inject scripts, styles, or meta tags into the site head. Assets must be referenced using double curly braces to ensure correct relative paths.

```yaml
site_assets: analytics.js

-- site_metadata
<script src="{{analytics.js}}"></script>
-- site_metadata
```

```yaml
site_assets:
- custom.css
- marker.png

-- site_metadata
<link href="{{custom.css}}" rel="stylesheet">
-- site_metadata
```

```yaml
site_assets: marker.svg

-- site_metadata
<style>
    a { text-decoration-thickness: .2em; }
    ul {
        list-style: georgian inside url("{{marker.svg}}");
        padding-left: 0;
    }
</style>
-- site_metadata
```

```yaml
-- site_metadata
<meta name="fediverse:creator" content="@JohnMastodon@example.com"/>
-- site_metadata
```

--------------------------------

### Configure M3U Playlist

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Enable or disable the generation of an M3U playlist for the artist page.

```yaml
m3u: enabled
```

```yaml
m3u: disabled
```

--------------------------------

### Configure payment information

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Provides instructions and links for payments, displayed when using a paycurtain.

```markdown
-- payment_info
Most easily you can transfer the money for your purchase
via my [liberapay account](https://example.com)

Another option is supporting me through my [ko-fi page](https://example.com)

If you're in europe you can send the money via SEPA, contact me at
[lila@thatawesomeartist42.com](mailto:lila@thatawesomeartist42.com) and I'll
send you the account details.

On Dec 19th I'm playing a show at *Substage Indenhoven* - you can get the
digital album now and meet me at the merch stand in december in person to give
me the money yourself as well, make sure to make a note of it though! :)
-- payment_info
```

--------------------------------

### Configure Atom Feed Only

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

To provide only an Atom feed, set the `feeds` option to `atom`. Ensure `base_url` is configured.

```yaml
feeds: atom
```

--------------------------------

### Mark Release as Unlisted

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Configure a release to be present on the site but not publicly referenced. Visitors need the direct permalink to access it, useful for pre-releases or private sharing.

```config
unlisted
```

--------------------------------

### Enable rounded corners

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Apply rounded corners to release covers.

```yaml
theme:
round_corners = enabled
```

--------------------------------

### Override release title

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Manually set the release title instead of using audio metadata.

```yaml
title: Ape Affairs (Bonus Track Edition)
```

--------------------------------

### Use System Sans-Serif Font

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Configures the site to use the visitor's default system sans-serif font instead of the bundled Barlow font. Requires manual integration via `site_assets` and `site_metadata`.

```toml
theme:
  system_font = "sans"
```

--------------------------------

### Define artist image

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Specify an image file path and alt text description for the artist profile.

```eno
image:
description = Alice in a field
file = example.jpg
```

--------------------------------

### Track Extras Configuration

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Control whether additional files associated with a track are offered as separate downloads.

```APIDOC
## track_extras

### Description
Determines if additional files in a track directory are offered as separate downloads.

### Method
Configuration setting

### Endpoint
N/A

### Parameters
#### Configuration Values
- **enabled** (string) - Optional - Offer track extras as separate downloads (default behavior).
- **disabled** (string) - Optional - Omit track extras entirely.

### Request Example
```
track_extras: disabled
```

```
track_extras: enabled
```
```

--------------------------------

### Track Price Configuration

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Set the price for track downloads when using the 'paycurtain' access method.

```APIDOC
## track_price

### Description
Sets the price for track downloads when `track_download_access` is set to `paycurtain`.

### Method
Configuration setting

### Endpoint
N/A

### Parameters
#### Configuration Values
- **currency price+** (string) - Required - ISO 4217 currency code and a minimum price (e.g., `EUR 4+`).
- **currency price** (string) - Required - ISO 4217 currency code and an exact price (e.g., `3.50 GBP`).
- **currency price-price** (string) - Required - ISO 4217 currency code and a price range (e.g., `JPY 400-800`).

### Request Example
```
track_price: EUR 4+
```

```
track_price: 3.50 GBP
```

```
track_price: KRW 9080
```

```
track_price: JPY 400-800
```
```

--------------------------------

### Set the overall site title

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Define the `title` for your site, which will appear in the header, footer, and RSS feed. This is a fundamental setting for site identity.

```yaml
title: My music
```

--------------------------------

### Order of Time and Track Parameters

Source: https://simonrepp.com/faircamp/manual/linking-to-timecodes-tracks.html

The order of the 'time' and 'track' parameters in the URL does not affect functionality. Both specified orders are valid.

```url
#time=30s&track=2
```

```url
#track=2&time=30s
```

--------------------------------

### Configure release download access

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Controls how visitors access release downloads, supporting various modes like free, external, codes, or paycurtains.

```yaml
release_download_access: free
```

```yaml
release_download_access: https://example.com/artist/purchase/
```

```yaml
release_download_access: code
```

```yaml
release_download_access: paycurtain
```

```yaml
release_download_access: disabled
```

--------------------------------

### Use system sans-serif font

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Configure `system_font` to `sans` to utilize the visitor's default system sans-serif font. This avoids bundling custom fonts and relies on the user's environment. Manual integration is required for custom fonts.

```yaml
theme:
  system_font = sans
```

--------------------------------

### Configure Artist Links

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Define external links for the artist header. Supports simple URLs, labeled links, internal anchors, and verification attributes.

```yaml
link: https://example.com/this/artist/elsewhere/
```

```yaml
link:
url = https://example.com/this/artist/elsewhere/
```

```yaml
link:
label = A review of the artist
url = https://example.com/some-blog/some-review/
```

```yaml
link:
label = Discography
url = #discography
```

```yaml
link:
url = https://social.example.com/@account-a
verification = rel-me
```

```yaml
link:
url = https://social.example.com/@account-b
verification = rel-me-hidden
```

--------------------------------

### Set Track Download Formats

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Define the file formats available for individual track downloads.

```yaml
track_downloads: flac
```

```yaml
track_downloads:
- flac
- mp3
- opus
```

--------------------------------

### Configure track download access

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Set the access level for track downloads.

```yaml
track_download_access: free
```

--------------------------------

### Enable Automatic Download URL Rotation

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Enable `rotate_download_urls` to automatically generate new download URLs on each deployment, invalidating previous ones. This is a strong measure against hotlinking.

```yaml
rotate_download_urls
```

--------------------------------

### Set Release Download Price

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Use `release_price` with `paycurtain` to set the price for release downloads. Accepts ISO 4217 currency codes and price ranges.

```yaml
release_price: EUR 4+
```

```yaml
release_price: USD 0+
```

```yaml
release_price: 3.50 GBP
```

```yaml
release_price: KRW 9080
```

```yaml
release_price: INR 230+
```

```yaml
release_price: JPY 400-800
```

--------------------------------

### Set Dynamic Range for Theme

Source: https://simonrepp.com/faircamp/manual/artists-artist-eno.html

Controls the overall "blackness" or "whiteness" and color saturation of the theme. Lower values result in more differentiated grays and color tints.

```toml
theme:
  dynamic_range = 24
```

--------------------------------

### Set streaming quality with streaming_quality

Source: https://simonrepp.com/faircamp/manual/tracks-track-eno.html

Adjust the encoding quality for streaming; 'frugal' reduces bandwidth usage compared to the 'standard' default.

```yaml
streaming_quality: frugal
```

--------------------------------

### Enable Label Mode for Multi-Artist Sites

Source: https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html

Activate `label_mode` to present multiple artists on a single Faircamp site. This adds an organizational layer, giving each artist their own page and differentiating them within the catalog.

```yaml
label_mode
```

--------------------------------

### Define external links

Source: https://simonrepp.com/faircamp/manual/releases-release-eno.html

Adds links to the release page header. A URL is mandatory, and a label is required for anchor links.

```yaml
link: https://example.com/this/release/elsewhere/
```

```yaml
link:
url = https://example.com/this/release/elsewhere/
```

```yaml
link:
label = An Album review
url = https://example.com/some-blog/some-review/
```

```yaml
link:
label = Staff
url = #staff
```
Tokens:
Raw