本文へスキップ
サイトへ戻る

よくある問題

このページでは、機能別によく報告される問題と解決策をまとめています。権限やアクセシビリティの問題は権限とアクセシビリティをご覧ください。

起動・全般

IrukaDarkが起動しない / 画面が真っ白になる

  1. 完全に終了して再起動 — Cmd+Q（macOS）またはシステムトレイから終了（Windows）し、再度起動してください。
  2. 他のインスタンスが動作していないか確認 — IrukaDarkは1つのインスタンスのみ動作します。バックグラウンドプロセスが残っている場合は、アクティビティモニタ（macOS）またはタスクマネージャー（Windows）でIrukaDarkプロセスを強制終了してから再起動してください。
  3. 設定ファイルをリセット — 設定ファイルが破損すると起動を妨げることがあります。以下のファイルを削除して再起動してください：
    • macOS: ~/Library/Application Support/irukadark/irukadark.prefs.json
    • Windows: %APPDATA%\IrukaDark\irukadark.prefs.json

設定ファイルを削除すると、すべての設定（テーマ、言語、ショートカット、透明度）がデフォルトに戻ります。アカウントやデータには影響ありません。

動作が重い / メモリ使用量が多い

IrukaDarkは大量データの処理のため最大2GBのメモリを割り当てます。リソース消費が過度な場合：

  1. IrukaDarkを再起動して蓄積された状態をクリア
  2. クリップボード履歴が大量（1000件以上）の場合、古いアイテムの削除を検討
  3. 使用していない時はチャットウィンドウを閉じる — アクティブな会話はメモリにコンテキストを保持します

ログイン時に自動起動しない

IrukaDarkはログイン時の自動起動をサポートしています。自動起動しない場合：

  • macOS: IrukaDarkの設定でログイン時に起動が有効になっていることを確認。すでに有効の場合はオフ→オンを試してください。
  • Windows: 設定 → アプリ → スタートアップでIrukaDarkが有効になっていることを確認。

AI機能

「クレジット不足」

このエラー（HTTP 402）はクレジット残高がゼロであることを意味します。

  • ダッシュボード → クレジットで現在の残高を確認
  • 無料プランのユーザーには毎月クレジットが付与され、請求サイクルごとにリセットされます
  • チームプランのOwnerはクレジットページから追加のクレジットパックを購入可能
  • より多くの月間クレジットが必要な場合はプランのアップグレードを検討

AI応答が空または途中で切れる

  1. インターネット接続を確認 — すべてのAI機能にはアクティブな接続が必要
  2. 再試行 — 一時的なAPIの問題で応答が不完全になることがあります。数秒待ってから再試行してください。
  3. リクエストを簡潔に — 非常に長いテキスト選択や複雑なプロンプトは処理上限に達する場合があります。テキストの選択範囲を小さくしてみてください。

「リクエスト制限に達しました。X秒お待ちください。」

短時間に多くのリクエストを送信しました。表示された秒数（通常60秒）待ってから再試行してください。これはサービス保護のためのアカウント単位の制限です。

「APIから予期しない応答」

サーバー側の問題です。通常は数分以内に自動的に解決します。継続する場合：

  1. インターネット接続を確認
  2. IrukaDarkを再起動
  3. 30分以上続く場合は、IrukaDarkのWebサイトでサービスのお知らせを確認

「認証が必要です」

セッションの有効期限が切れています。

  1. IrukaDarkの設定からサインアウト
  2. 再度サインイン
  3. 問題が続く場合はアプリを再起動してからサインイン

スクリーンショット解説

スクリーンショットが真っ黒・真っ白になる

  • macOS: 画面収録の権限が未付与の可能性があります。権限 → 画面収録を参照。
  • Windows: 一部のアプリではハードウェアアクセラレーションが画面キャプチャをブロックすることがあります：
    1. 対象アプリの設定でハードウェアアクセラレーションを無効にする（例：Chrome: 設定 → システム → ハードウェアアクセラレーションを使用する）
    2. グラフィックスドライバーを最新バージョンに更新
    3. Windows 11 24H2以降では設定 → プライバシーとセキュリティ → 画面キャプチャを確認

