SoccerNet Action Spotting: The 17 Soccer Action Classes

# SoccerNet Action Spotting Configuration
# Based on Giancola et al., CVPR 2018
# Task: Identify and timestamp key soccer match events

annotation_task_name: "SoccerNet Action Spotting"
task_dir: "."

# Data configuration
data_files:
  - sample-data.json
item_properties:
  id_key: "id"
  text_key: "video_url"

# Output
output_annotation_dir: "annotation_output/"
output_annotation_format: "json"

# Annotation schemes
annotation_schemes:
  - name: "soccer_events"
    description: |
      Mark key events in the soccer match. Click at the exact moment each event occurs.
      Use keyboard shortcuts for faster annotation. These are the 17 action classes
      defined by SoccerNet-v2 (Deliège et al., 2021).
    annotation_type: "video_annotation"
    mode: "keyframe"
    labels:
      # Scoring & shots
      - name: "Goal"
        color: "#22C55E"
        key_value: "g"
      - name: "Penalty"
        color: "#EAB308"
        key_value: "p"
      - name: "Shots on target"
        color: "#16A34A"
        key_value: "s"
      - name: "Shots off target"
        color: "#84CC16"
        key_value: "h"

      # Cards
      - name: "Yellow card"
        color: "#FACC15"
        key_value: "y"
      - name: "Red card"
        color: "#EF4444"
        key_value: "r"
      - name: "Yellow->red card"
        color: "#F97316"
        key_value: "2"

      # Set pieces & restarts
      - name: "Corner"
        color: "#06B6D4"
        key_value: "c"
      - name: "Direct free-kick"
        color: "#14B8A6"
        key_value: "d"
      - name: "Indirect free-kick"
        color: "#2DD4BF"
        key_value: "i"
      - name: "Throw-in"
        color: "#0EA5E9"
        key_value: "t"
      - name: "Kick-off"
        color: "#8B5CF6"
        key_value: "k"
      - name: "Offside"
        color: "#6366F1"
        key_value: "o"

      # Game flow
      - name: "Foul"
        color: "#EC4899"
        key_value: "f"
      - name: "Substitution"
        color: "#3B82F6"
        key_value: "u"
      - name: "Clearance"
        color: "#A855F7"
        key_value: "l"
      - name: "Ball out of play"
        color: "#94A3B8"
        key_value: "b"

    frame_stepping: true
    show_timecode: true
    playback_rate_control: true
    zoom_enabled: true
    video_fps: 25

# User configuration
allow_all_users: true

# Task assignment
instances_per_annotator: 20
annotation_per_instance: 2

# Instructions
annotation_instructions: |
  ## Soccer Action Spotting Task

  Your goal is to identify and timestamp the 17 SoccerNet-v2 action classes in
  soccer match footage.

  ### The 17 Action Classes:

  **Scoring & shots:**
  - **Goal (g)**: The ball fully crosses the goal line
  - **Penalty (p)**: A penalty kick is taken
  - **Shots on target (s)**: A shot that would enter the goal if not saved/blocked
  - **Shots off target (h)**: A shot that misses the goal

  **Cards:**
  - **Yellow card (y)**: Referee shows a yellow card
  - **Red card (r)**: Referee shows a straight red card
  - **Yellow->red card (2)**: A second yellow resulting in a red

  **Set pieces & restarts:**
  - **Corner (c)**: A corner kick is taken
  - **Direct free-kick (d)**: A direct free-kick is taken
  - **Indirect free-kick (i)**: An indirect free-kick is taken
  - **Throw-in (t)**: A throw-in is taken
  - **Kick-off (k)**: Play starts or restarts from the center
  - **Offside (o)**: Offside is called

  **Game flow:**
  - **Foul (f)**: Referee calls a foul
  - **Substitution (u)**: A player substitution is made
  - **Clearance (l)**: A defensive clearance
  - **Ball out of play (b)**: The ball leaves the field of play

  ### Instructions:
  1. Watch the video carefully
  2. When you see an event, pause at the exact moment it occurs
  3. Press the keyboard shortcut or click the label to mark the event
  4. The timestamp will be recorded automatically

  ### Tips:
  - Use frame stepping (< >) for precise timing
  - Mark events at the moment they START (e.g., when card is shown, not raised)
  - Use playback speed control to slow down fast action
  - You can zoom the timeline for precision