トラブルシューティング詳細ガイド

🏠 ドキュメントトップ ⚖️ 利用規約 🔒 プライバシーポリシー

VSAアプリで問題が発生した場合の解決方法をまとめています。段階的に問題解決を進められるように、具体的な症状と解決方法を記載しています。

よくある問題と解決方法

インポート関連

写真が自動インポートされない

症状: VRChatで写真を撮影しても、VSAに自動的にインポートされない

考えられる原因:

解決方法（段階的）:

ステップ1: 監視状態の確認

  1. VSAを起動したままにする
  2. サイドバーにフォルダ監視中の状態が表示されるか確認
  3. VRChatでスクリーンショットを撮影

ステップ2: フォルダパスの確認

  1. ゲーム関連設定 > 画面設定を開く
  2. 「監視元フォルダ」を確認
  3. 通常はC:\Users\[ユーザー名]\Pictures\VRChat
  4. 正しいパスか確認し、必要に応じて再選択

ステップ3: VRChatの確認

  1. VRChatでスクリーンショットが実際に撮影されているか確認
  2. Windowsのエクスプローラーで、指定フォルダに写真ファイルがあるか確認
  3. ファイル名と撮影時刻が一致しているか確認

ステップ4: アプリの再起動

  1. VSAを完全に終了
  2. VRChatも終了
  3. VSAを再起動
  4. VRChatを起動
  5. スクリーンショットを撮影

それでも解決しない場合: ログファイルの確認を参照して、詳細なエラーを確認してください。

サムネイルが表示されない

症状: ギャラリーでサムネイルが灰色のまま表示される、または画像が表示されない

考えられる原因:

解決方法（段階的）:

ステップ1: 処理完了まで待機

  1. ギャラリーを表示
  2. 画面上部の「処理中…」インジケーターを確認
  3. インジケーターが消えるまで待機（数分かかる場合があります）

ステップ2: スクロール操作を試す

  1. ギャラリーを上下にスクロール
  2. スクロール時に動的にサムネイルが読み込まれます

ステップ3: アプリの再起動

  1. VSAを完全に終了
  2. 数秒待機
  3. VSAを再起動
  4. ギャラリーを表示

ステップ4: ログを添えて問い合わせ 改善しない場合は、ログと再現手順を添えて問い合わせてください。

ギャラリー表示関連

ギャラリーの動作が重い

症状: 写真の表示やスクロールが遅い、フリーズすることがある

考えられる原因:

解決方法（優先度順）:

対策1: サムネイルサイズを縮小

  1. ギャラリーを表示
  2. ツールバーのズームスライダーを左にドラッグ
  3. サムネイルサイズを小さくします
  4. スクロール速度が改善されるか確認

対策2: アニメーションを無効化

  1. 設定を開く
  2. 「アニメーション」パネルを選択
  3. アニメーション効果を無効化
  4. 画面エフェクトが軽くなります

対策3: 不要な写真を削除

  1. ギャラリーで不要な写真を選択
  2. 削除ボタンをクリック
  3. 総ファイル数が減ると、処理負荷が軽減

対策4: アプリを再起動

  1. VSAを完全に終了
  2. 数秒待機
  3. VSAを再起動
  4. メモリがリセットされます

対策5: PCのメモリを確認

  1. タスクマネージャーを開く（Ctrl + Shift + Esc）
  2. 「パフォーマンス」タブをクリック
  3. メモリ使用率を確認
  4. 90%以上の場合は、PC自体のメモリ不足です
  5. 他のアプリケーションを閉じてください

写真が表示されない

症状: ギャラリーに何も表示されない、または「写真がありません」と表示される

考えられる原因:

解決方法（段階的）:

ステップ1: インポートフォルダを確認

  1. ゲーム関連設定 > 画面設定を開く
  2. 「監視元フォルダ」パスを確認
  3. Windowsエクスプローラーでそのフォルダを開く
  4. 写真ファイルが存在するか確認（.pngまたは.jpgファイル）

ステップ2: インポート処理を確認

  1. インポートフォルダビューを開く
  2. 処理中のインジケーターを確認
  3. インジケーターが消えるまで待機

ステップ3: 手動リロード

  1. ギャラリーを表示
  2. ツールバーの「リロード」ボタン（⟲）をクリック
  3. 写真一覧を再読み込み

ステップ4: 設定とログを確認

  1. ゲーム関連設定 > 画面設定で監視元フォルダを確認
  2. 新しい写真を撮影し、取り込みが完了するまで待つ
  3. 改善しない場合はログと症状を添えて問い合わせる