スクリーンショット解説が何も返さない

  1. 可視領域を選択しているか確認 — 最小化されたウィンドウや完全に隠れたウィンドウはキャプチャできません
  2. クレジット残高を確認 — スクリーンショット解説は各分析でクレジットを消費します
  3. より小さく焦点を絞った選択範囲を試してください

十字カーソルが表示されない

画面収録の権限が付与されていないか、権限付与後にアプリの再起動が必要です。

  • macOS: システム設定で画面収録を許可し、IrukaDarkを再起動（Cmd+Q→再起動）
  • Windows: IrukaDarkを再起動

テキスト解説・翻訳

テキスト解説がショートカットを押しても反応しない

  • macOS: テキストの読み取りにはアクセシビリティの権限が必要です。権限 → アクセシビリティを参照。
  • 全プラットフォーム: ショートカットを押す前にテキストが実際に選択されていることを確認。一部のアプリ（ターミナルエミュレータ、リモートデスクトップクライアントなど）はテキスト選択をOSに公開しない場合があります。

翻訳してその場で置換が動作しない

この機能には以下の両方が必要です：

  1. アクセシビリティの権限（macOS）— テキストの読み取りとキーボード入力のシミュレーション
  2. オートメーションの権限（macOS）— 対象アプリへのペースト

翻訳テキストがIrukaDarkのポップアップに表示されるが元のテキストが置き換わらない場合：

  • システム設定 → プライバシーとセキュリティ → オートメーションで対象アプリがIrukaDarkの下に表示されていることを確認
  • 一部のアプリはプログラムによるペーストをブロックします。ポップアップに翻訳が表示された後、手動でCmd+Vを使用してみてください。

言語の検出・翻訳が正しくない

IrukaDarkはソース言語を自動検出します。精度を向上させるには：

  1. 長めのテキストを選択（短いフレーズは曖昧な場合があります）
  2. IrukaDarkの設定 → 言語で使用する言語を設定
  3. AIチャットで/translate_ja、/translate_enなどのスラッシュコマンドで明示的に言語を指定

AIノートテイカー

「録音の開始に失敗しました」

  1. 権限を確認 — 画面収録とマイクの両方の権限が必要。権限ページを参照。
  2. 別の録音が実行中でないか確認 — 同時に1つの録音セッションのみ実行可能。既存の録音を停止してください。
  3. IrukaDarkを再起動 — 古い録音状態が残ることがあります。アプリを終了して再起動してください。

「画面収録の権限が必要です」

macOSでのシステム音声キャプチャには画面収録の権限が必要です。マイク音声のみ録音したい場合でも、録音パイプライン全体でこの権限が求められます。

権限 → 画面収録の手順に従い、権限付与後にIrukaDarkを再起動してください。

「マイクの権限が拒否されました」

  • macOS: 権限 → マイクを参照
  • Windows: 設定 → プライバシーとセキュリティ → マイクでグローバルトグルと「デスクトップアプリ」トグルの両方がオンになっていることを確認

システム音声が録音されない（マイクのみ動作する）

macOSでは画面収録の権限がシステム音声のキャプチャに必要です。マイクは動作するがシステム音声が無音の場合：

  1. IrukaDarkの画面収録が有効になっていることを確認
  2. 権限付与後にIrukaDarkを再起動
  3. 会議アプリが、IrukaDarkが監視しているのと同じオーディオデバイスに出力していることを確認

録音が無音 / 音量が非常に小さい

  1. マイク入力レベルを確認 — ノートテイカーUIのオーディオレベルインジケーターが発話時に動いているか確認。動かない場合は、正しいマイクが選択されていない可能性があります。
  2. オーディオソースを確認 — ノートテイカーUIで正しいマイクとシステム音声ソースが選択されているか確認。
  3. システム音量を確認 — システムの音声出力がミュートされていないか確認。

「録音の読み込みに失敗しました」/ 動画プレビューが再生されない

録音ファイルが破損しているか不完全（録音中にアプリがクラッシュした場合など）の可能性があります。

  1. アプリの録音ディレクトリに録音ファイルが存在することを確認
  2. エクスポートを試す — プレビューが失敗しても、エクスポートは成功する場合があります
  3. ファイルが破損している場合、録音は復元できません

