Configuration

Presque tout se règle dans l'interface, sous Réglages. Le fichier de configuration et les variables d'environnement ne servent qu'à l'installation (port, emplacement de la base) et aux cas particuliers. Cette page couvre les deux.

Les Réglages

Les onglets de Réglages, dans l'ordre. Certains ne s'affichent qu'au niveau d'interface Avancé ou Expert (menu du compte › Interface).

Pour retrouver un réglage, utilisez Rechercher un réglage… dans le menu du compte.

Mises à jour

Quand une nouvelle version est disponible, Tune l'annonce dans la barre latérale (« Mise à jour disponible »). Pour vérifier vous-même, utilisez Vérifier les mises à jour dans Réglages › Système › À propos › Mises à jour. L'installation se fait depuis Tune pour Windows, macOS, le paquet .deb et Tune OS : si un scan est en cours, il est arrêté avant l'installation. Avec Homebrew, Tune lance brew upgrade ou vous indique de le faire. Avec Docker, récupérez la nouvelle image vous-même.

Remarque pour le .deb : une mise à jour faite depuis Tune remplace les fichiers de /opt/tune sans passer par apt. Réinstaller ensuite un ancien .deb ramène la version de ce paquet.

Sauvegarde

Réglages › Système › Base de données › Sauvegarde / Restauration crée une copie de la base. Les copies sont rangées dans un dossier backups à côté de la base, et Tune garde les cinq plus récentes. Ce mécanisme n'existe pas avec PostgreSQL : utilisez alors pg_dump. Réglages › Appareils › Sauvegarde des réglages enregistre dans un fichier les réglages de vos zones. Le volume, la file d'attente et les groupes n'y figurent pas. Ce fichier se relit avec Ouvrir une sauvegarde….

Fichier de configuration tune.toml

Tune n'a besoin d'aucun fichier pour démarrer. Si vous en créez un, Tune prend le premier tune.toml qu'il trouve, dans cet ordre :

1. Windows : %APPDATA%\Tune\tune.toml
2. le dossier depuis lequel Tune est lancé : ./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/musique"]
# local_audio_backend = "asio"     # Windows : auto, wasapi ou asio
# dlna_play_delay_ms = 0

Attention : un fichier mal écrit est ignoré sans message d'erreur, et Tune passe au suivant ou reprend les valeurs par défaut.

Variables d'environnement

Les variables d'environnement l'emportent sur tune.toml. Tune lit aussi un fichier .env placé dans le dossier de lancement (et, sous Windows, dans %LOCALAPPDATA%\TuneServer\ ou à côté de tune-server.exe). Avec le paquet .deb, elles se mettent dans /etc/default/tune-server (une variable par ligne, sans guillemets), puis on lance sudo systemctl restart tune-server.

Dossiers de musique. TUNE_MUSIC_DIRS (ou music_dirs) n'est recopié dans les réglages qu'au premier démarrage. Ensuite, c'est la liste de Réglages › Bibliothèque › Emplacements qui compte : modifier la variable n'a plus d'effet. Un dossier absent ou vide n'est pas recopié.

Variables supprimées. Les anciennes variables PORT, HOST, MUSIC_DIRS, DB_DRIVER, API_KEY, AUDIO_DEVICE, DSD_MODE, WRITE_TAGS, WATCH_FILESYSTEM et leurs pareilles ne sont plus lues. Plusieurs variables du fichier .env.tune.example sont elles aussi sans effet : TUNE_TIDAL_ENABLED, TUNE_QOBUZ_ENABLED, TUNE_DEEZER_ENABLED, TUNE_SPOTIFY_ENABLED, TUNE_YOUTUBE_ENABLED, TUNE_DEFAULT_OUTPUT_FORMAT. Les services s'activent dans l'interface.

Emplacement des données

Le cache des pochettes se trouve à côté : %LOCALAPPDATA%\TuneServer\artwork_cache sous Windows, ~/Library/Application Support/Tune/artwork_cache sous macOS, /data/artwork_cache sous Docker, /opt/tune/data/artwork_cache sous Tune OS. Le fichier journal est plafonné à 10 Mio, avec une copie de sauvegarde (.1). Sous Tune OS, un appareil installé avant la 1.0 garde son cache d'origine, /opt/tune/artwork_cache.

Base de données : SQLite ou PostgreSQL

Tune utilise SQLite par défaut, sans aucun réglage. PostgreSQL est pris en charge par les versions Windows, macOS et Linux (x86-64 et aarch64) publiées. Il ne l'est pas par l'image Docker ni par la version Linux aarch64-musl. Deux façons de l'activer :

• dans l'interface : Réglages › Système › Base de données › Migrer vers PostgreSQL (niveau Expert) ;
• au démarrage : TUNE_DATABASE_URL=postgres://utilisateur:motdepasse@hôte:5432/tune, ou bien TUNE_DB_ENGINE=postgres avec TUNE_DB_HOST, TUNE_DB_PORT, TUNE_DB_NAME, TUNE_DB_USER et TUNE_DB_PASS.

Ports réseau

Tune écoute sur toutes les interfaces réseau ; l'adresse d'écoute ne se règle pas. Sous Tune OS, le port 80 renvoie vers 8888.

Sécurité

Par défaut, Tune n'a ni mot de passe ni HTTPS : toute personne qui a accès à votre réseau local peut ouvrir l'interface. N'exposez pas le port 8888 sur Internet. L'authentification par comptes et jetons existe dans l'API (voir le Guide technique) mais ne se règle pas depuis l'interface.

Voir aussi

• Prise en main : installation par plateforme
• Guide technique : API, compilation, détails d'architecture
• Dépannage : problèmes de configuration courants