ScoutCode

ScoutCode is a Windows-first, local-first football (soccer) video analysis workstation.

This repository currently implements the M0-M2 vertical slice:

• Electron desktop shell with a safe preload API.
• React + TypeScript + Vite renderer.
• Local .scoutcode project folders with project.json, project.sqlite, media folders, exports, backups, and logs.
• SQLite persistence for projects, media assets, events, default templates, template buttons, and settings.
• Video import in copy/link mode, local media protocol playback, and optional ffprobe metadata probing.
• Default football coding template, keyboard shortcuts, event creation/editing/soft delete, phase filtering, and timeline selection.

Scripts

npm run desktop:dev
npm run typecheck
npm run lint
npm run test
npm run build
npm run smoke:electron

npm run desktop:dev starts Vite and then opens Electron. The renderer can also be viewed with npm run dev, but real project, media, and SQLite behavior requires Electron.

MVP Boundary

Windows installer packaging and full video export are intentionally left as M3+ work in this slice.

License

Apache-2.0. See LICENSE.

Video export (M3)

ScoutCode supports video exports from a single coded event and from playlists.

• Supported output formats: mp4 (default), mov, webm.
• Export variants:
  • single clip export (video_clip) with optional pre/post roll
  • playlist montage export (video_playlist) by concatenating ordered playlist clips
  • optional overlay burn-in (annotation banner via ffmpeg filter graph)
• Job tracking is persisted in export_jobs with status, progress, selected format, generated ffmpeg args, output duration, and error message when failures occur.

ffmpeg requirement

ffmpeg must be installed and available on the system PATH for desktop export actions.

Operator workflow

1. Open project and import source media.
2. Code events and optionally group them into a playlist.
3. Use 导出片段 for selected event clip export, or use 导出视频 in playlist panel.
4. Check export job status/progress in the playlist panel export job summary.