Configurazione

Quasi tutto si imposta nell'interfaccia, in Impostazioni. Il file di configurazione e le variabili d'ambiente servono solo per l'installazione (porta, posizione del database) e per casi particolari. Questa pagina tratta entrambi.

Impostazioni

Le schede di Impostazioni, in ordine. Alcune compaiono solo ai livelli di interfaccia Avanzato o Esperto (menu dell'account › Interfaccia).

Per trovare rapidamente un'impostazione, usa Cerca un'impostazione… nel menu dell'account.

Aggiornamenti

Quando è disponibile una nuova versione, Tune la segnala nella barra laterale ("Aggiornamento disponibile"). Per verificare tu stesso, usa Cerca aggiornamenti in Impostazioni › Sistema › Informazioni › Aggiornamenti. Su Windows, macOS, con il pacchetto .deb e su Tune OS, l'aggiornamento si installa dall'interno di Tune; un'eventuale scansione in corso viene prima interrotta. Con Homebrew, Tune esegue brew upgrade o ti dice di farlo. Con Docker, scarica tu stesso la nuova immagine.

Nota per il .deb: un aggiornamento installato da Tune sostituisce i file in /opt/tune senza passare da apt. Reinstallare in seguito un .deb più vecchio riporta la versione di quel pacchetto.

Backup

Impostazioni › Sistema › Database › Backup / Ripristino crea una copia del database. Le copie sono salvate in una cartella backups accanto al database, e Tune conserva le cinque più recenti. Non è disponibile con PostgreSQL: usa invece pg_dump. Impostazioni › Dispositivi › Backup delle impostazioni salva in un file le impostazioni delle tue zone. Volume, coda e gruppi non sono inclusi. Ricarica il file con Apri un backup….

Il file di configurazione tune.toml

Tune non ha bisogno di alcun file per avviarsi. Se ne crei uno, Tune usa il primo tune.toml che trova, in quest'ordine:

1. Windows: %APPDATA%\Tune\tune.toml
2. la cartella da cui viene avviato Tune: ./tune.toml
3. /etc/tune/tune.toml
4. macOS: ~/.config/tune/tune.toml

port = 8888
db_path = "tune.db"
auto_scan = false
log_level = "info"
music_dirs = ["/srv/music"]
# local_audio_backend = "asio"     # Windows: auto, wasapi or asio
# dlna_play_delay_ms = 0

Attenzione: un file malformato viene ignorato senza alcun messaggio di errore, e Tune passa al successivo o ai valori predefiniti.

Variabili d'ambiente

Le variabili d'ambiente hanno la precedenza su tune.toml. Tune legge anche un file .env nella cartella da cui viene avviato (e su Windows, in %LOCALAPPDATA%\TuneServer\ o accanto a tune-server.exe). Con il pacchetto .deb, inseriscile in /etc/default/tune-server (una per riga, senza virgolette), poi esegui sudo systemctl restart tune-server.

Cartelle musicali. TUNE_MUSIC_DIRS (o music_dirs) viene copiata nelle impostazioni solo al primo avvio. Dopo, conta l'elenco in Impostazioni › Libreria › Posizioni, e modificare la variabile non ha alcun effetto. Una cartella mancante o vuota non viene copiata.

Variabili rimosse. Le vecchie variabili PORT, HOST, MUSIC_DIRS, DB_DRIVER, API_KEY, AUDIO_DEVICE, DSD_MODE, WRITE_TAGS, WATCH_FILESYSTEM e simili non vengono più lette. Anche diverse variabili di .env.tune.example non hanno alcun effetto: TUNE_TIDAL_ENABLED, TUNE_QOBUZ_ENABLED, TUNE_DEEZER_ENABLED, TUNE_SPOTIFY_ENABLED, TUNE_YOUTUBE_ENABLED, TUNE_DEFAULT_OUTPUT_FORMAT. I servizi si attivano nell'interfaccia.

Dove si trovano i dati

La cache delle copertine si trova accanto: %LOCALAPPDATA%\TuneServer\artwork_cache su Windows, ~/Library/Application Support/Tune/artwork_cache su macOS, /data/artwork_cache su Docker, /opt/tune/data/artwork_cache su Tune OS. Il file di log è limitato a 10 MiB, con una copia di backup (.1). Su Tune OS, un dispositivo installato prima della 1.0 conserva la sua cache originale, /opt/tune/artwork_cache.

Database: SQLite o PostgreSQL

Tune usa SQLite per impostazione predefinita, senza alcuna configurazione. PostgreSQL è supportato dalle build pubblicate per Windows, macOS e Linux (x86-64 e aarch64). Non è supportato dall'immagine Docker né dalla build Linux aarch64-musl. Due modi per attivarlo:

• nell'interfaccia: Impostazioni › Sistema › Database › Migra a PostgreSQL (livello Esperto);
• all'avvio: TUNE_DATABASE_URL=postgres://user:password@host:5432/tune, oppure TUNE_DB_ENGINE=postgres insieme a TUNE_DB_HOST, TUNE_DB_PORT, TUNE_DB_NAME, TUNE_DB_USER e TUNE_DB_PASS.

Porte di rete

Tune è in ascolto su tutte le interfacce di rete; l'indirizzo di ascolto non può essere modificato. Su Tune OS, la porta 80 viene inoltrata alla 8888.

Sicurezza

Per impostazione predefinita Tune non ha password né HTTPS: chiunque abbia accesso alla tua rete locale può aprire l'interfaccia. Non esporre la porta 8888 a Internet. L'autenticazione con account e token esiste nell'API (vedi la Guida tecnica) ma non può essere impostata dall'interfaccia.

Vedi anche

• Per iniziare: installazione per piattaforma
• Guida tecnica: dettagli su API e architettura
• Risoluzione dei problemi: problemi di configurazione comuni