Tune by Mozaiklabs

設定

ほとんどの設定は、インターフェースの設定で行います。設定ファイルと環境変数が必要になるのは、インストール時（ポート、データベースの場所）と特別な場合だけです。このページでは両方を説明します。

設定

設定のタブを順に示します。一部は、アドバンストまたはエキスパートのインターフェースレベルでのみ表示されます（アカウントメニュー › インターフェース）。

タブ主な内容
一般再生（ループ、シャッフル、オーディオファイルモードでの音量）、インターフェース（テーマ、言語、起動時の画面、既定のゾーン、音量表示、サイドバーの順序）、プロフィール
オーディオローカルオーディオ出力（オーディオバックエンド、WASAPI モード、ReplayGain、バックグラウンド解析の速度）、ネットワークデバイス、Squeezebox / Lyrion、HQPlayer、ネットワークレンダラーへの DSD 再生、オーディオ診断、Wi-Fi ネットワーク
ライブラリライブラリのスキャン、保存場所（フォルダーと SMB 共有）、スキャンオプション、自動解析、メタデータ、補完、コンテンツの追加
ゾーンゾーンの自動作成、「追従」
デバイスゾーンごとの設定（DSD、最大レート、固定音量、厳密なビットパーフェクト、モノラル出力など）、設定のバックアップ
表示トラック一覧の列、コレクションのカバーモザイク、停止ボタン、サイドバーのソース
拡張機能（エキスパート）インストール済みの拡張機能とカタログ
アクセスとトークン（アドバンスト）ストリーミングサービス、サービスのキー（Last.fm など）
システム情報とアップデート、サーバーの状態（ログレベル、クリーンアップ）、データベース（バックアップ / 復元、PostgreSQL への移行）、データの保存先、他のプレーヤー（Roon、Plex）からのインポート、CSV エクスポート
音響解析（エキスパート）ライブラリの音響解析
Tune Premium ライセンスライセンスの有効化または解放

設定をすばやく見つけるには、アカウントメニューの設定を検索…を使います。

アップデート

新しいバージョンがあると、Tune はサイドバーでお知らせします（「アップデートあり」）。自分で確認するには、設定 › システム › 情報 › アップデートのアップデートを確認を使います。Windows、macOS、.deb パッケージ、Tune OS では、アップデートは Tune 内からインストールされ、実行中のスキャンは先に停止されます。Homebrew では、Tune が brew upgrade を実行するか、実行するよう案内します。Docker では、新しいイメージを自分で取得してください。

.deb についての注意：Tune からインストールしたアップデートは、apt を介さずに /opt/tune のファイルを置き換えます。その後で古い .deb を再インストールすると、そのパッケージのバージョンに戻ります。

バックアップ

設定 › システム › データベース › バックアップ / 復元は、データベースのコピーを作成します。コピーはデータベースの隣にある backups フォルダーに保存され、Tune は最新の 5 つを保持します。PostgreSQL では利用できません。代わりに pg_dump を使ってください。設定 › デバイス › 設定のバックアップは、ゾーンの設定をファイルに保存します。音量、キュー、グループは含まれません。ファイルはバックアップを開く…で再び読み込めます。

tune.toml 設定ファイル

Tune の起動にファイルは不要です。作成した場合、Tune は次の順に探し、最初に見つかった tune.toml を使います。

  1. Windows：%APPDATA%\Tune\tune.toml
  2. 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

ご注意：形式が正しくないファイルはエラーメッセージなしでスキップされ、Tune は次のファイルまたは既定値に進みます。

環境変数

環境変数は tune.toml より優先されます。Tune は、起動したフォルダーにある .env ファイルも読み込みます（Windows では、%LOCALAPPDATA%\TuneServer\ または tune-server.exe の隣にあるものも対象です）。.deb パッケージでは、/etc/default/tune-server に 1 行に 1 つ、引用符なしで書き、その後 sudo systemctl restart tune-server を実行します。

変数既定値用途
TUNE_PORT8888Web インターフェースと API のポート
TUNE_DB_PATH下記参照SQLite データベースファイル
TUNE_MUSIC_DIRSなし音楽フォルダー。カンマ区切り、または JSON 配列。初回起動時にのみ読み込まれます（下記参照）。
TUNE_AUTO_SCANfalse起動時にライブラリをスキャン（有効にするには true）
TUNE_LOG_LEVELinfoログレベル：error、warn、info、debug、trace
TUNE_LOG_FILEプラットフォームごとログファイルのパス
TUNE_ARTWORK_DIRプラットフォームごとカバーアートのキャッシュフォルダー
TUNE_ADVERTISED_IP自動検出Tune がレンダラーに通知する IP アドレス。マシンに複数のネットワークインターフェースがある場合に便利です。
TUNE_DATABASE_URLなしPostgreSQL を使うための postgres://… URL
TUNE_LOCAL_AUDIO_BACKENDautoWindows：auto（WASAPI）、wasapi、asio。設定 › オーディオでの選択が優先されます。
TUNE_LOCAL_EXCLUSIVE_MODEfalseローカル出力の排他モード
TUNE_TIDAL_QUALITYHI_RES_LOSSLESS要求する TIDAL の音質
TUNE_SLIMPROTO_PORT3483Squeezebox（SlimProto）サーバーのポート
TUNE_CLI_PORT9090LMS 互換のコマンドポート
TUNE_SCAN_IO_CONCURRENCYautoスキャン中に並列で読み込むファイル数（ハードディスクでは 4、それ以外では 32）
TUNE_DISCOGS_TOKENなしDiscogs の個人用トークン
TUNE_LASTFM_API_KEY、TUNE_LASTFM_API_SECRETなしLast.fm のキー。設定に一度だけコピーされます
TUNE_TELEMETRYオンfalse に設定するとテレメトリーを無効にします（設定 › システムでも変更できます）
RUST_LOGなし高度なログフィルター。TUNE_LOG_LEVEL より優先されます