エクスポートが失敗する

エラーメッセージ解決策
「選択したディレクトリに書き込めません」書き込み権限のある別のディレクトリを選択
「エクスポート前に録音を停止してください」進行中の録音を停止してからエクスポート
「生成が完了するまでお待ちください」要約/スライド生成の完了を待つ
「エクスポートするコンテンツがありません」録音を開始して要約を生成してください
「議事録の保存に失敗しました」ディスク容量とフォルダの権限を確認して再試行

文字起こしの品質が悪い

  1. カスタム用語を追加 — ノートテイカーの辞書に専門用語、製品名、技術用語を追加（最大100件）
  2. 音質を改善 — ノートPCのマイクではなく専用マイクを使用。バックグラウンドノイズを軽減。
  3. 言語設定を確認 — 文字起こしの言語が会議の言語と一致しているか確認

クリップボード・スニペット

クリップボード履歴ポップアップが開かない

  1. ショートカットを確認 — デフォルトはCmd+Shift+V（macOS）/ Alt+V（Windows）。IrukaDarkの設定 → ショートカットで確認。
  2. 競合を確認 — 他のクリップボードマネージャー（Paste、CopyClip、Dittoなど）が同じショートカットを使用している可能性。無効化またはリマップしてください。
  3. IrukaDarkを再起動 — クリップボードモニターの再初期化が必要な場合があります。

クリップボードのアイテムが保存されない

IrukaDarkはテキスト最大1000件、画像最大30件を保存します。上限に達すると古いアイテムは自動的に削除されます。クリップボードの監視はアプリ起動時に開始されるため、IrukaDark起動前にコピーされたアイテムは取得されません。

クリップボード履歴からのペーストが動作しない

  • macOS: ペーストのシミュレーションにはアクセシビリティの権限が必要。権限 → アクセシビリティを参照。
  • 一部のアプリはプログラムによるペーストをブロックします。アイテム選択後に手動でCmd+V / Ctrl+Vを試してください。

スニペットのインポートが失敗する

エラーメッセージ解決策
「無効なスニペットファイル形式」IrukaDarkのスニペットエクスポート（JSON形式）である必要があります
「スニペットのインポートに失敗しました」ファイルが破損していないか確認して再試行
「スニペットのエクスポートに失敗しました」ディスク容量と選択したディレクトリの書き込み権限を確認
「エクスポートするスニペットがありません」エクスポート前に少なくとも1つのスニペットを作成

キーボードショートカット

ショートカットがまったく動作しない

  1. ショートカットが無効になっていないか確認 — 設定で「すべてのショートカットを無効化」トグルを確認
  2. macOS: アクセシビリティの権限を付与 — グローバルショートカットの登録に必要
  3. IrukaDarkを再起動 — ショートカットは起動時に登録されるため、再起動で解決できる場合があります
  4. 競合を確認 — 他のアプリが同じショートカットを使用している可能性。よくある原因：画面録画ソフト、クリップボードマネージャー、ウィンドウマネージャー、IDEのグローバルショートカット

「ショートカットの登録に失敗しました。他のアプリと競合している可能性があります。」

別のアプリケーションが同じグローバルショートカットを登録しています。解決するには：

  1. 競合するアプリを特定（アプリを1つずつ閉じて確認）
  2. IrukaDarkの設定でショートカットを変更するか、競合するアプリのショートカットを変更

「このショートカットはシステムで予約されています」

一部のキーの組み合わせはOSに予約されており使用できません。別のショートカットの組み合わせを選択してください。

スリープ復帰後にショートカットが動作しなくなる（macOS）

macOSではスリープ復帰後にグローバルショートカットの登録が解除されることがあります。

  • IrukaDarkを再起動してすべてのショートカットを再登録
  • 頻繁に発生する場合はmacOSのアップデートを確認

US以外のキーボードレイアウトでショートカットが動作しない

IrukaDarkはキーコードベースでショートカットを登録するため、キーボード上の印字と一致しない場合があります。IrukaDarkの設定 → ショートカットで、お使いのキーボードで実際にキーの組み合わせを押して再設定してください。

