Annotations, AI coach, and tracked-surfer assignment
Reviewing Sessions
The session viewer (/sessions/[id]) is where coaching happens. This guide covers the layout and the four core tasks: annotating, scoring rides, generating AI feedback, and assigning tracked surfers.
Sessions list
Open Sessions (/sessions) to see all your sessions.
- Filter with the status pills All / complete / processing / uploading / failed and toggle the Date sort.
- Each card shows status, date, duration, and surfer count. Click to open; hover to reveal a delete (trash) action.
Session viewer layout
From top to bottom you'll see:
- A Back to Sessions link, then the title, spot, date, and status.
- Athlete chips -- who's in the session (and unassigned AI-tracked surfers).
- A processing indicator (while clips are still analyzing).
- The video player.
- Clip pills to switch between clips, plus + Add Clips.
- Two collapsible sections: AI Coach and Session Info.
Annotations are not one of the collapsible sections -- they're created from the video control bar and displayed in a slide-in drawer (see below).
Player keyboard shortcuts
Space play/pause · arrow keys seek/step · J/K/L speed · F fullscreen · , and . step a single frame.
Add annotations
Annotations are anchored to a timestamp and created from the buttons in the video control bar:
- Text note -- click the note button, type your coaching note, and click Add Note (Enter also submits).
- Drawing -- click the draw button; the video pauses and a drawing canvas opens so you can sketch on the frame, then save.
- Voice -- click the voice button, then Start Recording and Stop & Save.
Open the annotation drawer from the right-edge tab or the annotation-count pill. It lists every annotation with filter tabs All / Text / Drawing / Voice, timestamps, and a per-item delete. Markers appear on the seek bar -- click one to jump there and open the drawer.
Generate AI coaching feedback
Open the AI Coach section:
- Multi-clip sessions: click Analyze All Clips + Generate Session Summary. Per-clip status pills show which clips are analyzed.
- Single clip: click Generate AI Coaching Analysis.
Once analysis exists, sub-tabs appear: Session Overview / Clip Analysis (or Coach Summary) / Strengths / Improve / Wave Notes / Key Moments / Compare Clips / Raw Stats. Every strength, improvement, and key moment has a timestamp button that seeks the video to that moment.
From the session summary you can Regenerate all, open View Report (an HTML coaching report), or Export JSON. Individual panels each have a Regenerate option.
Assign AI-tracked surfers to athletes
The AI detects and tracks individual surfers, which start out unassigned:
- In the athlete chips row, unassigned tracked surfers appear as amber chips labeled
#<track_id>. - Click a chip and choose Assign to athlete to map that track to a roster athlete.
- Use the dashed + Add chip to add another athlete to the session, or hover a chip and click the X to remove one.
Assigning a surfer links their stats to that athlete and lets them see the session.
Manage clips
Clip pills switch the active clip. Click + Add Clips to upload more footage into the same session; each pill has a hover X ("Remove Clip") with a confirmation.