Documentation

What music can I upload to Fairplayer?

It is essential that music uploaded to Fairplayer has the artist’s permission and that of the people who hold the legal rights to each release.

How can I upload my music to Fairplayer?

Fairplayer plays music from a decentralized ecosystem. Artists and communities publish their music on their own websites and link them to a player where the user can listen to them all. Right now, there is only one program for your website that is compatible with Fairplayer: Faircamp. In the future, there will be more options.

So, to upload your music, you need to install a Faircamp, upload your catalog, and connect it to a player like fairplayer.band. If you already have a Faircamp, you just need to add and verify it at fairplayer.band/hub.

What is Faircamp?

Faircamp is a free software program that we don’t develop but that is part of our ecosystem. It is developed by Simon Repp and is an ideal static website generator for sharing an audio catalog on the internet. The public can play your music and browse your posts. There are Faircamps that are for a single artist, and others that are for a community or record label. Each one is hosted on a different web domain and server, but on it’s own, you can’t play music from one on another.

Upload music to fairplayer using faircamp

How to install faircamp?

  1. Install Faircamp: https://simonrepp.com/faircamp/download.html
  2. Download templates https://cloud.anartist.org/s/rEbT6zEy3TtBKtG
  3. File structure

Main commands for the console

Preview your faircamp

faircamp --preview

Change colors

faircamp --preview --theming-widget

How do I verify my music on Fairplayer?

For your music to appear in the player, you need to verify that the website (Faircamp) you’ve connected is yours. This ensures we have your permission to fetch and play your music. To do this, you’ll need to follow the instructions at fairplayer.band/hub. You will need to add a code we provide to the “catalog.eno” file of your faircamp.

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

-- site_metadata
<meta name="fairplayer-code" content="exampleid000">
-- site_metadata

Templates for image

Image for artist

Example artist

File scruture

Free Metal/                   <--- Catalog
├─ catalog.eno                  <--- Catalog manifest (applies to all releases)
├─ so-tough.jpg                 <--- Home image
├─ Much Doublebass/             <--- Release
│  ├─ cover.jpg                   <--- Release cover
│  ├─ release.eno                 <--- Release manifest
│  ├─ 01 Tatatatatata.wav         <--- Track
│  ├─ 02 Badababadaba.wav
│  └─ ...
└─ Very Tapping/                <--- Release
   ├─ album.jpg                   <--- Release cover
   ├─ release.eno                 <--- Release manifest
   ├─ 01 Didididididi.aiff        <--- Track
   ├─ 02 Dabadidabadi.aiff
   └─ ...

Example catalog.eno

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

-- site_metadata
<meta name="fairplayer-code" content="exampleid001">
-- site_metadata

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

Example of catalog.eno from Vidal Soler

title: Vidal Soler / Obra i servei
base_url: https://obraiservei.cat
language: ca

-- site_metadata
<meta name="fairplayer-code" content="exampleid002">
-- site_metadata

home_image:
description = portada del disc, mans tocant la guitarra
file = 5.jpg

release_downloads:
- opus
- mp3

-- synopsis

VIDAL SOLER, guitarra.
ADRIÀ PINTO, contrabaix.
MARC GÓMEZ, congues.
RICARD PARERA, bateria.

-- synopsis

theme:
base = light

Example file structure

File release.eno

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

Example realese.eno from album from Vidal:

title: Obra i servei
permalink: obra-i-servei
date: 2026-01-28

cover:
description = portada del disc
file = 5.jpg

-- synopsis

-- synopsis

-- more
Tòquio Blues (V. Soler)

El "destape" (V. Soler)

Green Dolphin St (B. Kaper / N. Washington)

Eugenol (V. Soler)

Moments robats (O. Nelson)

Farigola (V. Soler)

Enregistrat i mesclat per Vidal Soler el 4 de gener de 2026 a El Colmado (Barcelona).
Disseny de Marc Argenter.
Foto de Ricard Parera.
Bones Festes, 2026.

-- more

Remember:

  • Copy the files in the corresponding folder
  • Add image and description for each file .eno

Example for lables

This is the example from discos pinya: https://discospinya.cat/

File structure

Gemeindebau Records/        <--- Catalog
├─ catalog.eno                <--- Catalog manifest
├─ gemeindebau.png            <--- Background image
├─ Mitzi MC/                    <--- Artist
│  ├─ artist.eno                  <--- Artist manifest
│  └─ GAFAM WTF OIDA/             <--- Release
│     ├─ release.eno                <--- Release manifest
│     ├─ oida.png                   <--- Release cover
│     └─ oida.wav                   <--- Track
├─ DJ Ferdl Sedlaček/           <--- Artist
│  ├─ artist.eno                  <--- Artist manifest
│  ├─ Hauptsache Italien Sampler/ <--- Release
│  │  ├─ release.eno                <--- Release manifest
│  │  ├─ Hauptsache Italien.png     <--- Release cover
│  │  └─ Hauptsache Italien.wav     <--- Track
│  └─ Caorle Split EP/            <--- Release
│     ├─ release.eno                <--- Release manifest
│     ├─ Caorle.png                 <--- Release cover
│     └─ Caorle.wav                 <--- Track

Example of catalog.eno

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

-- site_metadata
<meta name="fairplayer-code" content="exampleid003">
-- site_metadata

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

Traduït a l’arxiu catalog.eno de Discos Pinya:

title: 🍍 Discos Pinya 🍍
base_url: https://discospinya.cat
language: ca

-- site_metadata
<meta name="fairplayer-code" content="exampleid004">
-- site_metadata

label_mode

home_image:
description = logo discos pinya
file = discospinya-logo.png

favicon: my_favicon.png

release_downloads:
- mp3

-- synopsis
DIY // Punk // Amiguisme

-- synopsis

theme: 
round_corners = enabled
background_image = fons.png
accent_brightening = 0
background_alpha = 85
base = light
base_chroma = 100
base_hue = 165
dynamic_range = 63

Example folder for artist

Structure artist.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

Traduït a la l’artist.eno d’un artista de manera simplificada

name: Addenda
permalink: addenda

image:
description = Foto de grup de Addenda de gira a Republica Txeca
file = foto.jpg

Structure realese.eno

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

Traduït a com es veu un realese.eno d’un album

permalink: hamato-yoshi-split

cover:
description = caratula del disc
file = cover.png

Remember:

  • Copy the files in the corresponding folder
  • Add image and description for each file .eno