Development

Project Shape

vidbgm/
  Cargo.toml
  src/
    lib.rs
    main.rs
  desktop/
    package.json
    src/
    src-tauri/
  tools/
    eval_vision_prompts.py
  docs/

The root Rust crate owns the CLI and shared orchestration. The desktop app calls shared Rust functions through Tauri commands.

Rust Checks

cargo test

cargo build

Desktop Checks

cd desktop
pnpm build

cd desktop
pnpm tauri dev

Debug Tauri builds create local FFmpeg/FFprobe wrappers that forward to ffmpeg and ffprobe on PATH, so development and tests do not require committing media binaries. Release packaging requires real sidecar binaries:

cd desktop
VIDBGM_FFMPEG=/path/to/ffmpeg \
VIDBGM_FFPROBE=/path/to/ffprobe \
pnpm prepare:ffmpeg-sidecars

Docs Checks

Install docs dependencies from the repo root:

pnpm install

Run the docs site:

pnpm docs:dev

Build the static docs:

pnpm docs:build

Generated VitePress output stays out of git:

• docs/.vitepress/dist/
• docs/.vitepress/cache/

Vision Prompt Eval

Use the local QAT model to compare frame-analysis prompt variants:

python3 tools/eval_vision_prompts.py \
  --video sample-video.mov \
  --model google/gemma-4-12b-qat \
  --max-frames 4 \
  --duration 240 \
  --out-dir output/vision-prompt-eval-v3

The eval writes results.csv, raw_results.json, and summary.json.