Sports Vision / Updated May 11

FormFix

A basketball shot analyzer that turns a single video upload into phase-segmented mechanics feedback, keyframes, and annotated overlay footage.

Creator2026PythonVision prototype

What this project proves

The point is not to detect joints. The point is to explain exactly why the jumper broke.

FormFix treats coaching as a vision pipeline. It extracts body and hand landmarks, segments the shot into load, set, rise, release, and follow-through, compares timing and angles against research baselines, then returns issues a player can actually correct.

README capture
Surface proof
FormFix README section showing the analysis pipeline and API response.

README capture

The pipeline is concrete: upload a clip, segment the shot into five phases, detect mechanics issues, and return keyframes plus an annotated video payload.

75

Tracked points

33 body landmarks plus 21 hand landmarks per side

5

Shot phases

load through follow-through segmentation

15fps

Frame sampling

frames are extracted before pose and phase analysis

01

Motion extraction

The backend turns ordinary phone video into structured movement data quickly enough to support real feedback.

  • MediaPipe Holistic extracts body and hand landmarks frame by frame
  • Supports front, side, and diagonal camera angles
  • OpenCV overlay output makes the tracking inspectable instead of opaque
02

Phase segmentation

The system does not analyze the jumper as one blur. It breaks the motion into the moments coaches actually care about.

  • Load, set, rise, release, and follow-through are detected automatically
  • Knee angle, wrist height, and wrist velocity drive the segmentation cues
  • Wrist flexion angle and speed become explicit flick signals
03

Feedback surface

The output is designed for correction, not novelty. The project translates raw motion into something a player or coach can act on after one upload.

  • Flags issues like shallow knee bend, weak wrist snap, and short follow-through
  • Returns keyframes, issues, confidence notes, and optional annotated video
  • Grounds thresholds in biomechanics references instead of arbitrary heuristics