トラブルシューティング

Vigilare のトラブルシューティングガイド - フローティングリマインダー・同期の問題・ウィンドウの動作・パフォーマンス最適化に関するよくある問題の解決方法。

Vigilare の調子が悪いですか?このガイドでよくある問題を片付けて、いつものタスク管理に戻りましょう。

前提条件

個別の問題に取りかかる前に、基本の要件を確かめてください。

  1. システム要件

    • macOS 15.0(Sequoia)以降
    • Apple リマインダーアプリ(プリインストール済み)
  2. 必要な権限

    • リマインダーアクセス — システム設定 → プライバシーとセキュリティ → リマインダー → Vigilare ✓
  3. Apple リマインダーアプリ

    • まず Reminders.app を開いて、タスクがそちらにあるか確かめる
    • 複数デバイスで使うなら iCloud 同期がオンになっているか確かめる

よくある問題

リマインダーが表示されない

Vigilare にリマインダーが出てこないときの手順です。

1. 権限を確認

  • システム設定プライバシーとセキュリティリマインダー を開く
  • Vigilare にチェックが入っていてアクセスできるか見る
  • なければ + ボタンをクリックして Vigilare を追加

2. Apple リマインダーでデータを確認

  • Reminders.app を開く
  • タスクがそちらにあるか確かめる
  • そちらにもなければ、Vigilare の問題ではない

3. ビューを更新

  • Vigilare のウィンドウヘッダーの**更新ボタン(↻)**をクリック
  • または Dock から Vigilare を再起動

4. リスト絞り込みを確認

  • 目当てのタスクを外すフィルターを選んでいないか見る
  • リストドロップダウンで「すべて」に切り替えてみる

5. リストがアーカイブされていないか確認

  • 設定(⚙)リストタブを開く
  • リストがアーカイブされていないか見る
  • 必要なら復元する

ウィンドウが消えた

Vigilare のウィンドウが見えなくなったときの手順です。

クイック修正

  1. DockVigilare アイコンをクリック
  2. ウィンドウが出てくる

Dock アイコンがない場合

  1. アクティビティモニタで Vigilare が動いているか見る
  2. 動いていなければアプリケーションフォルダから起動
  3. 動いているのにアイコンがなければ macOS を再起動

ウィンドウが画面外に出ている

見えているディスプレイの外に置かれているかもしれません。

  1. Dock アイコンをクリックするか設定(⌘,)を開く
  2. ウィンドウ位置を手で動かす
  3. または Vigilare を終了して ~/Library/Preferences/jp.labee.floating-reminders.plist を削除してリセット

同期の問題

Vigilare の変更が Apple リマインダーに出てこない(またはその逆)ときの手順です。

リアルタイム同期の遅延

  • 変更の同期に数秒かかることがある
  • iCloud の同期はネットワーク次第で遅くなる
  • 5〜10 秒待ってからもう一度見る

強制更新

  1. Vigilare の**更新ボタン(↻)**をクリック
  2. Apple リマインダーを開いて更新
  3. 複数デバイスで使っているなら iCloud の状態を見る

iCloud 同期の問題

  1. システム設定Apple IDiCloud
  2. リマインダーのトグルが ON か見る
  3. 「アカウントの状態」にエラーが出ていないか見る
  4. リマインダーを OFF → ON と切り替えてみる(発破をかける感じです)

権限のリセット

同期がまったく動かないときはこうします。

  1. システム設定プライバシーとセキュリティリマインダー
  2. Vigilare のチェックを外す
  3. Vigilare を再起動
  4. 聞かれたら権限をもう一度与える

ウィンドウの動作の問題

ウィンドウが最前面に居続けない

  • 設定(⚙)一般 を開く
  • ウィンドウレベルが「通常」ではなく**「フローティング」**か見る
  • 「デスクトップ」レベルはすべてのウィンドウの後ろに出る

ウィンドウの見え方

  • 見えつつ邪魔にならない位置に置き直す
  • 集中したいときはアイコン最小化モードを使う

すべての Space でウィンドウが出ない

  • 設定一般スペース
  • **「すべての Space に表示」**に変える
  • 反映には Vigilare の再起動が要る

最小化モードから戻れない

ウィンドウが小さなアイコンのまま固まっているときはこうします。

  • アイコンをダブルクリックして復元
  • または Dock アイコンをクリックしてウィンドウを表示

タスク管理の問題

新しいタスクを追加できない

  • リマインダーの権限を見る(前提条件を参照)
  • まず Apple リマインダーで追加して試す
  • 選んでいるリストが新規アイテムを受け付けるか見る

タスクを編集・削除できない

  • 一部のシステムリストは読み取り専用のことがある
  • Reminders.app での権限を見る
  • 共有リストは編集権限が絞られていることがある

タスクの完了が保存されない

  • iCloud の同期を数秒待つ
  • インターネット接続を見る
  • Apple リマインダー側で完了を切り替えてみる

サブタスクが出てこない

  • ネイティブサブタスク — Vigilare は階層的なサブタスクをメインリストに出しません。これは仕様です。
  • チェックリスト — Markdown エディタでタスクメモ内にチェックリストを作ってください。
  • タスクが Apple リマインダーにあるか確かめてください。

