agi-frame-extract/README.md

AGI Frame Extract

Python script that extracts single frames from MP4 files and annotates them with GPS coordinates from SRT subtitle files.

Features

• Extract frames from MP4 at specified timecode or frame number
• Read GPS coordinates from SRT files at matching timecodes
• Write GPS coordinates to extracted frames using exiftool

Workflow

1. Provide MP4 file + SRT file
2. Specify timestamp or frame number
3. Script extracts the frame
4. Script finds GPS at that timestamp in SRT
5. Script writes GPS EXIF data to the frame

Requirements

• Python 3.x
• FFmpeg
• exiftool