Per Iniziare

Questa pagina ti guiderà da una configurazione vuota a un'istanza TuneCamp attiva contenente la tua musica. L'intera procedura richiede circa 10 minuti. Per argomenti più approfonditi, consulta i collegamenti alla fine.

Nuovo su TuneCamp? È una piattaforma musicale self-hosted: il tuo server di streaming personale dotato di un lettore web, supporto per app mobili (Subsonic), federazione nel Fediverso (ActivityPub) e monetizzazione Web3 opzionale. Lo gestisci tu; i dati sono di tua proprietà.

1. Prerequisiti

Il percorso più rapido prevede l'uso di Docker. Avrai bisogno di:

• Docker 20+ e Docker Compose
• Una cartella di file audio (MP3, FLAC, WAV, …)

Preferisci eseguire il codice sorgente per scopi di sviluppo? Consulta la Guida allo Sviluppo.

2. Installazione ed esecuzione

# 1. Clona il repository
git clone https://github.com/scobru/tunecamp.git
cd tunecamp

# 2. Collega TuneCamp alla tua cartella musicale
#    Modifica docker-compose.yml e sostituisci /path/to/your/music
#    con il percorso effettivo dei tuoi file audio.

# 3. Avvia e compila in background
docker-compose up -d --build

Quando il container è avviato correttamente, apri http://localhost:1970 nel browser.

3. Primo accesso e messa in sicurezza dell'istanza

Al primo avvio, TuneCamp crea un account amministratore predefinito:

Nome Utente	Password
admin	admin

(Puoi sovrascrivere queste credenziali prima del primo avvio impostando le variabili d'ambiente TUNECAMP_ADMIN_USER e TUNECAMP_ADMIN_PASS.)

Modifica la password dell'amministratore immediatamente dopo il primo accesso, andando su Admin → Settings. All'avvio, il server registra un avviso di sicurezza se l'account admin, le impostazioni CORS o il segreto JWT generato automaticamente sono rimasti a quelli predefiniti — consulta il riferimento per la configurazione per proteggere la tua istanza.

Una procedura guidata integrata forza la modifica della password per qualsiasi account che utilizzi ancora credenziali predefinite. I dettagli sono disponibili in Ruoli e Permessi.

4. Aggiungi la tua musica

1. Vai su Admin → Library e avvia una Scansione (Scan).
2. TuneCamp leggerà i tag dei metadati, genererà le forme d'onda e caricherà le copertine.
3. Gli album scansionati finiranno nello stato di Bozza (Draft) — sono visibili nella tua libreria ma non pubblicamente, fino a quando non li promuoverai a Formal Release dal pannello di amministrazione.

Puoi anche importare file musicali tramite il bot Telegram, Soulseek, torrent o Google Drive.

5. Ascolta

• Lettore web — già attivo all'indirizzo http://localhost:1970, con visualizzazione della forma d'onda, coda di riproduzione, testi dei brani e scorciatoie da tastiera.
• App per cellulari / computer — TuneCamp implementa l'intera API Subsonic. Puoi connettere qualsiasi client Subsonic (DSub, Symfonium, Tempo, Substreamer) inserendo l'URL del tuo server e le tue credenziali TuneCamp. Consulta la guida al Protocollo Subsonic.

6. Passi successivi

Ora disponi di un'istanza funzionante. Scegli il percorso che più si adatta alle tue esigenze:

Se vuoi…	Leggi
Configurare un dominio reale con SSL	Configurazione Nginx
Collegare pagamenti Stripe o crypto	Configurazione API e Servizi → Pagamenti
Unirti alla rete federata	Federazione
Capire cosa può fare ciascun utente	Ruoli e Permessi
Proteggere i tuoi dati	Backup e Migrazione
Gestire l'istanza in produzione su larga scala	Monitoraggio · Scalabilità
Contribuire al codice	Guida allo Sviluppo · Contribuire

Consulta l'indice completo della documentazione per tutto il resto.