자주 발생하는 문제

프리뷰가 안 뜨거나 SignalR이 끊겼다면 90 %는 보안소프트·포트·코덱 문제입니다.

편집기 창이 안 열려요

  • Bom.Ag 자체가 실행 중인지 확인 (시스템 트레이 아이콘)
  • Kestrel 포트 충돌 — Bom.Ag 로그에서 "VideoEditorHost listening on" 라인 확인
  • 방화벽 / 안티바이러스가 localhost 연결을 차단하는지 확인
로그 위치

~/.bom/logs/agent-*.log 에서 VideoEditorHost 키워드로 검색하세요.

연결 상태 dot이 회색 / 빨간색이에요

SignalR `/editor` 허브가 끊긴 상태입니다.

  1. 툴바의 ↻ 새로고침 버튼을 누릅니다.
  2. 여전히 안 되면 브라우저 탭을 닫고 Bom.Ag 채팅에 "영상 편집 시작"을 다시 입력합니다.
  3. Bom.Ag를 완전히 종료하고 다시 실행합니다.

프리뷰가 까맣게만 나와요

  • 코덱 미지원 — HEVC(H.265) 원본은 일부 Windows에서 미리보기 불가. 입력 클립을 H.264로 사전 변환
  • DOM ↔ WebGL 토글 시도 — 그래픽 드라이버 이슈 회피
  • 그래픽 드라이버 업데이트

자동 더킹이 동작 안 해요

  • whisper.cpp 모델 다운로드 확인 — ~/.bom/runtimes/whisper/models/ 에 .bin 파일이 있는지
  • 오디오 트랙 샘플레이트가 16 kHz 이상인지
  • Threshold 값을 -25 dB로 낮춰 재시도

내보내기가 멈춰요

FFmpeg 로그를 먼저 확인합니다.

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

# macOS
cat ~/.bom/logs/bom-av-latest.log
재시작

Bom.Ag 채팅에 "bom-av 재시작"을 입력하면 백엔드 프로세스만 재시작됩니다.

타임라인이 사라졌어요

자동 백업 폴더를 확인하세요.

bash
# 백업 파일 목록
ls ~/.bom/timelines/.backup/

가장 최근 파일을 ~/.bom/timelines/ 로 복사하면 편집기가 자동으로 다시 읽습니다.

로그 모으기 (지원 요청용)

문제 해결이 안 될 때 다음 파일을 압축해 보내주세요.

  • ~/.bom/logs/agent-*.log
  • ~/.bom/logs/bom-av-*.log
  • ~/.bom/timelines/<project>.json
  • OS / Bom.Ag 버전 (Settings → 정보)
이전 내보내기 다음 Worker