音楽フォルダー。TUNE_MUSIC_DIRS（または music_dirs）は、初回起動時にのみ設定へコピーされます。それ以降は設定 › ライブラリ › 保存場所の一覧が優先され、変数を変更しても効果はありません。存在しないフォルダーや空のフォルダーはコピーされません。

削除された変数。従来の変数 PORT、HOST、MUSIC_DIRS、DB_DRIVER、API_KEY、AUDIO_DEVICE、DSD_MODE、WRITE_TAGS、WATCH_FILESYSTEM およびそれに類するものは、もう読み込まれません。.env.tune.example にある次の変数にも効果はありません：TUNE_TIDAL_ENABLED、TUNE_QOBUZ_ENABLED、TUNE_DEEZER_ENABLED、TUNE_SPOTIFY_ENABLED、TUNE_YOUTUBE_ENABLED、TUNE_DEFAULT_OUTPUT_FORMAT。サービスはインターフェースで有効にします。

データの保存場所

インストール方法データベースログ
Windows%LOCALAPPDATA%\TuneServer\tune.db%LOCALAPPDATA%\TuneServer\tune-server.log
macOS~/Library/Application Support/Tune/tune.db~/Library/Logs/tune-server.log
.deb パッケージ/var/lib/tune/tune.dbjournalctl -u tune-server
Linux アーカイブ./tune.db（起動フォルダー）~/.local/state/tune/tune-server.log
Docker/data/tune.dbコンテナーの出力（docker logs tune）
Tune OS/opt/tune/data/tune.dbjournalctl -u tune

カバーアートのキャッシュは、その隣にあります。Windows では %LOCALAPPDATA%\TuneServer\artwork_cache、macOS では ~/Library/Application Support/Tune/artwork_cache、Docker では /data/artwork_cache、Tune OS では /opt/tune/data/artwork_cache です。ログファイルの上限は 10 MiB で、バックアップコピーが 1 つ（.1）保持されます。Tune OS では、1.0 より前にインストールした機器は元のキャッシュ /opt/tune/artwork_cache をそのまま使います。

データベース：SQLite または PostgreSQL

Tune は既定で SQLite を使い、設定は不要です。PostgreSQL は、公開されている Windows、macOS、Linux（x86-64 と aarch64）のビルドでサポートされています。サポートされていないのは、Docker イメージと Linux の aarch64-musl ビルドです。有効にする方法は 2 つあります。

  • インターフェースで：設定 › システム › データベース › PostgreSQL へ移行（エキスパートレベル）。
  • 起動時に：TUNE_DATABASE_URL=postgres://user:password@host:5432/tune、または TUNE_DB_ENGINE=postgres に加えて TUNE_DB_HOST、TUNE_DB_PORT、TUNE_DB_NAME、TUNE_DB_USER、TUNE_DB_PASS。

ネットワークポート

ポート用途
TCP 8888Web インターフェース、API、WebSocket、およびレンダラーへ送られるオーディオストリーム
UDP 1900SSDP 検出（DLNA/UPnP）
UDP 5353mDNS 検出（AirPlay、Chromecast など）
TCP/UDP 3483Squeezebox（SlimProto）サーバー。同じマシンで LMS が動作していると競合します。
TCP 9090LMS 互換のコマンドポート。9090 が使用中の場合、Tune は 9091 から 9098 を試します。
TCP 8890UPnP/OpenHome のイベントリスナー（使用中の場合は別のポートが選ばれます）

Tune はすべてのネットワークインターフェースで待ち受けます。待ち受けアドレスは変更できません。Tune OS では、ポート 80 が 8888 に転送されます。

セキュリティ

既定では、Tune にはパスワードも HTTPS もありません。ローカルネットワークにアクセスできる人なら誰でもインターフェースを開けます。ポート 8888 をインターネットに公開しないでください。アカウントとトークンによる認証は API に存在します（技術ガイドを参照）が、インターフェースからは設定できません。

関連項目