トラブルシューティング

最もよくある問題と、その対処法です。どれも効果がない場合は、Tune からレポートを送信してください。診断に必要なものがすべて含まれています。

インターフェースが開かない

Tune が動作しているか確認します。Windows ではコンソールウィンドウ、sudo systemctl status tune-server（.deb パッケージ）、Tune OS では sudo systemctl status tune です。
アドレスは http://<server-address>:8888 です。Tune OS では http://tune-XXXX.local または http://<IP-address> です。
インストールしたばかりの Tune OS：初回起動には 15 分から 30 分かかり、自動で 2 回再起動します。SSH にすでに応答するマシンでも、完了しているとは限りません。進捗は /var/log/tune-os-firstboot.log に書き込まれます。
Windows で、他のデバイスからアクセスできない：Windows ファイアウォールが、「プライベートネットワーク」プロファイルで Tune をブロックしています。Windows ファイアウォールで、プライベートネットワークでの tune-server.exe を許可してください。同じブロックにより、DLNA の検出もできなくなります。
ポートがすでに使用されている：TUNE_PORT で別のポートを指定します（設定を参照）。Windows では 1.0.0-rc2 以降、Tune の実行中にショートカットからもう一度起動すると、実行中のインスタンスがブラウザーで開くだけです。
Docker: コンテナが再起動を繰り返す (NAS では予期せず停止する): /data にマウントしたフォルダに tune ユーザー (uid 1000) が書き込めません。Docker が自動で作成したフォルダ (./data など) がこれに当たります。名前付きボリューム tune-data:/data に置き換えるか (はじめにを参照)、フォルダの所有者を uid 1000 にしてください: sudo chown -R 1000:1000 ./data。その後 docker compose up -d を再実行します。

デバイスが表示されない

デバイスとサーバーは、同じネットワーク（同じサブネット、同じ VLAN）にある必要があります。検出にはマルチキャストを使います：SSDP（UDP 1900）と mDNS（UDP 5353）。
Docker では、network_mode: host を使います。
設定 › オーディオ › 無視しているデバイスを確認します。デバイスが非表示になっている可能性があります。
マシンに複数のネットワークカード（または VPN）がある場合は、TUNE_ADVERTISED_IP で Tune が通知するアドレスを指定します。
同じマシンの LMS がポート 3483 を使っているため、Squeezebox プレーヤーには Tune が見えません。

音が出ない

ローカル出力

設定 › オーディオ › ローカルオーディオ出力のオーディオバックエンドを確認します。Windows では、ASIO に DAC メーカーのドライバーが必要です。
別のアプリケーションが排他モードで DAC を占有している可能性があります。そのアプリを閉じてください。
Linux（.deb パッケージ）：サービスは tune ユーザーで動作するため、このユーザーが audio グループに属している必要があります。
Linux：1.0.0-rc1 では、ALSA/PipeWire のスキャンが止まると Tune 全体が固まり、手動で再起動する必要がありました。1.0.0-rc2 以降、このような停止でサーバーが固まることはなくなりました。それでもオーディオ出力が失われる場合は、Tune からレポートを送信してください。
プロセッサーが 1 つだけのマシン：1.0.0-rc2 以降、Tune は常に 4 つ以上のワーカースレッドを確保し、ローカル再生を途切れさせていた数秒間のフリーズを防ぎます。

ネットワークデバイス

設定 › オーディオ › オーディオ診断（エキスパートレベル）と、再生バーのシグナルパスで、デバイスに送られている内容を確認できます。
送っているフォーマットをデバイスが受け付けるか確認します。DSD の場合は、設定 › デバイス › ゾーンごとの設定で自動または PCM（変換）を試してください。
レンダラーへの DSD 256/512 で音切れがする場合：設定 › オーディオ › DSD 再生（ネットワークレンダラー）の連続ストリーミングオプションを使います。1.0 にアップデートした後は、このオプションが選んだままになっているか確認してください。

Windows：起動時に ASIO が WASAPI にフォールバックする

症状：ASIO を選択しているのに、Tune の起動時に WASAPI の出力（たとえば「スピーカー」）しか表示されない、または再生が止まる。1.0.0-rc2 では、この切り替わりの 2 つの既知の原因が修正されています。Tune は ASIO ドライバーの検索が終わるのを待ってから WASAPI に切り替えるようになりました。それでも切り替わった場合は、ローカル出力で何も再生していないときに、次のデバイススキャンで自動的に ASIO に戻ります。

設定 › オーディオ › ローカルオーディオ出力 › オーディオバックエンドが ASIO に設定されていること、メーカーの ASIO ドライバーがインストールされていることを確認します。
Tune を再起動します。
Tune がクラッシュ後に ASIO スキャンを一時停止しましたと表示した場合、クラッシュの繰り返しを避けるため、ASIO ドライバーのスキャンをオフにしています。ASIO スキャンを再有効化をクリックしてから、Tune を再起動します。
問題が続く場合は、Tune からレポートを送信し、お使いの DAC とそのドライバーを記載してください。

