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

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

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

よくある問題と解決方法

インポート関連

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

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

考えられる原因:

解決方法（段階的）:

ステップ1: 監視機能の確認

  1. ゲーム側設定を開く
  2. トグルスイッチが「有効（オン）」になっているか確認
  3. 無効になっている場合は、クリックして有効化
  4. VRChatでスクリーンショットを撮影

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

  1. ゲーム側設定を開く
  2. 「スクリーンショットフォルダ」を確認
  3. 通常はC:\Users\[ユーザー名]\Pictures\VRChat
  4. 正しいパスか確認し、必要に応じて再選択

ステップ3: VRChatの確認

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

ステップ4: ファイアウォールの確認

  1. Windowsセキュリティセンターを開く
  2. 「ファイアウォールと保護」をクリック
  3. 「ファイアウォールによるアプリケーションの許可」をクリック
  4. VSAが許可リストに含まれているか確認
  5. 含まれていない場合は「別のアプリを許可」から追加

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

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

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

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

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

考えられる原因:

解決方法（段階的）:

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

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

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

  1. ギャラリーを上下にスクロール
  2. スクロール時に動的にサムネイルが読み込まれます
  3. ネットワーク接続を確認（外部ストレージの場合）

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

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

ステップ4: キャッシュのクリア

  1. VSAを終了
  2. 以下のフォルダを削除: 
    %APPDATA%/VSA/cache/
  3. VSAを再起動
  4. サムネイルが再生成されます（時間がかかる場合があります）

ステップ5: データベースの再構築

  1. 開発者モードを有効化（設定 > 外観 > 開発者モード）
  2. サイドバーに「開発者」メニューが表示
  3. 「開発者」をクリック
  4. 「データベースを再構築」をクリック
  5. 確認ダイアログで「OK」を選択
  6. VSAを再起動

注意: データベース再構築すると、お気に入りタグなどが失われる可能性があります。

ギャラリー表示関連

ギャラリーの動作が重い

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

考えられる原因:

解決方法（優先度順）:

対策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. 「総写真数」を確認
  4. 0の場合、ファイアウォールがブロックしている可能性

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: ビューアーがJXLに対応していない

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

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

VRChat連携関連

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

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

考えられる原因:

解決方法（段階的）:

ステップ1: メタデータ出力フォルダを確認

  1. ゲーム側設定を開く
  2. 詳細設定を展開
  3. 「メタデータ出力フォルダ」が設定されているか確認
  4. 設定されていない場合は、VRChatのログフォルダを指定

ステップ2: VRChat側の設定を確認

  1. VRChatの設定メニューを開く
  2. メタデータ出力が有効か確認
  3. 無効の場合は有効化
  4. VRChatを再起動

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

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

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

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

OSC通信が確立できない

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

考えられる原因:

解決方法（段階的）:

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

  1. ゲーム側設定を開く
  2. 詳細設定を展開
  3. 「OSCポート」を確認（デフォルト: 9001）
  4. VRChat側の設定でも同じポート番号が設定されているか確認

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

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

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

  1. Windowsセキュリティセンターを開く
  2. 「ファイアウォールと保護」をクリック
  3. 「詳細設定」をクリック
  4. 「受信の規則」と「送信の規則」で、OSCポート（9001など）が許可されているか確認
  5. 許可されていない場合は、新しい規則を追加

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

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

ステップ5: VSAの再起動

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

VRChat起動が検出されない

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

考えられる原因:

解決方法:

ステップ1: 監視機能の有効確認

  1. ゲーム側設定を開く
  2. トグルスイッチが有効（オン）か確認

ステップ2: VRChatを再起動

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

アカウント連携・クラウド保存関連

クラウド保存が失敗する、または利用できない

症状: お気に入りのクラウド保存に失敗する、メニューが表示されない、またはエラーになる

考えられる原因:

解決方法（段階的）:

ステップ1: ロールアウトとプランを確認

  1. アカウント画面でプランと連携状態を確認
  2. クラウド保存メニューが無い場合、未提供の可能性がある
  3. 利用規約とアプリ内の料金・上限表示を確認

ステップ2: ネットワーク接続を確認

  1. Windowsのネットワークアイコンを確認
  2. インターネット接続が正常か確認
  3. 接続できない場合は、Wi-Fiルーターを再起動

ステップ3: 認証状態を確認

  1. アカウント設定を開く
  2. 連携状態を確認
  3. 案内に従いログアウト後、再度サインイン

ステップ4: ローカルバックアップを維持

  1. %APPDATA%/VSA/favorites.db を定期的にコピー
  2. クラウド保存に単独で依存しない

認証エラーが発生する

症状: アカウント連携時に「認証に失敗しました」などのエラーが表示される

