05-shortcuts-and-troubleshooting
ショートカット・トラブルシューティング
困ったときの入口。症状から引く索引は 逆引き索引 にもあります。
キーボードショートカット
全一覧はリファレンスにあります → キーボードショートカット
あのページは MeloDear のソースから自動生成しているので、
アプリの実際の割り当てと必ず一致します（ここに手で書き写すと古くなるので置きません）。
アプリの中では ? キーでも要点の一覧が出ます。
覚えておくと効くものだけ挙げると:
| キー | 動作 |
|---|---|
? | ショートカット一覧を出す |
Space | 再生 / 一時停止 |
[ / ] | 前の曲 / 次の曲 |
1〜8 | Cue へジャンプ（Shift+1〜8 で保存） |
A / B / L | A-B ループの A 点 / B 点 / ループ ON・OFF |
Ctrl+, | 設定 |
Ctrl+F | 検索バー |
アルファベットや数字のショートカットは、検索欄が空のときだけ効きます。
検索に文字を入れている間は、キーがそのまま検索語になります。
トラブルシューティング
起動関連
起動しない / 起動直後に落ちる
- まず
%LOCALAPPDATA%\MeloDear\logs\を見る。panic-<日時>.logがあれば、その中の
「message」「location」と末尾のログが原因。報告のときはこのファイルを添えると早い。
- 特定の表示（アルバムグリッド等）に切り替えた直後から毎回落ちるようになった場合、その表示が
state.toml に保存され「起動 → 復元 → 初回描画で落ちる」を繰り返している可能性がある。
MeloDear は初回描画前の失敗が続くと自動でセーフモードに入り、表示を既定（テーブル）へ戻して
起動し直す。数回起動し直せば復帰する。
- それでも駄目なら手動で戻す：アプリを閉じ、
%APPDATA%\MeloDear\state.tomlの
view_mode = "..." の行を view_mode = "table" に書き換える（または state.toml を削除。
ライブラリ DB は別なので曲は残る）。
再生関連
再生ボタンを押しても音が出ない
- トランスポートバー右側の エンジン表示 で出力先を確認
- Moonphase 右クリック → 出力デバイスが正しいか
- Windows 側で MeloDear がミュートされていないか（音量ミキサー）
- Settings →「オーディオ」で再生エンジンを確認。配布 MSI は Rodio のみで、
WASAPI Exclusive は「未ビルド」、ASIO は別配布の -asio.zip 版でしか選べません
再生開始まで時間がかかる（10 秒以上）
- Rodio バックエンドでは再生中にプラグインをかけてもすぐ音が出ます
- WASAPI Exclusive / ASIO バックエンドでは現状オフライン pre-render のため、ファイル長に比例した待ち時間が出ることがあります（改善は今後予定）
プラグインが音に効かない
- Chain Editor で enabled が ON か、Master Bypass が OFF か 確認
- Dry/Wet が 0% になっていないか
- Rodio バックエンドを使用中か（WASAPI/ASIO はストリーミングチェイン未対応）
Windows 出力デバイスを変えても MeloDear が追従しない
- Moonphase 右クリック → 「Windows 既定に従う」モードを選択
- 「特定デバイスに固定」モードだと意図的に追従しない
ライブラリ関連
スキャンが終わらない / 遅い
- 2026-06 以降：初回スキャンはタグ読み取り中心で、曲は 順次一覧に表示 されます。全件 SHA-256 は背景処理のため、進捗バーが 100% になっても hash バックフィルが続くことがあります（通常利用には影響しません）
- OneDrive / Dropbox 等の クラウド同期フォルダ 上だと I/O が遅くなりやすい → ローカル SSD 推奨
- ファイル数規模を確認（1 万曲で従来より短時間、HDD は SSD より遅い）
- 「Analyze only missing」で再解析を抑制
解析が進まない / CPU が低い
- 解析進捗バーで 一時停止 になっていないか確認
- CPU 配分スライダーを上げる（内部上限 8 並列）
- ONNX モデル未インストール時、ML 項目はスキップまたはヒューリスティックにフォールバックすることがあります → Settings →「AI モデル」を確認
- クラウド同期フォルダ上では解析も遅くなりやすい
曲が表示されない
- 左パネルで正しいライブラリを選択しているか
- 「FILTERS」の絞り込みを「All Tracks」にリセット
- 検索欄を空にする（Ctrl+F → Esc）
- 対応フォーマットか（mp3 / m4a / aac / flac / wav / aiff / aif / ogg / opus / wma / oga）
列の幅が変わらない / 列が潰れている
- ヘッダー右端の境界線（ホバーでアクセント色の縦線）を掴んでドラッグ
文字が小さい / 読みにくい
Ctrl++で拡大、Ctrl+0でリセット- Settings → 外観 →「UI ズーム」で永続化
音声作品関連
Artist / Album が空欄、タイトルが「トラック1」
- Settings →「外部メタデータ」→「パス推論テンプレ」を「無効」以外にする
- テンプレを「DLsite」または「DMM/Fanza」に
- 「現ライブラリに再適用」の［実行］
正式タイトルや声優情報が欲しい
- Settings →「外部メタデータ」→「DLsite / DMM」で「オンライン照合を有効」
- 「私は 18 歳以上です」をチェック（R18 作品の場合）
- ライブラリで右クリック →「オンラインで照合（自動）」→ 自動 or DLsite/DMM 個別
artwork（cover.jpg）が反映されない
- Settings →「外部メタデータ」→「フォルダ artwork を拾う」が ON か
- 「現ライブラリに再適用」の［実行］
- それでも反映されない場合、フォルダアセットビューア（右パネル）から手動で画像を選択して画像サムネ下の［Artwork］
UI 関連
パネルが消えて操作できない
- 左パネルは
Ctrl+Num4、右パネルはCtrl+Num6、下パネルはCtrl+Jでトグルできます - 一度全部表示に戻すと整理しやすくなります
Dark/Light ボタンが押せない / 反応がわかりにくい
- 背景に溶けて見えるだけで実は押せている可能性
- 押した瞬間に画面全体の配色が変わるはず
プラグイン関連
プラグイン GUI が空白の白い窓で出る
- 一部のプラグインでは純正 GUI の埋め込みがうまくいかない場合があります
- Edit を押しても空白なら自動で閉じてエラートーストが出ます
- その場合でもチェイン内で音には効いています（GUI なしで bypass / dry-wet 等は操作可能）
「+ プラグイン追加」を押してもリストが空
- Settings →「プラグイン」タブで［スキャン］を実行（検索パスは表示のみ。フォルダ指定 UI はありません）
- 配布版は CLAP のみ対応です。VST3 は読み込めません（設定画面には VST3 の文字が出ますが無効）
- CLAP プラグイン（
.clap）が標準パスに入っているか。追加パスは環境変数CLAP_PATHで指定します - スキャンが完了しているか（進捗を確認）
一般的な対処
- 再起動：UI の状態異常は再起動で大体直る
melodear.dbが異常に大きい：Settings →「メンテナンス」→「アートワーク DB 肥大の解消」で
画像をファイルに追い出して VACUUM する
- 一部のファイルが毎回引っかかる：Settings →「メンテナンス」→「起動の除外（診断）」に
溜まっている可能性がある。重複・probe 失敗・年齢指定 404 は恒久スキップされる。
［除外リストをクリア］で戻せる（サイズや更新日時が変われば自動で復活します）
- 「設定を読み込めませんでした」と出た：
state.tomlが壊れ、世代バックアップも読めなかった状態。
［新しく始める］で初期設定に戻る（ライブラリ DB は別なので曲は残ります）
- state.toml のリセット：
%APPDATA%\MeloDear\state.tomlを削除すると初回起動状態に戻る（ライブラリ DB は別なので曲は残る） - ライブラリ DB のリセット：
melodear.dbを削除すると DB は作り直し（音声ファイル本体は無傷）。
置き場所は設定によって変わるので データとファイルの置き場所 を見ること
消してよいファイル・消してはいけないファイルの一覧も
データとファイルの置き場所 にあります。
既知の制約
アルファ版なので、以下は 未実装または発展途上です。
- WASAPI / ASIO バックエンドでのストリーミング・チェイン（現状オフライン pre-render のため再生開始遅延あり）
- Voice 専用 UI の polish（種別・DB 基盤は実装済、Projects モード本格 UI 等は拡張中）
- コード署名（インストール時に SmartScreen の警告が出ます）
- macOS / Linux 対応
現時点の詳しい残課題は、公式サイトの
既知の問題 が最新です。
バグ報告 / 機能要望
アルファ版なので、見つけたバグや欲しい機能は開発者へ直接ご連絡ください。
報告のときに Help → About のバージョン（例 0.2.3+1）と、
落ちた場合は %LOCALAPPDATA%\MeloDear\logs\ の panic-*.log を添えてもらえると助かります。