コンテンツ生成（画像・動画・スライド）

画像生成が失敗する

  1. クレジットを確認 — 各生成リクエストはクレジットを消費します
  2. プロンプトを簡潔に — 非常に複雑なプロンプトは失敗する場合があります。より短く明確な説明にしてみてください。
  3. アスペクト比を確認 — /image statusで現在の設定を確認

動画生成がタイムアウトする

動画生成には数分かかることがあります。10分後にタイムアウトする場合：

  1. 短い時間に変更（/video duration 4で4秒の動画を指定）
  2. プロンプトを簡潔にする
  3. インターネット接続を確認 — 大きな動画ファイルのダウンロードには安定した接続が必要

「スライド生成に失敗しました」/「先に要約を生成してください」

スライド生成には既存の要約が必要です。スライドをリクエストする前に要約を生成してください。要約が存在するのにスライドが失敗する場合は、要約を再生成してからお試しください。

テンプレートのエラー

エラーメッセージ解決策
「テンプレートが見つかりません」テンプレートが削除された可能性があります。テンプレート一覧を確認。
「この名前のテンプレートはすでに存在します」テンプレートに一意の名前を設定
「名前は必須です」テンプレート保存時に名前を入力
「テンプレートの適用に失敗しました」テンプレートデータが破損している可能性。削除して再作成。

URLサマリー

「有効なURLが検出されません」

HTTP または HTTPS の完全なURLが選択されていることを確認してください。部分的なURL、ファイルパス、HTTP以外のプロトコルはサポートされていません。URLにはhttp://またはhttps://が含まれている必要があります。

ウィンドウ操作（macOS）

ウィンドウスナップのショートカットが動作しない

  1. アクセシビリティの権限を確認 — ウィンドウ操作にはアクセシビリティの権限が必要
  2. ショートカットの競合を確認 — ウィンドウ管理アプリ（Rectangle、Magnet、BetterSnapToolなど）がCtrl+Option+矢印キーの組み合わせを使用していることが多い。無効化またはリマップしてください。
  3. マルチモニターの問題 — ウィンドウが予期しないモニターに移動する場合は、Ctrl+Option+N / Ctrl+Option+Pでモニター間を移動

アップデート

「アップデートの確認に失敗しました」

  1. インターネット接続を確認 — アップデート確認にはdl.irukadark.comへのアクセスが必要
  2. ファイアウォール/プロキシ — dl.irukadark.comがネットワークのファイアウォールやプロキシでブロックされていないか確認
  3. 時間をおいて再試行 — アップデートサーバーが一時的に利用できない場合があります

アップデートがダウンロードされたがインストールされない

アップデートのダウンロード後、IrukaDarkは再起動を要求します。プロンプトを閉じてしまった場合：

  • macOS: IrukaDarkを終了（Cmd+Q）して再起動 — 次回起動時にアップデートが適用されます
  • Windows: IrukaDarkを閉じて再度開く — 再起動時にアップデーターがアップデートを適用します

ネットワーク・接続

すべてのAI機能がエラーになる

すべてのAI機能が同時に失敗する場合：

  1. インターネット接続を確認 — AI機能にはアクティブな接続が必要
  2. ファイアウォール/プロキシを確認 — IrukaDarkがAPIサーバーに到達できることを確認。ファイアウォール設定でアプリを許可リストに追加。
  3. 企業ネットワーク — 一部の企業ファイアウォールやプロキシは不明なHTTPSトラフィックをブロックします。IT部門にIrukaDarkの許可を依頼してください。
  4. VPN — VPNを使用している場合は、一時的に切断して原因かどうかテスト

応答が遅い

  1. インターネット速度を確認 — AI機能には安定した接続が必要。非常に遅い接続ではストリーミング応答が途切れることがあります。
  2. リクエストを簡潔に — 長いテキスト選択や複雑なプロンプトは処理に時間がかかります
  3. ピーク時間帯 — ピーク時にはサーバーの応答時間が長くなる場合があります

ここに掲載されていない問題がある場合は、IrukaDarkのWebサイトからサポートにお問い合わせいただくか、問題を報告してください。