Troubleshooting

Solutions to common issues.

Video Won't Play

Symptom: Video file shows in the list but the player stays blank.

• Check the file format. Most common formats (MP4, MOV, MTS, AVI, MKV) are supported. Very old or unusual codecs may not work.
• Check that the file path has no special characters (some versions of libmpv struggle with non-ASCII paths). Try moving the file to a simple path like C:\LapInsight\videos\.
• On Windows, ensure mpv-2.dll (or libmpv.dll) is present in the LapInsight installation folder. Reinstall if missing.

Video File Shows as Missing

The file has been moved, renamed, or the drive is disconnected.

• If the file is on an external drive, reconnect it and reopen LapInsight.
• If the file has been moved, right-click → Relink File and browse to the new location.
• See Missing Video Files for full guidance.

App Is Very Slow on Startup

• If your data root is on a network drive or slow USB, startup scanning takes longer. Move the data root to a local SSD if possible.
• A very large database (thousands of days/sessions) can slow the Session Explorer. Contact support if this becomes a problem.

Session Notes Not Saving

Notes are auto-saved whenever you switch session or close the day. If notes appear lost:

• Check that the data root drive has free space.
• Check that LapInsight has write permission to the data root folder.

Recovering from a Bad Import or Merge

LapInsight auto-creates a backup before every destructive operation (legacy merge, library bundle import, restore in replace mode). To recover:

1. File → Restore from Backup...
2. Pick the most recent entry whose Reason matches what you ran (e.g. pre-bundle-import or pre-merge).
3. Choose Restore as copy (recommended) to inspect the snapshot first, or Replace to swap the live database (which itself takes a fresh backup before swapping).
4. Restart LapInsight after a Replace.

See Backup & Restore for the full mechanics.

Moving to a New Machine

Don't copy LapInsight.db directly between installs — your media paths won't survive the move. Instead:

1. On the source machine: File → Export Library Bundle... with Whole Library scope.
2. Copy the resulting bundle folder to the new machine (any drive, including external).
3. On the new machine: File → Import Library Bundle... and choose the destination data root. Click Preview first to see what will land.

See Library Bundle for scope choices and the preview workflow.

Report Generation Fails

• Ensure at least one section (notes or corner feedback) has content — an empty report may fail.
• Check that there is disk space available at the export destination.
• If publishing to the cloud fails, check your internet connection and re-sign in via Settings → Publishing.

Corner Feedback Shows No Corners

Corners must be defined in the Track Editor for the current track.

• Go to Tools → Corner Editor and add corners for the track.
• See Defining Corners.

OCR Not Working

• Tesseract must be installed separately. See Searching Documents.
• Confirm Tesseract is in your system PATH or set the path in Settings → Documents.

The App Won't Start

• On Windows, check the Windows Event Viewer for a crash reason.
• Try launching from a command prompt to see error output: LapInsight.exe in the installation folder.
• Check that your antivirus is not blocking mpv-2.dll or the LapInsight executable.
• As a last resort, delete the config folder and restart (data is not lost):

- Windows: %LOCALAPPDATA%\LapInsight\ - macOS: ~/Library/Application Support/LapInsight/

Getting Further Help

If these steps don't resolve your issue, contact support at support@lapinsight.app with a description of the problem and any error messages you see.