Per iniziare

Tune è un server musicale multi-room. Indicizza la tua musica (file locali, unità di rete) e i tuoi servizi di streaming, poi la invia ai tuoi dispositivi: un DAC collegato al computer, renderer DLNA/UPnP, diffusori AirPlay, Chromecast, lettori Squeezebox e altro ancora. Lo controlli da un browser web, su qualsiasi dispositivo della tua rete locale.

Scegli la tua installazione

Hai…	Installa
Una macchina dedicata (mini PC x86-64, Raspberry Pi 5)	Tune OS, un sistema completo pronto all'uso
Un PC Windows	Il programma di installazione per Windows (`…-windows-x86_64-setup.exe`)
Un Mac	L'immagine disco di macOS (`.dmg`) o Homebrew
Un computer Debian, Ubuntu o Raspberry Pi OS	Il pacchetto `.deb`
Un NAS o un server con Docker	L'immagine Docker `renesenses/tune`

Tutti i file si trovano nella pagina Download.

Windows

Esegui tune-server-v…-windows-x86_64-setup.exe. Si installa nel tuo profilo utente (%LOCALAPPDATA%\Programs\Tune Server) e non richiede diritti di amministratore.
Apri Tune Server dal desktop o dal menu Start. Si apre una finestra della console (è il server: tienila aperta), poi il browser mostra Tune all'indirizzo http://localhost:8888.
Se Windows Firewall lo chiede, consenti Tune sulle reti private. Senza questo passaggio, gli altri dispositivi e i renderer di rete non possono raggiungere Tune.

Tune non è installato come servizio di Windows e non si avvia con la sessione: riavvialo con il collegamento Tune Server. È disponibile anche un archivio .zip.

macOS

Apri l'immagine disco tune-server-v…-macos-….dmg e trascina Tune Server in Applicazioni (macOS 13 o successivo).
Avvia Tune Server. Non mostra alcuna icona nel Dock: avvia il server e apre http://localhost:8888 nel browser.

Con Homebrew:

brew tap renesenses/tap
brew install tune-server
brew services start tune-server

Linux (Debian, Ubuntu, Raspberry Pi OS)

Il pacchetto .deb (amd64 o arm64) richiede Debian 12, Ubuntu 22.04, Raspberry Pi OS bookworm o successivi.

sudo apt install ./tune-server_<version>_<arch>.deb

Il servizio tune-server si avvia subito, e di nuovo a ogni avvio della macchina. Poi apri http://<machine-address>:8888.

sudo systemctl status tune-server     # service status
sudo systemctl restart tune-server    # restart
journalctl -u tune-server -f          # follow the log

Il servizio viene eseguito come utente di sistema tune (membro del gruppo audio, così può accedere ai DAC USB). Quell'utente deve poter leggere le tue cartelle musicali. Per le altre distribuzioni sono disponibili anche archivi .tar.gz; non installano un servizio systemd.

Docker

services:
  tune:
    image: renesenses/tune:latest
    container_name: tune
    network_mode: host
    restart: unless-stopped
    volumes:
      - /path/to/music:/music:ro
      - tune-data:/data
    environment:
      - TUNE_MUSIC_DIRS=["/music"]
      - TUNE_AUTO_SCAN=true

volumes:
  tune-data:

Sostituisci /path/to/music con la cartella in cui si trova la tua musica sulla macchina: Tune la legge in sola lettura (:ro). Mantieni il volume con nome tune-data per /data: lì Tune scrive il suo database, come utente tune (uid 1000). Una cartella della macchina creata da Docker stesso, come ./data:/data, appartiene a root: Tune non può scriverci e il container si riavvia in loop. Su un NAS Synology o QNAP, segui la procedura della pagina Download.

network_mode: host è necessario affinché Tune rilevi i dispositivi sulla rete (DLNA, AirPlay, Chromecast). L'immagine Docker non può riprodurre su una scheda audio o su un DAC collegato alla macchina; serve solo i dispositivi di rete. Non si aggiorna da sola: scarica la nuova immagine (docker compose pull) e ricrea il container.