Markdown エディタの問題

エディタが読み込まれない

  • インターネット接続を見る(エディタのリソースは初回に読み込まれる)
  • 別のリマインダーを編集してみる
  • 直らなければ Vigilare を再起動

書式設定が保存されない

  • 編集ウィンドウを閉じる前に**「保存」**ボタンをクリック
  • またはショートカット ⌘S を使う
  • 変更は数秒おきに自動保存される

テキストが文字化けして見える

  • 互換性のない書式が紛れているかもしれない
  • いったんプレーンテキストエディタに中身をコピー
  • Vigilare のエディタツールで書式を付け直す

キーボードショートカットが効かない

ショートカットが反応しない

  • Vigilare ウィンドウにフォーカスがあるか確かめる(まずクリック)
  • 一部のショートカットは特定の場面でしか効かない
  • macOS のシステムショートカットが上書きしていないか見る

使えるショートカットを全部見る

  • 設定(⚙)ショートカットタブを開く
  • 説明付きの完全な一覧がある
  • ショートカットはウィンドウがアクティブなときだけ効く

パフォーマンスの問題

アプリの動きが遅い

  1. 見えるタスクの数を減らす

    • 終わったリストをアーカイブする
    • リスト絞り込みで表示を減らす
  2. macOS のリソースを見る

    • アクティビティモニタを開く
    • RAM に余裕があるか見る
    • 要らないアプリを閉じる
  3. Vigilare を再起動する

    • Dock アイコン → 「終了」
    • アプリケーションから立ち上げ直す

メモリ使用量が多い

  • ふだんの範囲は 50〜150 MB
  • 大きなタスクリスト(500 件以上)では増えることがある
  • 古いリストをアーカイブして軽くする

ウィンドウの描画がもたつく

  • タスクが多いときはウィンドウを小さくする
  • 使っていないあいだはアイコンに最小化する

よくあるエラーメッセージ

「リマインダーのアクセスが拒否されました」

原因 — Vigilare に Apple リマインダーへアクセスする権限がない。 解決策 — 上の権限を確認を参照。

「リマインダーの読み込みに失敗しました」

原因 — 一時的な同期または権限の問題。 解決策は次のとおりです。

  1. インターネット接続を見る
  2. Apple リマインダーアプリが動くか確かめる
  3. Vigilare を再起動する
  4. 必要なら権限をリセットする

「変更を保存できません」

原因 — 書き込み権限か iCloud 同期の問題。 解決策は次のとおりです。

  1. iCloud の状態を見る
  2. リストが読み取り専用でないか見る
  3. まず Apple リマインダーで編集してみる
  4. iCloud のストレージ残量を見る

高度なトラブルシューティング

Vigilare の環境設定をリセット

Vigilare の挙動がおかしいときはこうします。

  1. Vigilare を完全に終了
  2. Finder を開く → メニューの「移動」→「フォルダへ移動」
  3. ~/Library/Preferences/ と入力
  4. jp.labee.floating-reminders.plist削除
  5. Vigilare を再起動

⚠️ 警告 — この操作ですべての設定(ウィンドウ位置・アーカイブ済みリストなど)がリセットされます。

コンソールログの確認

詳しいエラー情報がほしいときはこうします。

  1. コンソール.app を開く(アプリケーション/ユーティリティ内)
  2. サイドバーで自分の Mac を選ぶ
  3. **「Vigilare」**で検索
  4. エラーや警告のメッセージを探す

クリーン再インストール

どうにもならないときの最終手段です。

  1. Vigilare を終了
  2. アプリケーションからアプリをゴミ箱へ
  3. 環境設定を削除~/Library/Preferences/jp.labee.floating-reminders.plist
  4. ゴミ箱を空にする
  5. Mac を再起動(アプリのキャッシュが全部消える)
  6. Mac App Store から再インストール

既知の制限事項

いまの制限はこのとおりです。

  • macOS 15 以降が必要 — API の要件のため、古いバージョンでは動かない
  • Apple リマインダーのみ — 他のタスク管理システムにはつながらない
  • ウィンドウはひとつ — フローティングウィンドウは同時に 1 枚だけ
  • グローバルホットキーなし — ショートカットはウィンドウにフォーカスがあるときだけ効く

さらなるヘルプ

それでも解決しないときはこうしてください。

  1. FAQ でよくある質問を見る
  2. 問題を書き留める
    • 何をしようとしていたか
    • 実際に何が起きたか
    • エラーメッセージがあればその内容
    • macOS のバージョン
  3. サポートページからサポートに連絡

バグを報告する

Vigilare の改善に力を貸してください。

  1. 添えてほしい情報
    • macOS のバージョン
    • Vigilare のバージョン(設定 → About)
    • 再現手順
    • あればスクリーンショット
  2. 具体的に書く — 「タスクが同期されない」よりも「Vigilare で作ったタスクが 5 分経っても Reminders.app に出てこない」
  3. サポートページからご連絡ください