Tune OS：1.0.0-rc1 でカバーとアーティスト写真が消える

1.0.0-rc1 の Tune OS は、カバーのキャッシュを /opt/tune/data/artwork_cache で探していましたが、以前のバージョンは /opt/tune/artwork_cache に保存していました。そのため、ほとんどのカバーとアーティスト写真が失われたように見えました。1.0.0-rc2 でこの問題は修正されています。起動時に Tune は元のキャッシュを使い直し、rc1 が別の場所に保存したものをそこへコピーします。何も上書きも削除もしません。したがって、Tune をアップデートするだけで済みます。すでに画像を手作業でコピーしていた場合も、元に戻す必要はありません。

ライブラリ

追加したフォルダーが表示されない：パスは Tune が動作しているマシン上に存在し、Tune の実行アカウントから読み取れる必要があります。初回起動の後は、TUNE_MUSIC_DIRS を変更しても効果はありません。設定 › ライブラリ › 保存場所を使ってください。
ネットワーク共有での変更が検出されない：Tune は 15 分ごとに共有を確認します。早めるには、もう一度ライブラリをスキャンを実行します。
ReplayGain のゲージが 0 % に戻る：1.0.0-rc1 では、アップデートや再起動の後にこうなっていました。1.0.0-rc2 以降は、ライブラリ全体ですでに解析済みのトラック数を示します。
起動時にネットワーク共有がまだ準備できていない：1.0.0-rc2 以降、Tune が自分でマウントする SMB 共有については、最初のマウントの試みを待ってからライブラリを解析し、その後もバックグラウンドで約 5 分間再試行します。共有が見つからない間に、カバーが消されることはなくなりました。
アップデート後にカバーが変わった：1.0.0-rc2 以降、フォルダーの画像（たとえば cover.jpg や folder.jpg）が、ファイルに埋め込まれたカバーより優先されます。ディスクごとにフォルダーを分けたボックスセットでは、ボックスセットの最上位フォルダーにある画像が使われます。あなたがアップロードしたカバーが置き換えられることはありません。
バックグラウンド解析がマシンの負荷を使いすぎる：設定 › オーディオ › バックグラウンド解析の速度を下げるか、サーバーの状態から一時停止します。

ストリーミングサービス

Deezer：「Deezer が ARL を拒否しました」やセッションの喪失：deezer.com を開いて新しい arl Cookie を取得し、設定 › アクセスとトークン › ストリーミングサービスに貼り付けます。
TIDAL、Qobuz：同じ場所でサービスの接続を解除し、もう一度接続します。
YouTube：YouTube 再生を有効にするを行っていないと、検索はできても再生に失敗します。
Spotify：1.0 では、カタログは閲覧できますが、再生はできません。アカウントを接続するには、ご自身の Spotify アプリの Client ID が必要です（ストリーミングサービスを参照）。
Bandcamp：数日後にキュー、履歴、お気に入りから再生し直したトラックは、アドレスの有効期限が切れているため再生できないことがあります。1.0.0-rc2 以降、この失敗はログに記録され、Chromecast のゾーンは無音のままにならず、エラーを知らせて停止します。そのトラックはアルバムのページから再生し直してください。

Tune からレポートを送信する

サイドバーの一番下にあるサポートを開きます。

不具合を報告する（診断タブ）

どなたでも、ライセンスなしで利用できます。何が起きているかを記入し、必要ならスクリーンショットを追加して、フォーラムに送信をクリックします。入力した内容、診断情報、サーバーの最近のログが、承認制のフォーラムスレッドに送られます。個人のパスはレポートから削除され、添付されるレポートを見るで送信前に内容を確認できます。

Tune が送信上限のメッセージを返した場合（最初の試行でも表示されることがあります。既知の問題で、報告済みです）は、レポートをコピーを使ってフォーラムの新しいトピックに貼り付けるか、後でもう一度お試しください。

サポートに問い合わせる（チケットタブ）

このフォームは、Tune Premium ライセンスが登録されているときに表示されます。件名、カテゴリー、対象のゾーン（任意）、本文、添付ファイル（最大 5 ファイル）があります。ログとシステム情報を添付はオンのままにしてください。これがないと、診断に何度もやり取りが必要になることがよくあります。リクエストの経過はチケットタブで確認できます。

ログ

設定 › システム › サーバーの状態（アドバンストレベル）：ログをダウンロード、または診断情報をダウンロード（ログ、診断情報、設定を含む ZIP。認証情報はマスクされます）。ログレベルも同じ場所で設定します。
ファイル：設定の「データの保存場所」の表を参照してください。