Streaming self-hosted per artisti indipendenti, etichette e comunità — con supporto a federazione, Web3 e Subsonic.
Nuovo qui? Comincia con la guida Inizia. Ti guiderà da una macchina vuota a un'istanza TuneCamp attiva con musica al suo interno — installazione, primo accesso, aggiunta della libreria e ascolto — in circa 10 minuti.
Una volta avviato, le guide qui sotto ti permetteranno di approfondire.
| Documento | Descrizione |
|---|---|
| Inizia | Installazione → primo accesso → aggiunta musica → ascolto (inizia da qui) |
| Configurazione API e Servizi | Configurazione passo-passo per Stripe, Google Drive, IA e altre integrazioni |
| Configurazione Nginx | Configurazione del reverse proxy per SSL, WebSocket e HLS |
| Backup e Migrazione | Backup del database, ripristino e spostamento dell'istanza |
Per ascoltatori e artisti che utilizzano un'istanza TuneCamp.
| Documento | Descrizione |
|---|---|
| Ruoli e Permessi | Cosa può fare ciascun ruolo (Proprietario, Manager, Curatore, Ascoltatore) |
| Radio | Trasmissione di una stazione sempre attiva dalla tua libreria (playlist + mix di genere) |
| Protocollo Subsonic | Collegamento di client esterni (DSub, Symfonium, Tempo, Substreamer) |
| Funzionalità Social e Community | Post, commenti e interazioni con i fan |
| Diventare un Artista e Vendere | Flusso di richiesta artista e gate di vendita can_sell |
| Pagamenti e Monetizzazione | Checkout Stripe, on-ramp crypto e acquisti on-chain |
Per chi gestisce un'istanza TuneCamp.
| Documento | Descrizione |
|---|---|
| Federazione | Scoperta ActivityPub e HTTP gossip — come le istanze si trovano a vicenda |
| Plugin | Caricamento di provider di streaming, metadati e archiviazione personalizzati |
| Peer Sharing | Daemon WebSocket con tunnel inverso integrato per la condivisione temporanea di cartelle musicali locali |
| Monitoraggio | Endpoint /health, pannello delle risorse di sistema dell'amministratore, report sui crash Sentry e controlli di uptime |
| Scalabilità | Limiti del singolo processo e di SQLite e relative mitigazioni |
| Configurazione MCP | Esposizione del catalogo TuneCamp ai client IA tramite MCP |
Per contributori e sviluppatori su TuneCamp.
| Documento | Descrizione |
|---|---|
| Guida allo Sviluppo | Configurazione dell'ambiente di sviluppo locale, esecuzione e test |
| Contribuire | Linee guida per la contribuzione del codice e processo di pull request |
| Architettura Backend | Server Express, SQLite, ActivityPub e scoperta federata |
| Architettura Webapp | React, Vite, Zustand e scoperta dell'istanza nel frontend |
| Inventario dei Componenti UI | Catalogo dei componenti React della webapp per directory |
| Modelli Dati | Schema del database e relazioni tra entità |
| Contratti API | Endpoint REST, autenticazione e protocolli supportati |
| Albero dei Sorgenti | Struttura delle directory e punti di ingresso |
| Applicazioni Lab | Creazione e invio di strumenti audio sperimentali |
| App Lab: Audiofabric | Visualizzatore musicale 3D WebGL in tempo reale integrato in Lab |
| App Lab: Registratore a 4 Tracce | Pacchetto companion registratore a cassette a 4 tracce basato su browser |
Servizi di terze parti opzionali che puoi collegare alla tua istanza.
| Documento | Descrizione |
|---|---|
| Integrazioni IA | Automazione dei metadati e raccomandazioni tramite OpenRouter |
| Smart Contracts | Contratti Solidity (Factory, NFT, Checkout) su Base |
| Google Drive | Backend di archiviazione cloud per file multimediali |
| Soulseek | Ricerca P2P e importazione in un clic |
| Torrent | Integrazione WebTorrent per l'acquisizione del catalogo |
| Bot Telegram | Acquisizione rapida di file e gestione remota |
| Documento | Descrizione |
|---|---|
| Panoramica del Progetto | Obiettivi, stack tecnologico e struttura del repository |
| Stato e Maturità | Stato di maturità reale di ciascuna area e limitazioni note |
| Confronto con Funkwhale | Differenze nei modelli e nelle funzionalità |
| Impronte Digitali Audio | Come TuneCamp rileva i duplicati dei brani nella libreria |
| Revisione Sicurezza Pagamenti | Risultati della revisione interna della sicurezza del flusso di pagamento |
Ultimo aggiornamento: 25 Giugno 2026