Documentació

Quina música puc pujar a Fairplayer?

És imprescindible que la música que es pengi a Fairplayer tingui el permís de l’artista i de la gent que tingui els drets legals sobre cada llançament.

Com puc pujar la meva música a Fairplayer?

Fairplayer està dissenyat amb una estructura descentralitzada, on la música l’allotgen les mateixes artistes i el reproductor les indexa (és a dir, les agrupa) i en permet la reproducció. Ara mateix, només hi ha un sol programa per a la teva web que sigui compatible amb Fairplayer: el Faircamp. En un futur hi haurà més possibilitats.

Faircamp és un tipus de pàgina web estàtica (anomenem faircamp tant al programari que les crea com a cada una d’aquestes pàgines web, intentarem que no sigui confós!). Té la seva corba d’aprenentatge, però no pateixis! Volem fer un acompanyament que redueixi aquesta corba, ajudant-te a través de tots els passos necessaris per fer-ho. Normalment, necessites tenir contractat un servidor i un domini, però també t’ho posem fàcil en aquest sentit.

Així doncs, per poder penjar la teva música, has d’instal·lar-te un Faircamp, pujar-hi el teu catàleg i connectar-lo a un reproductor com fairplayer.band. Si ja tens un Faircamp, només et caldrà afegir-lo i verificar-lo a fairplayer.band/hub.

Què és Faircamp?

Faircamp és un programa lliure que no desenvolupem nosaltres però que forma part del nostre ecosistema. Està desenvolupat per Simon Repp i és un generador de webs estàtics ideal per compartir un catàleg d’àudio a internet. El públic pot reproduir la teva música i navegar per les teves publicacions. Hi ha Faircamps que són d’un sol artista, i d’altres que són d’una comunitat o discogràfica. Cadascun està allotjat en un domini web i un servidor diferents, però pel seu compte, no es pot reproduir música d’un en un altre.

Quins són els passos per a crear un faircamp i fer-lo disponible a Internet?

Estructurem la creació d’un faircamp en 5 passos:

  1. Crear el catàleg: recopilar les cançons i ordenar els directoris en àlbums o artistes.
  2. Instal·lar el programari de faircamp.
  3. Configurar el catàleg: aprendre i aplicar com funcionen els fitxers de configuració que permeten la personalització de la pàgina web.
  4. Construir la pàgina web amb el programa faircamp.
  5. Aprendre a connectar-se a un servidor extern (via FileZilla, per exemple) i pujar-hi la web construïda.

La nostra idea és ajudar-te a entendre i executar tots aquests passos.

Com pots observar, la primera part (passos 1, 2, 3 i 4) es realitzen al teu ordinador personal. Sempre que vulguis actualitzar la teva web hauràs de recrear-la de forma local (és a dir, al teu ordinador personal).

El 5è pas connecta el teu ordinador amb el servidor, des d’on el teu faircamp serà accessible des d’Internet. Si no tens un servidor ni cap domini, nosaltres te’n proporcionarem un i no t’has de preocupar massa per la seva configuració (serà un aprenentatge pel futur!).

Un cop tinc un faircamp públic, ja està disponible la meva música al fairplayer?

No, de moment tens la teva música disponible a Internet a una pàgina web de forma aïllada. Per a poder-la connectar al fairplayer cal que t’hi registris i segueixis els passos per afegir el teu faircamp. Això és així perquè donem molta importància al consentiment mutu. Però no et preocupis, també et guiarem en aquest procés!

Com faig el catàleg amb Faircamp?

El Faircamp crea la pàgina estàtica seguint una estructura de carpetes específica i uns arxius de text amb extensió .eno que serveixen per personalitzar la pàgina. Depenent si crearàs un faircamp per un segell discogràfic o per un artista, la documentació oficial ens mostra diferents exemples.

Si ets un segell, et recomanem que segueixis aquesta estructura i arxius. Traduït al segell de Discos Pinya, quedaria així:

Però si vols fer el Faircamp d’un artista, la documentació oficial et dona l’opció de crear un Faircamp amb descàrregues gratuïtes, amb una pasarel·la de pagament o amb codis de descàrrega.

Traduït al faircamp de Vidal Soler, que només hi té un disc, es veu més senzill. Les carpetes quedarien així:

Exemple de la carpeta d’una artista:

Exemple de la carpeta d’un release:

Catalog.eno

Aquest és un arxiu únic que es troba a la carpeta base del que serà el nostre faircamp. En aquest document s’hi troba el nom del nostre Faircamp, el tipus de faircamp, la descripció, la imatge de la capçalera… I també serà on en uns passos més endavant enganxarem el codi que el Hub de Fairplayer ens proporcionarà per poder verificar-lo.