Tune OS

Tune OS è un sistema completo che trasforma una macchina in un server Tune dedicato. Sono disponibili tre immagini:

Programma di installazione x86-64 (ISO): copialo su una chiavetta USB (Rufus, balenaEtcher) e avvia la macchina da essa. Cancella il disco di destinazione e si installa solo su un disco vuoto. Serve un PC UEFI con Secure Boot disattivato, 4 GB di RAM e una connessione Ethernet cablata per il primo avvio.
Immagine flashabile x86-64 (.raw.xz): scrivila direttamente sul disco della macchina (balenaEtcher, oppure Rufus in modalità "DD Image").
Raspberry Pi 5 (.raw.xz): scrivila sulla scheda o sull'unità del Pi.

Il primo avvio non pone domande. Dura da 15 a 30 minuti e la macchina si riavvia due volte da sola: attendi che finisca, anche se risponde già via SSH. Poi apri http://tune-XXXX.local (XXXX sono gli ultimi quattro caratteri dell'indirizzo MAC) oppure http://<IP-address>. Anche lo schermo della macchina mostra l'indirizzo e l'IP.

Per la console e SSH, l'account è tune con password tune. Cambiala con il comando passwd. Le unità USB vengono montate automaticamente in /media. Tune OS si aggiorna dall'interno di Tune (vedi Configurazione).

Primo avvio

Finché la libreria è vuota, Tune apre la procedura guidata Benvenuto su Tune Server:

Inizia. Se arrivi da un'altra macchina, Arriva da un'altra macchina? ti permette di importare un backup.
Libreria musicale: inserisci il percorso di una cartella musicale come lo vede la macchina su cui gira Tune (ad es. /mnt/nas/Music o D:\Music), poi fai clic su Aggiungi.
Servizi di streaming: collega subito i tuoi account oppure più tardi (vedi Servizi di streaming).
Scansiona la libreria: Avvia la scansione. La scansione continua in background, quindi puoi fare clic su Termina la configurazione senza aspettare.

Puoi anche saltare la procedura guidata (Salta la configurazione) e impostare tutto più tardi in Impostazioni (icona a ingranaggio in cima alla barra laterale).

Riproduci il primo brano

Tune crea automaticamente una zona per ogni dispositivo che rileva. Una zona è una destinazione di ascolto, con la propria coda e il proprio volume.
Nella barra di riproduzione in basso, fai clic sul nome della zona (Cambia zona) e scegli dove ascoltare. Per ascoltare sul dispositivo che mostra Tune, scegli Questo browser.
Apri Libreria nella barra laterale, scegli un album e fai clic su Riproduci.

Orientarsi

Barra laterale: Home, Ricerca, In riproduzione, Coda, Cronologia, Libreria, Oxygen, Streaming, Radio in diretta, Podcast. Poi il gruppo Selezioni (Raccolte, Playlist, Ascolta più tardi, Etichette, Preferiti, Brani banditi) e, in fondo, Supporto.
Barra di riproduzione: controlli di trasporto, zona attiva, volume, Percorso del segnale e Modalità Audiofila (vedi Riproduzione e zone).
Livello dell'interfaccia: nel menu dell'account (avatar, in alto a destra), sezione Interfaccia, scegli Essenziale, Avanzato o Esperto. Questo mostra o nasconde solo menu e impostazioni; non dipende dal tuo piano. Tune parte al livello Esperto, che mostra tutto. Se un menu citato in questa guida manca, controlla questo livello.

Usare Tune da un altro dispositivo

Qualsiasi dispositivo sulla stessa rete locale può aprire http://<server-address>:8888 in un browser (su Tune OS puoi omettere la porta).

Vedi anche

Gestione della libreria: cartelle, condivisioni di rete, metadati
Riproduzione e zone: dispositivi di uscita, DSD, bit-perfect
Risoluzione dei problemi: problemi comuni