考えられる原因:

解決方法（段階的）:

ステップ1: ブラウザのキャッシュをクリア

  1. ブラウザを開く（Chrome推奨）
  2. Ctrl + Shift + Delete
  3. 「キャッシュされた画像とファイル」をチェック
  4. 「閲覧履歴を削除」をクリック

ステップ2: ポップアップブロックを確認

  1. ブラウザのアドレスバー左側のアイコンを確認
  2. ポップアップがブロックされている場合は許可

ステップ3: 別のブラウザで試す

  1. 別のブラウザ（EdgeやFirefoxなど）で試す
  2. 認証成功するか確認

ステップ4: VSAアプリを再起動

  1. VSAを完全に終了
  2. 数秒待機
  3. VSAを再起動して再度連携を試す

通知関連

通知が表示されない

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

考えられる原因:

解決方法（段階的）:

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

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

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

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

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

  1. VSAの設定を開く
  2. 「通知」パネルを選択
  3. 「デスクトップ通知」が有効か確認
  4. 個別の通知種別が有効か確認

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

  1. Windowsの音量ミキサーを確認
  2. VSAアプリがミュートされていないか確認
  3. マスターボリュームを確認

パフォーマンス関連

アプリの起動が遅い

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

考えられる原因:

解決方法（優先度順）:

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

  1. ギャラリーで古い写真を選択
  2. 削除ボタンをクリック
  3. データベースサイズが削減されます
  4. 起動速度が改善するか確認

対策2: ディスクの最適化

  1. Windowsの設定を開く
  2. 「ストレージ」をクリック
  3. 「ドライブの最適化」をクリック
  4. ドライブを選択して「最適化」をクリック

対策3: SSDにインストール

メモリ使用量が多い

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

考えられる原因:

解決方法（優先度順）:

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

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

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

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

対策3: アプリを再起動

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

対策4: キャッシュをクリア

  1. VSAを終了
  2. 以下のフォルダを削除: 
    %APPDATA%/VSA/cache/
  3. VSAを再起動

ログファイルの確認方法

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

ログファイルの場所

%APPDATA%/VSA/logs/

ショートカット:

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

ログファイルの構成

ログファイルは日付ごとに生成されます：

logs/
├── 2024-01-10.log
├── 2024-01-09.log
└── 2024-01-08.log

最新のログファイルを開く: 今日の日付のファイルを開きます。

ログファイルの読み方

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

ログレベルの見方:

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

エラーの確認方法:

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

例:

[2024-01-10 14:32:15] [ERROR] Failed to connect to screenshot folder: Access Denied

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

データベースの再構築

データベースが破損した場合、再構築できます。

注意: 再構築すると、お気に入りタグなどのカスタムデータが失われる可能性があります。事前にバックアップを取ってください。

手順

ステップ1: 開発者モードを有効化

  1. 設定を開く
  2. 「外観」パネルを選択
  3. 「開発者モード」を有効化
  4. 「保存」をクリック

ステップ2: 開発者メニューを開く

  1. サイドバーに「開発者」メニューが表示される
  2. 「開発者」をクリック

ステップ3: データベースを再構築

  1. 「データベースを再構築」ボタンを探す
  2. クリック
  3. 確認ダイアログで「再構築」を選択

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

  1. VSAが自動的に再起動
  2. データベース再構築が完了します

ステップ5: 確認

  1. ギャラリーを表示
  2. 写真が正常に表示されるか確認

設定ファイルのリセット

設定ファイルが破損した場合、リセットできます。

警告: リセット後は、すべての設定がデフォルトに戻ります。重要な設定は事前にメモしてください。

手順

ステップ1: VSAを終了

  1. VSAを完全に終了
  2. 全VSAプロセスが終了しているか確認（タスクマネージャーで確認）

ステップ2: 設定ファイルを削除

  1. Windowsキー + R
  2. %APPDATA%と入力してEnter
  3. VSAフォルダを開く
  4. settings.jsonファイルを削除

ステップ3: VSAを再起動

  1. VSAを起動
  2. セットアップウィザードが表示される
  3. 初期設定を再度実施

バックアップの作成方法:

  1. VSAを終了
  2. %APPDATA%/VSA/settings.jsonをコピー
  3. 安全な場所にsettings.json.backupとして保存

バックアップから復元:

  1. settings.json.backupを%APPDATA%/VSA/フォルダにコピー
  2. settings.jsonにリネーム
  3. VSAを再起動

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

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

問い合わせに必要な情報

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

1. 環境情報:

2. 問題の詳細:

3. エラーメッセージ:

4. ログファイル:

問い合わせ先

GitHub Issues:

メール:

関連情報