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.
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.
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.
Main commands for the console
Preview your faircamp
faircamp --preview
Change colors
faircamp --preview --theming-widget
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
Image for 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:
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: