From 47b4ee669fc0b6219b37fd22aec525a577a2ecd8 Mon Sep 17 00:00:00 2001 From: Agi Date: Mon, 16 Feb 2026 14:14:15 +0100 Subject: [PATCH] Initial project setup --- README.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..e3cf110 --- /dev/null +++ b/README.md @@ -0,0 +1,23 @@ +# 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 \ No newline at end of file