Skip to content

TuneCampPiattaforma Musicale Federata

Streaming self-hosted per artisti indipendenti, etichette e comunità — con supporto a federazione, Web3 e Subsonic.

Documentazione ​

🚀 Per Iniziare ​

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.

DocumentoDescrizione
IniziaInstallazione → primo accesso → aggiunta musica → ascolto (inizia da qui)
Aggiungere MusicaStruttura della libreria su disco, scansione e passaggio da bozza a release pubblica
Deploy su RailwayDeploy con un solo click su Railway — nessuna VPS richiesta, HTTPS incluso
Configurazione API e ServiziConfigurazione passo-passo per Stripe, Google Drive, IA e altre integrazioni
Configurazione NginxConfigurazione del reverse proxy per SSL, WebSocket e HLS
Backup e MigrazioneBackup del database, ripristino e spostamento dell'istanza

Guida Utente ​

Per ascoltatori e artisti che utilizzano un'istanza TuneCamp.

DocumentoDescrizione
Ruoli e PermessiCosa può fare ciascun ruolo (Proprietario, Manager, Curatore, Ascoltatore)
RadioTrasmissione di una stazione sempre attiva dalla tua libreria (playlist + mix di genere)
Protocollo SubsonicCollegamento di client esterni (DSub, Symfonium, Tempo, Substreamer)
Funzionalità Social e CommunityPost, commenti e interazioni con i fan
CollabCostruzione collaborativa di brani multi-artista: stem, snapshot di versione, nessun realtime
Diventare un Artista e VendereFlusso di richiesta artista e gate di vendita can_sell
Pagamenti e MonetizzazioneCheckout Stripe, on-ramp crypto e acquisti on-chain

Guida Amministratore ​

Per chi gestisce un'istanza TuneCamp.

DocumentoDescrizione
FederazioneScoperta ActivityPub e HTTP gossip — come le istanze si trovano a vicenda
Sidecamp DesktopApp Desktop per la Condivisione Peer, Soulseek e Torrents
MonitoraggioEndpoint /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 MCPEsposizione del catalogo TuneCamp ai client IA tramite MCP

Guida Sviluppatore ​

Per contributori e sviluppatori su TuneCamp.

DocumentoDescrizione
Guida allo SviluppoConfigurazione dell'ambiente di sviluppo locale, esecuzione e test
ContribuireLinee guida per la contribuzione del codice e processo di pull request
Architettura BackendServer Express, SQLite, ActivityPub, scoperta federata e modello dati completo / schema del database
Architettura WebappReact, Vite, Zustand e scoperta dell'istanza nel frontend
Contratti APIEndpoint REST, autenticazione e protocolli supportati
Identità FIDIdentità auto-sovrana e passaporti d'istanza tramite FID + Zen SEA

Integrazioni ​

Servizi di terze parti opzionali che puoi collegare alla tua istanza.

DocumentoDescrizione
Integrazioni IAAutomazione dei metadati e raccomandazioni tramite OpenRouter
Smart ContractsContratti Solidity (Factory, NFT, Checkout) su Base
Google DriveBackend di archiviazione cloud per file multimediali
SidecampAcquisizione P2P (Soulseek, BitTorrent, yt-dlp) tramite l'app desktop companion
Bot TelegramAcquisizione rapida di file e gestione remota

Riferimento ​

DocumentoDescrizione
Panoramica del ProgettoObiettivi, stack tecnologico, struttura del repository, albero sorgenti e catalogo componenti webapp
Stato e MaturitàStato di maturità reale di ciascuna area e limitazioni note
Confronto con FunkwhaleDifferenze nei modelli e nelle funzionalità
Impronte Digitali AudioCome TuneCamp rileva i duplicati dei brani nella libreria
Revisione Sicurezza PagamentiRisultati della revisione interna della sicurezza del flusso di pagamento

Ultimo aggiornamento: 22 Agosto 2026

Rilasciato sotto licenza MIT.