A la documentació oficial podeu veure totes les opcions que es poden customitzar en el catalog.eno.

Exemple del catalog.eno d’un segell:

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

label_mode

tags: copy

release_download_access: https://discospinya.bandcamp.com

-- unlock_info
"Per descarregar la música o comprar-la, pots anar al nostre Bandcamp per donar suport a les bandes!"    
-- unlock_info

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

favicon: my_favicon.png

link:
label = Xarxes
url = https://www.instagram.com/discospinya/

link:
label = Links
url = https://linktr.ee/discospinya?utm_source=ig&utm_medium=social&utm_content=link_in_bio

release_downloads:
- mp3

-- synopsis
DIY // Punk // Amiguisme

-- synopsis

-- more
Discos Pinya som un sello discogràfic autogestionat afincades a Barcelona. 
Pots trobar merch de les bandes al nostre [bandcamp](https://discospinya.bandcamp.com)

Aquest Faircamp està indexat a Fairplayer, com d'altres Faircamps que s'estan vinculant!

🛍️​ [Bandcamp](https://discospinya.bandcamp.com)
📷​ [@discospinya](https://www.instagram.com/discospinya/)
🗣️​ [Canal de difusió](https://t.me/discospinya)
🎧​ [Fairplayer](https://fairplayer.band)

-- more

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

-- site_metadata
<meta name="fairplayer-code" content="Codi que us proporcionarem ;)">
-- site_metadata

artist.eno

Cada carpeta d’artista ha de contenir un arxiu d’aquest tipus. És molt important especificar el permalink d’aquesta artista (serà l’URL i ha de ser única en el vostre faircamp, sense espais ni caràcters especials). En aquesta carpeta també hi ha d’haver la foto de l’artista i que a l’arxiu artist.eno afegiu una petita frase de descripció d’aquesta imatge. Aquest últim punt és important, ja que si no completeu aquest camp apareixerà un símbol a la portada del Faircamp un cop el pengeu i un cop indexat al Fairplayer podria donar-vos algun error en la detecció de la imatge.

A la documentació oficial podeu consultar més variacions de l’artist.eno.

Aquí us deixem una plantilla per la imatge de l’artista que utilitza Faircamp. La part central més fosca és el que el Fairplayer mostrarà com a foto principal de l’artista.

Exemple de com és un arxiu artist.eno:

name: Addenda
permalink: addenda

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

release.eno

Cada àlbum que pugeu ha de contenir aquest arxiu. El seu funcionament és molt semblant a l’arxiu artist.eno. A la carpeta de l’àlbum també heu d’afegir la imatge de l’àlbum i recordeu que, com en el cas anterior que us explicàvem, és molt important afegir la descripció per complir amb els criteris d’accessibilitat i evitar errors al Fairplayer.

Un error molt habitual sorgeix quan el nom del release és igual al nom de l’artista. Procureu recordar especificar un permalink diferent per cada release i artista.

Si afegeixes la data del release, a la pàgina inicial del teu faircamp apareixeran automàticament ordenats de més nou a més antic.

Podeu consultar més informació sobre el release.eno a la documentació oficial.

Exemple de com es veu un arxiu release.eno:

permalink: allau-allau
date: 2023-04-05

release_artist: Allau

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

I ara… Ja puc instal·lar el Faircamp?

El programa Faircamp permet crear una previsualització local del faircamp que esteu creant, per tant, si us resulta més fàcil, podeu instal·lar el programa al principi d’aquest tutorial i anar experimentant i provant de personalitzar els arxius durant la creació del catàleg.

Aquí podeu trobar els diferents instal·ladors depenent el vostre sistema operatiu.

Des del terminal us col·locareu a la ruta de la carpeta del vostre catàleg. Amb el següent comandament podreu visualitzar localment el vostre faircamp:

faircamp --preview

He fet el “preview” del meu Faircamp i em surten noms incorrectes a les cançons, com ho puc arreglar?

Això és perquè el Faircamp extreu els noms dels releases, àlbums i artistes de les metadades incrustades als arxius d’àudio. Si vols canviar-ho, et recomanem que editis amb un gestor o editor de metadades (nosaltres et recomanem MusicBrainz Picard). Si està tot correctament etiquetat, aquest pas te’l podràs saltar!

Com verifico la meva música a Fairplayer?

Perquè la teva música aparegui al reproductor, cal que verifiquis que el web (Faircamp) que has connectat és teu. Així, ens assegurem que comptem amb el teu permís per poder agafar i reproduir la teva música. Per fer-ho, caldrà que segueixis les instruccions a fairplayer.band/hub. Caldrà que afegeixis un codi que et proporcionarem a l’arxiu catalog.eno del teu faircamp.