Splitsmith Pipeline Quickstart GitHub
Project Register Vol. 01 · Ed. 04

Splits from your stage video.

Per-shot splits for analysis and coaching, and frame-marked clips ready for match-footage review. Your head-mounted cam already captures audio of every shot; Splitsmith turns it into per-shot times, a CSV of splits, and an FCPXML timeline with frame-aligned markers you can pop open in Final Cut Pro and step through on M / Shift+M. The RO's timer only records your total stage time — the splits live in your video, and this is how you get them out.

01

Pipeline

Step 01

Ingest

Drop a folder of head-cam clips. The engine auto-matches them to stages by file timestamp.

Step 02

Beep

Auto-snap to the start beep on each stage. Low-confidence detections land in a review queue.

Step 03

Audit

Waveform + per-shot markers from a 3-voter ensemble. Click a marker to inspect votes. Drag to fine-tune.

Step 04

Export

Per-stage or whole-match FCPXML. Open in Final Cut Pro, navigate with M / Shift+M.

02

What goes in. What comes out.

Inputs

Raw match material

  • .MP4Head-mounted cam footage (e.g. Insta360 Go 3S)
  • .JSONStage timing data from SSI Scoreboard
Outputs · per stage

Reviewable training data

  • _trimmed.mp4Lossless cut around the start beep
  • _splits.csvPer-shot splits — the editable source of truth
  • .fcpxmlFinal Cut Pro timeline with frame-aligned markers
  • _report.txtAnomaly report — overshoots, echoes, low confidence
03

Quickstart

# Clone, sync, build the UI $ git clone https://github.com/mandakan/splitsmith.git $ cd splitsmith $ uv sync $ (cd src/splitsmith/ui_static && pnpm install && pnpm build) # Run the full ingest → audit → export workflow $ uv run splitsmith ui --project ~/matches/your-match