1. Download copy the file locally and any enrichments, or CSV file with recording id column
2. Get a Cloud Token on your profile
3. Modify the WORKSPACE_ID and CLOUD_TOKEN accordingly.
4. Run:

# using Astral's UV
uv run --script append_wearer_id.py YOUR_CSV_FILE_PATH

This is a command-line utility to copy the gaze_offset (Cloud gaze offset) from a single source recording to one or more target recordings within a Pupil Labs Cloud workspace. It's designed to make bulk-updating gaze offsets easy, especially when you have a good offset on one recording that you want to apply to many others.

• Interactive Mode: If you don't specify any target recordings, the script will fetch all recordings in your workspace and present an interactive, searchable list for you to select from.
• Flexible Inputs: Specify target recordings individually, from a .txt file (one ID per line), or from a .json file (a list of ID strings).
• Concurrent Updates: Applies updates to all target recordings asynchronously and concurrently, making it very fast.
• Rich Reporting: Uses rich to display a clean table of which recordings succeeded or failed at the end.

This script provides an automated method to set the gaze offset on Pupil Labs Cloud based on Pupil Core's markers. By analyzing a segment of a recording where the wearer is looking at a known reference marker, it calculates the offset and sets it via Cloud API.

• A recording in Cloud where the participant is looking at Pupil Core's calibration marker,

We will use Pupil Core stack to identify the marker on the video frames and compute the distance from gaze to that marker position over a period.