Troubleshooting

A black preview or a dropped SignalR connection is usually security software, a port conflict, or a codec issue.

The editor window does not open

  • Make sure Bom.Ag itself is running (check the system tray).
  • Kestrel port conflict — search Bom.Ag logs for "VideoEditorHost listening on".
  • Firewall or anti-virus blocking localhost connections.
Log location

Search ~/.bom/logs/agent-*.log for "VideoEditorHost".

Connection dot is grey or red

The SignalR `/editor` hub has dropped.

  1. Press the ↻ refresh button in the toolbar.
  2. Still failing? Close the browser tab and chat "start a video edit" in Bom.Ag again.
  3. Last resort — quit and restart Bom.Ag.

The preview is completely black

  • Unsupported codec — HEVC (H.265) sources do not preview on some Windows builds. Convert the source to H.264 first.
  • Toggle DOM ↔ WebGL to dodge GPU driver bugs.
  • Update your graphics driver.

Auto-ducking is silent

  • Confirm the whisper.cpp model exists in ~/.bom/runtimes/whisper/models/ as a .bin file.
  • Ensure the audio track is at least 16 kHz sample rate.
  • Lower the Threshold to -25 dB and retry.

Export is stuck

Check the FFmpeg log first.

bash
# Windows
type %USERPROFILE%\.bom\logs\bom-av-latest.log

# macOS
cat ~/.bom/logs/bom-av-latest.log
Restart

Chat "restart bom-av" in Bom.Ag to restart the backend only.

My timeline disappeared

Check the auto-backup folder.

bash
# List backup files
ls ~/.bom/timelines/.backup/

Copy the most recent file back into ~/.bom/timelines/ and the editor reloads it.

Collecting logs for support

When in doubt, bundle these and reach out.

  • ~/.bom/logs/agent-*.log
  • ~/.bom/logs/bom-av-*.log
  • ~/.bom/timelines/<project>.json
  • OS and Bom.Ag version (Settings → About)
Previous Export Next Worker