# 困ったとき

よくある問題と対処です。ここで解決しないときは [GitHub Issues](https://github.com/masaodev/quick-dash-launcher/issues) で報告してください。

## ランチャーが起動しない

- QuickDashLauncher は同時に 1 つしか動きません。すでに動いているときにもう一度起動すると、新しくは起動せず、動いている側のランチャーが表示されます。それでもウィンドウが出ないときは、タスクマネージャーで QuickDashLauncher のプロセスを終了してから起動し直してください
- タスクトレイのアイコンをクリックしてみてください
- 起動の途中で失敗したとき（設定フォルダに書き込めないなど）は、「Quick Dash Launcher を起動できませんでした」と理由を出して終わります。理由を見て、設定フォルダの場所や権限を確かめてください

## ホットキー（Alt+Space）が効かない

- ほかのアプリとホットキーが競合している可能性があります。起動時に登録できなかったときは、トースト「…を登録できませんでした」で知らせます。設定画面で別のキーに変えてみてください（[キーボードショートカット](./keyboard-shortcuts.md)）
- 管理者権限で実行してみてください

## ウィンドウが決まった位置に並ばない

- ウィンドウの位置は仮想スクリーン座標（メインモニターの左上が原点）で指定します。ディスプレイ設定でモニターの配置を確認してください
- 単一アイテムの「オプション設定（ウィンドウ切り替え・ウィンドウ位置）」で「🔍 開いているウィンドウから選ぶ」を使うと、いま開いているウィンドウの位置・サイズを取り込めます
- セットで並べるときは、ウィンドウを実際に並べてから編集画面の「ウィンドウ位置を更新」で取り込み直してください。ランチャーの右クリックの「ウィンドウ位置を更新」も使えます
- セットの行が対象ウィンドウを見つけられないときは、行の詳細の「対象ウィンドウ」の exe 名とウィンドウタイトルを確かめてください。タイトルは全体が同じものを探すので、内容でタイトルが変わるアプリは `*` を使います（例: `*Obsidian`）。版番号などタイトルの一部だけが変わるアプリは、一部だけで探します（例: `*一時メモ.txt*`。行の詳細のタイトルの部品の候補を押すとこの形になります）
- 「ウィンドウを追加」で足した行は動かすだけの行なので、ウィンドウが開いていないときは動かしません（進み具合に灰色の「－」と「開いていないので動かしませんでした」が出ます）。閉じていても開きたいときは、行の詳細で開くもの（アイテムかパス）を足してください
- 起動に時間のかかるアプリは、行の詳細の「ウィンドウが出るのを待つ（秒）」を長くしてください（既定 30 秒）
- 管理者権限で動いているウィンドウは、Quick Dash Launcher から動かせないことがあります（詳細は [セット](./set.md#既知の制限)）

## フォルダ取込が展開されない

- フォルダのパスが正しいか確認してください
- フォルダへのアクセス権限を確認してください

## アイコンが表示されない

- Web サイトのファビコンは、初めて表示するときに自動で取得します
- 設定フォルダの `icon-cache\favicons\` の権限を確認してください（設定フォルダは既定で `%APPDATA%\quick-dash-launcher\config\`。詳細は [アイコンシステム](./icons.md)）

## 原因を調べたいとき

- 設定フォルダの `logs\main.log` に動作の記録（ログ）が残っています（設定フォルダは既定で `%APPDATA%\quick-dash-launcher\config\`）。古いものは `main.1.log`・`main.2.log` で、合わせておよそ 3MB になるよう古い順に消えます
- 不具合を報告するときは、起きた時刻の前後のログを添えてもらえると原因を探しやすくなります（パスやアイテム名が含まれるので、必要なら伏せてください）