Primuse 全体ワークフローガイドと設計思想（なぜそう動くのか）

概要

メディアサーバー（最速で同期）：Navidrome、Subsonic、Jellyfin、Emby、Plex、Audiobookshelf、Ting Reader、Synology Audio Station などをお使いの場合は、対応するサーバー種別を選択してください。サーバー側のインデックスを直接読み取るため、数万曲のライブラリも数十秒で同期できます。
NAS 共有フォルダ・クラウドストレージ：Synology File Station、QNAP、SMB、WebDAV、SFTP、FTP、NFS、S3、および OneDrive、Google Drive、Dropbox、pCloud、Drime、InfiniCLOUD などに対応しています。オーディオブックや朗読のフォルダは、フォルダ選択時に**「オーディオブック」**としてマークすると、音楽ライブラリと混ざらずに専用の書棚へ整理されます。
ローカルファイルと Apple Music：iPhone / iPad のローカル音楽は**「フォルダを参照」**を選ぶと本体容量を二重に消費しません。Apple Music を有効にすれば、サブスクリプション楽曲と自宅 NAS のロスレス音源を同じ再生キューに並べて連続再生できます。
LAN / WAN デュアルアドレス：同一ソースに自宅内 IP と外部ドメインの両方を登録しておけば、自宅 Wi-Fi では高速な LAN 直結、外出時は自動的に外部接続へ切り替わります。

WebDAV・SMB・クラウドでは2段階スキャンを行います。第1段階でファイル一覧を素早く登録してすぐ再生できるようにし、第2段階でタグ、埋め込みジャケット、歌詞、および .cue や SACD ISO / DVD-Audio ISO / データ ISO のトラック情報をバックグラウンドで読み取ります。

自動・一括スクレイピングは空欄のみを補完し、サーバーやファイルにすでに入っているアルバム名やジャケットを勝手に書き換えることはありません。特定の曲の誤った情報を置き換えたい場合は、**「単曲スクレイピングプレビュー」**から候補を選んで適用すると、今後の更新でもその選択が優先保持されます。

オーディオエフェクト処理：10バンドイコライザー（イヤホン・スピーカーごとの自動切替対応）、空間リバーブ、ReplayGain 音量均一化（有効な dB 値を音質バッジに表示）、キー変更（ピッチシフト）、再生速度変更、スマート／固定クロスフェード、サビだけを繋ぐ**「メドレー再生」**が利用できます。
ハイレゾ直通（Bit-Perfect）：EQ やクロスフェード、ReplayGain をすべてバイパスし、原音そのままの PCM を DAC へ送出します（Mac では排他モードとサンプルレート自動切替に対応）。

オーディオキャッシュ：再生中に自動保存され、設定した上限に達すると古いものから自動整理されます。1.13.0+ ではフォルダ単位の一括キャッシュと3行のリアルタイム進捗表示に対応しています。
オフラインダウンロード：手動でダウンロードした曲や「常にオフライン保持」にしたプレイリストは別領域に保護され、キャッシュ上限の自動削除対象になりません（原音保持または 128 / 192 / 256 / 320 kbps AAC 変換に対応）。
LAN キャッシュ同期：Mac にキャッシュ済みの音源を、同じ Wi-Fi 上の iPhone へ直接転送してクラウドからの再ダウンロードを省けます。

オンライン歌詞と埋め込み／同階層歌詞のワンタップ切替、オフライン翻訳・Apple Intelligence・独自 AI 翻訳による二ヶ国語表示、日本語のふりがな／ローマ字自動付与に対応しています。
歌詞共有カードでは**「音楽を付ける」**をオンにして、音源付きの Live Photos やショート動画として書き出せます。
マイクボタンからカラオケステージを開くと、端末内の AI モデルがリアルタイムでボーカルと伴奏を分離し、キー変更やマイクモニター、伴奏／ボーカル音源（WAV / M4A）の書き出しが可能です。

スキャン時に曲数が急減しても、すぐにライブラリから削除しない理由 NAS のスリープ復帰遅れやネットワークの一時的なタイムアウトでフォルダが空に見えた際、即座に削除してしまうとプレイリストや再生回数、評価がすべて消えてしまうためです。意図的にサーバー側で削除した曲をすぐ消したい場合は、音楽ソースメニューの「サーバーで削除された曲」から手動で即時削除できます。
ハイレゾ直通モードや Apple Music 再生時に EQ やクロスフェードが効かない理由 Bit-Perfect 出力は 1 サンプルも改変せずに DAC へ届ける仕組みであるため、PCM を加工するエフェクト類は意図的にバイパスされます。また Apple Music のサブスクリプション音源はシステムの DRM パイプラインで再生されるため、外部アプリによる DSP 処理やリアルタイムスペクトラム解析の対象外となります。