Konfiguráció

Szinte minden a felületen állítható be, a Beállítások alatt. A konfigurációs fájlra és a környezeti változókra csak a telepítésnél (port, adatbázis helye) és különleges esetekben van szükség. Ez az oldal mindkettőt tárgyalja.

Beállítások

A Beállítások fülei sorrendben. Néhány csak Haladó vagy Szakértő felületi szinten látszik (fiókmenü › Felület).

Egy beállítás gyors megtalálásához használd a fiókmenü Beállítás keresése… mezőjét.

Frissítések

Ha új verzió érhető el, a Tune jelzi az oldalsávon ("Elérhető frissítés"). Ha magad szeretnéd ellenőrizni, használd a Frissítések keresése gombot a Beállítások › Rendszer › Névjegy › Frissítések alatt. Windowson, macOS-en, a .deb csomagnál és a Tune OS-en a frissítés a Tune-ból telepíthető; a futó beolvasás előtte leáll. Homebrew esetén a Tune lefuttatja a brew upgrade parancsot, vagy szól, hogy futtasd le. Dockerrel te magad húzd le az új lemezképet.

A .deb csomaghoz: a Tune-ból telepített frissítés az apt megkerülésével cseréli a /opt/tune mappa fájljait. Ha utána egy régebbi .deb-et telepítesz újra, az visszahozza annak a csomagnak a verzióját.

Mentés

A Beállítások › Rendszer › Adatbázis › Mentés / Visszaállítás másolatot készít az adatbázisról. A másolatok az adatbázis melletti backups mappában tárolódnak, és a Tune az öt legutóbbit őrzi meg. PostgreSQL esetén ez nem érhető el: használd helyette a pg_dump parancsot. A Beállítások › Eszközök › Beállítások mentése a zónabeállításaidat fájlba menti. A hangerő, a várólista és a csoportok nem szerepelnek benne. A fájlt a Mentés megnyitása… gombbal töltheted vissza.

A tune.toml konfigurációs fájl

A Tune-nak nincs szüksége fájlra az induláshoz. Ha létrehozol egyet, a Tune az első megtalált tune.toml fájlt használja, ebben a sorrendben:

1. Windows: %APPDATA%\Tune\tune.toml
2. a mappa, ahonnan a Tune el van indítva: ./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

Vigyázat: a hibás formátumú fájlt a Tune minden hibaüzenet nélkül kihagyja, és a következőre vagy az alapértékekre lép.

Környezeti változók

A környezeti változók elsőbbséget élveznek a tune.toml fájllal szemben. A Tune beolvassa a .env fájlt is abban a mappában, ahonnan elindítják (Windowson a %LOCALAPPDATA%\TuneServer\ mappában vagy a tune-server.exe mellett). A .deb csomagnál a /etc/default/tune-server fájlba írd őket (soronként egyet, idézőjelek nélkül), majd futtasd a sudo systemctl restart tune-server parancsot.

Zenemappák. A TUNE_MUSIC_DIRS (vagy a music_dirs) csak az első indításkor másolódik a beállításokba. Ezután a Beállítások › Könyvtár › Helyek alatti lista számít, és a változó módosításának nincs hatása. A hiányzó vagy üres mappa nem másolódik át.

Megszűnt változók. A régi PORT, HOST, MUSIC_DIRS, DB_DRIVER, API_KEY, AUDIO_DEVICE, DSD_MODE, WRITE_TAGS, WATCH_FILESYSTEM és hasonló változókat már nem olvassa be a rendszer. A .env.tune.example fájl több változójának sincs hatása: TUNE_TIDAL_ENABLED, TUNE_QOBUZ_ENABLED, TUNE_DEEZER_ENABLED, TUNE_SPOTIFY_ENABLED, TUNE_YOUTUBE_ENABLED, TUNE_DEFAULT_OUTPUT_FORMAT. A szolgáltatásokat a felületen kell bekapcsolni.

Hol vannak az adatok

A borítók gyorsítótára mellette található: Windowson %LOCALAPPDATA%\TuneServer\artwork_cache, macOS-en ~/Library/Application Support/Tune/artwork_cache, Dockeren /data/artwork_cache, Tune OS-en /opt/tune/data/artwork_cache. A naplófájl mérete legfeljebb 10 MiB, egy tartalékmásolattal (.1). Tune OS alatt az 1.0 előtt telepített eszköz megtartja eredeti gyorsítótárát (/opt/tune/artwork_cache).

Adatbázis: SQLite vagy PostgreSQL

A Tune alapértelmezetten SQLite-ot használ, beállítás nélkül. A PostgreSQL-t a közzétett Windows-, macOS- és Linux-buildek (x86-64 és aarch64) támogatják. Nem támogatja sem a Docker-lemezkép, sem a Linux aarch64-musl build. Két módon kapcsolható be:

• a felületen: Beállítások › Rendszer › Adatbázis › Áttérés PostgreSQL-re (Szakértő szint);
• induláskor: TUNE_DATABASE_URL=postgres://user:password@host:5432/tune, vagy TUNE_DB_ENGINE=postgres a TUNE_DB_HOST, TUNE_DB_PORT, TUNE_DB_NAME, TUNE_DB_USER és TUNE_DB_PASS változókkal együtt.

Hálózati portok

A Tune minden hálózati interfészen figyel; a figyelési cím nem módosítható. Tune OS-en a 80-as port a 8888-ra irányít át.

Biztonság

A Tune alapértelmezetten jelszó és HTTPS nélkül működik: a helyi hálózatodhoz hozzáférő bárki megnyithatja a felületet. Ne tedd elérhetővé a 8888-as portot az interneten. Az API-ban létezik fiók- és tokenalapú hitelesítés (lásd: Műszaki útmutató), de a felületről nem állítható be.

Lásd még

• Első lépések: telepítés platformonként
• Műszaki útmutató: az API és az architektúra részletei
• Hibaelhárítás: gyakori konfigurációs problémák