JXL圧縮関連

圧縮が開始されない

症状: 自動アーカイブを有効にしても古い写真が処理されない

考えられる原因:

解決方法（段階的）:

ステップ1: 自動アーカイブの有効確認

  1. JXL圧縮画面を開く
  2. 自動アーカイブが有効か、対象月数が適切か確認

ステップ2: 保存先と問題状態の確認

  1. 写真出力先とその配下の VSA-Archive に読み書きできるか確認
  2. 十分な空き容量があるか確認
  3. アーカイブ管理画面の「問題あり」から処理を再試行

ステップ3: 手動で圧縮を実行

  1. JPEG XL圧縮ビューを開く
  2. 「フォルダを選択」から圧縮対象フォルダを選択
  3. 「圧縮を実行」ボタンをクリック
  4. 手動実行で動作するか確認

圧縮後に画質が劣化する

症状: JPEG XL圧縮後、画像が破損したり、色が変わったりする

解決方法:

VSAのJPEG XL圧縮はロスレス（可逆）圧縮のため、画質は劣化しません。以下の原因が考えられます：

原因1: 元の画像が既に圧縮されている

原因2: ファイルが破損している

  1. 詳細ログを確認（開発者モード）
  2. エラーがある場合は、圧縮をやり直す
  3. 同じエラーが発生する場合は、元のファイルが破損している可能性

VRChat連携関連

メタデータが取得できない

症状: 写真のワールド名、ユーザー名、撮影日時などが表示されない

考えられる原因:

解決方法（段階的）:

ステップ1: ログフォルダを確認

  1. ゲーム関連設定 > 画面設定を開く
  2. 「ログフォルダ」がVRChatのログフォルダを指しているか確認

ステップ2: VRChatログを確認

  1. VRChatを起動してワールドへ移動
  2. C:\Users\[ユーザー名]\AppData\LocalLow\VRChat\VRChat にログが作成されるか確認
  3. ログがない場合はVRChatを再起動

ステップ3: ログフォルダの確認

  1. ゲーム関連設定で表示されているログフォルダパスを確認
  2. Windowsエクスプローラーでそのフォルダを開く
  3. output_log_*.txtなどのログファイルが存在するか確認
  4. 存在しない場合は、ログフォルダパスを再設定

ステップ4: 新しいスクリーンショットを撮影

  1. すべての設定が完了してから、新しくスクリーンショットを撮影
  2. 既存の写真にはメタデータが付与されません
  3. 新しい写真にメタデータが付与されるか確認

OSC通信が確立できない

症状: カメラパラメータ（VirtualLens2など）が取得できない

考えられる原因:

解決方法（段階的）:

ステップ1: ポート番号の確認

  1. ゲーム関連設定 > 画面設定を開く
  2. 「VSA受信ポート（VRChat送信）」を確認（デフォルト: 9001）
  3. 「VSA送信ポート（VRChat受信）」を確認（デフォルト: 9000）
  4. VRChat側の送信先・受信側ポートと対応しているか確認

ステップ2: VRChat側でOSCを有効化

  1. VRChatを起動
  2. 設定メニューを開く
  3. 「OSCを有効にする」をチェック
  4. VRChatを再起動

ステップ3: ファイアウォール設定を確認

  1. Windowsセキュリティセンターを開く
  2. 「ファイアウォールと保護」をクリック
  3. 「詳細設定」をクリック
  4. VSAまたはVRChatの通信がブロックされていないか確認
  5. 通信がブロックされている場合は、ログと症状を添えて問い合わせてください

ステップ4: ポート番号の競合を確認

  1. コマンドプロンプトを開く（Windows + R → cmd）
  2. 以下のコマンドを実行: 
    netstat -ano | findstr ":9001 :9000"
  3. 他のプロセスがポートを使用していないか確認
  4. 使用している場合は、別のポート番号に変更

ステップ5: VSAの再起動

  1. VSAを完全に終了
  2. 数秒待機
  3. VSAを再起動
  4. VRChatでカメラを使用

VRChat起動が検出されない

症状: VRChatを起動しても、VSAが検出しない（通知が表示されない）

考えられる原因:

解決方法:

ステップ1: 監視状態の確認

  1. VSAを起動したままにする
  2. サイドバーのフォルダ監視状態を確認

ステップ2: VRChatを再起動

  1. VRChatを完全に終了
  2. VSAも再起動
  3. VRChatを起動

