Troubleshooting

❓ App doesn't start

Symptoms: nothing happens, or a crash occurs when launching.

✅ Fixes:

• make sure you're running the correct build (x64)
• ensure .NET Framework 4.8 or later is installed
• run as Administrator if video / image can't be saved / read

❌ FFmpeg not found

• Symptoms: "FFmpeg not found" or "Could not start process" error.

✅ Fixes:

• ensure ffmpeg.exe exists and is in your system PATH, or
• manually set the ffmpeg_path variable to the full path (default path: C:\\ffmpeg\\bin\\ffmpeg.exe)

🖼 Images not loading / preview is blank

Symptoms: image is selected, but nothing shows in the UI.

✅ Fixes:

• only .png and .jpg images are supported
• avoid filenames with special characters or paths with %20 — they may need to be decoded using Uri.UnescapeDataString
• ensure the file isn't locked by another process

🎞 Videos not playing or analyzing

Symptoms: video fails to load, or the preview stays black.

✅ Fixes:

• install LibVLCSharp.WinForms and copy the libvlc binaries (libvlc.dll, etc.) to your build folder
• supported formats: .mp4, .mkv, .avi
• check that audio / video codecs aren't too exotic (use standard H.264 / AAC)

📊 Excel file not created

Symptoms: excel report missing or corrupt.

✅ Fixes:

• ensure ClosedXML is installed via NuGet
• output path must be writable — avoid restricted folders
• make sure no Excel instance is locking a previous version of the file

🐞 Still Stuck?

• open an Issue
• check the Wiki