Uploading Sessions

Get footage into Surflink and the AI pipeline from the Upload button (/upload). You can upload files directly or import from Adobe Frame.io.

Direct upload (step by step)

1. Click Upload in the sidebar.
2. Drop your clips into the drop zone (or click to pick files).
3. Fill in Session Details:
   • Title (e.g. "Morning session, Pipeline")
   • Spot
   • Date
   • Description
4. If you have athletes, tap names under Athletes in Session to tag who's in the footage. A counter shows how many are selected. (You can also assign tracked surfers later -- see Reviewing Sessions.)
5. (Optional) Toggle Compress before upload to shrink files to ~720p before they upload. (See the note below about browser support.)
6. Choose a Processing Mode:
   • Cloud (Modal) -- the default; analysis runs on Surflink's cloud GPU.
   • Local GPU -- analysis runs on a local SurfVision server. Enter the server URL (default http://localhost:8000) and click Test to confirm it's online.
7. Click Analyze N Clips. (The button reads "Select video clips first" until you've added files.)

Surflink creates the session, uploads each clip (up to 2 at a time), and sends them for AI analysis. You'll see an overall progress ring plus a per-clip status list (waiting, uploading, uploaded, analyzing, processing). When uploads start, you're redirected to the session page where processing continues.

Compression availability: the Compress before upload toggle only appears when your browser supports SharedArrayBuffer. This requires specific cross-origin headers that are not configured in the default deployment, so compression is effectively unavailable in production until those headers are added. Uploading uncompressed footage always works.

Import from Frame.io

1. On the Upload page, click Import from Frame.io.
2. Connect: click Sign in with Adobe to authorize Frame.io (first time only).
3. Select a workspace (skipped automatically if you only have one).
4. Select a project.
5. Browse folders and tap video files to select them. Only video/* files are selectable; others are greyed out.
6. The footer shows "N clips selected" -- click Import Clips (max 10 per import).

Surflink downloads the assets, creates a session with clips, and sends each clip for AI analysis, then redirects you to the session page.

What happens after upload

Regardless of processing mode, your files are stored in Surflink's storage, and analysis produces an annotated video plus a stats file per clip. Follow the processing on the session page. For the full technical flow see the developer guide on the AI Video Pipeline.