アカウント・クラウドの項目が表示されない

アカウント・クラウド保存・X投稿・イベント撮影は一般提供の準備中で、通常設定では表示されません。メニューがないことだけで通信障害とは判断しないでください。ローカル写真管理はアカウントなしで利用できます。大切な写真は別媒体にもバックアップしてください。

通知関連

通知が表示されない

症状: 設定では通知が有効になっているが、デスクトップ通知が表示されない

考えられる原因:

解決方法（段階的）:

ステップ1: Windows通知設定を確認

  1. Windowsの設定を開く（Windows + I）
  2. 「システム」をクリック
  3. 「通知」をクリック
  4. VSAが許可リストに含まれているか確認
  5. 含まれていない場合は、「許可されたアプリ」から追加

ステップ2: 集中モードを確認

  1. Windowsのアクションセンター（Win + A）を開く
  2. 「集中モード」が「オン」になっていないか確認
  3. オンの場合はオフに切り替え

ステップ3: 通知設定を確認

  1. VSAの設定を開く
  2. 「通知」パネルを選択
  3. 「OS通知」または「トースト通知」が有効か確認
  4. 個別の通知種別が有効か確認

ステップ4: 通知音を確認

  1. 設定 > 通知で「通知音を再生」が有効か確認
  2. Windowsの通知音とVSAアプリがミュートされていないか確認

パフォーマンス関連

アプリの起動が遅い

症状: VSAの起動に数十秒以上かかる

考えられる原因:

解決方法（優先度順）:

対策1: 不要な写真を削除

  1. ギャラリーで古い写真を選択
  2. 削除ボタンをクリック
  3. 処理対象を減らします
  4. 起動速度が改善するか確認

メモリ使用量が多い

症状: VSAのメモリ使用量が増加し続ける、またはPCが遅くなる

考えられる原因:

解決方法（優先度順）:

対策1: サムネイルサイズを小さくする

  1. ギャラリーを表示
  2. ズームスライダーを左にドラッグ
  3. サムネイルサイズを縮小
  4. メモリ使用量が削減されるか確認

対策2: 詳細サイドバーを閉じる

  1. 開いている写真詳細を閉じる
  2. メモリ使用量が削減されるか確認

対策3: アプリを再起動

  1. VSAを完全に終了
  2. 数秒待機
  3. VSAを再起動
  4. メモリがリセットされます

ログファイルの確認方法

VSAの詳細なログを確認することで、問題の原因をより正確に特定できます。

ログファイルの場所

%APPDATA%/VSA/logs/

ショートカット:

  1. Windowsキー + R
  2. %APPDATA%と入力してEnter
  3. VSAフォルダをダブルクリック
  4. logsフォルダをダブルクリック

ログファイルの構成

ログファイルは日次でローテーションされます：

logs/
├── vsa-mainapp.log
└── vsa-mainapp.log.2026-08-31

最新のログファイルを開く: vsa-mainapp.logを開きます。

ログファイルの読み方

ログファイルはテキストファイルです。メモ帳やVSCodeで開くことができます。

ログレベルの見方:

ログレベル 記号 意味
ERROR [ERROR] 重大なエラー（問題が発生している）
WARN [WARN] 警告（注意が必要）
INFO [INFO] 通常の情報（参考情報）
DEBUG [DEBUG] デバッグ情報（開発者向け）

エラーの確認方法:

  1. テキストエディタで最新のログファイルを開く
  2. Ctrl + F で「ERROR」を検索
  3. エラーメッセージを確認
  4. エラーメッセージに基づいて対処

例:

ERROR Failed to connect to screenshot folder: Access Denied

このエラーは、スクリーンショットフォルダへのアクセス権限がないことを示しています。

管理データや設定に問題がある場合

アプリの管理データや設定を手動で削除・置換・再構築する手順は、現在の公開版では提供していません。操作を誤ると写真やお気に入りの状態を失う可能性があります。

  1. VSAを完全に終了して再起動する
  2. 監視元・出力先・ログフォルダの権限と空き容量を確認する
  3. 改善しない場合は、ログ、VSAバージョン、再現手順を添えて問い合わせる

サポートへの問い合わせ方法

上記の解決方法で問題が解決しない場合、サポートに問い合わせることができます。

問い合わせに必要な情報

以下の情報をまとめて提供してください：

1. 環境情報:

2. 問題の詳細:

3. エラーメッセージ:

4. ログファイル:

問い合わせ先

GitHub Issues:

メール:

関連情報