Konfiguration

Fast alles wird in der Oberfläche unter Einstellungen festgelegt. Die Konfigurationsdatei und die Umgebungsvariablen werden nur für die Installation (Port, Speicherort der Datenbank) und Sonderfälle benötigt. Diese Seite behandelt beides.

Einstellungen

Die Reiter unter Einstellungen in ihrer Reihenfolge. Einige erscheinen nur auf der Oberflächenebene Fortgeschritten oder Experte (Kontomenü › Oberfläche).

Um eine Einstellung schnell zu finden, verwenden Sie Einstellung suchen… im Kontomenü.

Updates

Wenn eine neue Version verfügbar ist, kündigt Tune sie in der Seitenleiste an („Update verfügbar“). Zum eigenen Prüfen verwenden Sie Nach Updates suchen unter Einstellungen › System › Über › Updates. Unter Windows, macOS, mit dem .deb-Paket und unter Tune OS wird das Update aus Tune heraus installiert; ein laufender Scan wird zuvor angehalten. Mit Homebrew führt Tune brew upgrade aus oder weist Sie darauf hin. Mit Docker laden Sie das neue Image selbst.

Hinweis zum .deb: Ein aus Tune heraus installiertes Update ersetzt die Dateien in /opt/tune, ohne über apt zu gehen. Wenn Sie anschließend ein älteres .deb erneut installieren, kommt die Version dieses Pakets zurück.

Sicherung

Einstellungen › System › Datenbank › Sicherung / Wiederherstellung erstellt eine Kopie der Datenbank. Die Kopien liegen in einem Ordner backups neben der Datenbank, und Tune behält die fünf neuesten. Mit PostgreSQL ist dies nicht verfügbar: Verwenden Sie stattdessen pg_dump. Einstellungen › Geräte › Sicherung der Einstellungen speichert Ihre Zoneneinstellungen in einer Datei. Lautstärke, Warteschlange und Gruppen sind nicht enthalten. Laden Sie die Datei mit Sicherung öffnen… wieder.

Die Konfigurationsdatei tune.toml

Tune braucht zum Starten keine Datei. Wenn Sie eine anlegen, verwendet Tune die erste gefundene tune.toml in dieser Reihenfolge:

1. Windows: %APPDATA%\Tune\tune.toml
2. der Ordner, aus dem Tune gestartet wird: ./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

Achtung: Eine fehlerhaft aufgebaute Datei wird ohne jede Fehlermeldung übersprungen, und Tune geht zur nächsten oder zu den Standardwerten über.

Umgebungsvariablen

Umgebungsvariablen haben Vorrang vor tune.toml. Tune liest außerdem eine Datei .env im Ordner, aus dem es gestartet wird (und unter Windows in %LOCALAPPDATA%\TuneServer\ oder neben tune-server.exe). Beim .deb-Paket tragen Sie sie in /etc/default/tune-server ein (eine pro Zeile, ohne Anführungszeichen) und führen dann sudo systemctl restart tune-server aus.

Musikordner. TUNE_MUSIC_DIRS (oder music_dirs) wird nur beim ersten Start in die Einstellungen kopiert. Danach zählt die Liste unter Einstellungen › Bibliothek › Speicherorte, und eine Änderung der Variablen hat keine Wirkung. Ein fehlender oder leerer Ordner wird nicht kopiert.

Entfernte Variablen. Die alten Variablen PORT, HOST, MUSIC_DIRS, DB_DRIVER, API_KEY, AUDIO_DEVICE, DSD_MODE, WRITE_TAGS, WATCH_FILESYSTEM und ähnliche werden nicht mehr gelesen. Mehrere Variablen in .env.tune.example haben ebenfalls keine Wirkung: TUNE_TIDAL_ENABLED, TUNE_QOBUZ_ENABLED, TUNE_DEEZER_ENABLED, TUNE_SPOTIFY_ENABLED, TUNE_YOUTUBE_ENABLED, TUNE_DEFAULT_OUTPUT_FORMAT. Dienste werden in der Oberfläche aktiviert.

Wo die Daten liegen

Der Cover-Cache liegt daneben: %LOCALAPPDATA%\TuneServer\artwork_cache unter Windows, ~/Library/Application Support/Tune/artwork_cache unter macOS, /data/artwork_cache bei Docker, /opt/tune/data/artwork_cache unter Tune OS. Die Protokolldatei ist auf 10 MiB begrenzt, mit einer Sicherungskopie (.1). Unter Tune OS behält ein vor 1.0 installiertes Gerät seinen ursprünglichen Cache, /opt/tune/artwork_cache.

Datenbank: SQLite oder PostgreSQL

Tune verwendet standardmäßig SQLite, ohne jede Einrichtung. PostgreSQL wird von den veröffentlichten Builds für Windows, macOS und Linux (x86-64 und aarch64) unterstützt. Es wird nicht vom Docker-Image und nicht vom Linux-Build aarch64-musl unterstützt. Zwei Möglichkeiten, es zu aktivieren:

• in der Oberfläche: Einstellungen › System › Datenbank › Zu PostgreSQL migrieren (Ebene Experte);
• beim Start: TUNE_DATABASE_URL=postgres://user:password@host:5432/tune oder TUNE_DB_ENGINE=postgres zusammen mit TUNE_DB_HOST, TUNE_DB_PORT, TUNE_DB_NAME, TUNE_DB_USER und TUNE_DB_PASS.

Netzwerkports

Tune lauscht auf allen Netzwerkschnittstellen; die Abhöradresse lässt sich nicht ändern. Unter Tune OS wird Port 80 auf 8888 weitergeleitet.

Sicherheit

Standardmäßig hat Tune kein Passwort und kein HTTPS: Jeder mit Zugriff auf Ihr lokales Netzwerk kann die Oberfläche öffnen. Machen Sie Port 8888 nicht im Internet zugänglich. Authentifizierung über Konten und Token gibt es in der API (siehe Technischer Leitfaden), sie lässt sich aber nicht in der Oberfläche einrichten.

Siehe auch

• Erste Schritte: Installation je Plattform
• Technischer Leitfaden: Details zu API und Architektur
• Fehlerbehebung: häufige Konfigurationsprobleme