video2geoframes.py
🇬🇧 version
Python program to generate a collection of geotagged images from a video and a GPS track.
Designed for ease contribution to street-level imagery projects like Mapillary or Panoramax.
Quick start
Nothing simpler : collect your video, your GPS track, execute Python script and follow the guide !
In detail, the program is built around a TUI or Textual User Interface, permitting to launch video process easily with step-by-step parameters input.
Input is guided by textual help indicating attempted values.
Before script starting, you need to have :
- a video file with exact timestamp (start) in local time or UTC
- a clean GPS tack file covering video duration
- a working directory.
Documentation
Coming soon.
Features
Coming soon.
Comparison v1 / v2
| Features | v1-beta | v2-alpha9 |
|---|---|---|
| Timelapse video support | ✔️ | ✔️ |
| EXIF tags writing | ✔️ | ✔️ |
| Extended tags support | ✔️ | ❌ |
| Milliseconds support | ✔️ | ✔️ |
| Progress displaying | 🟡 raw | ✔️ |
| Multilingual TUI 🇺🇳 | 🟡 limited | ✔️ |
| Configuration customization | ❌ | 🟡 partial |
| JPEG qualtiy customization | ❌ | 🔄 planned |
| TOML setting | ❌ | 🔄 planned |
Languages
TUI is multilingual thanks to "locales" base in the form of TOML files (locales/*.toml) easily extensible.
| Languages | Locale | Support | Maintainer |
|---|---|---|---|
| 🇺🇸 English | en_us |
✔️ 100 % | @lumathieu |
| 🇫🇷 French | fr_fr |
✔️ 100 % | @lumathieu |
| 🇮🇹 Italian | it_it |
🔄 planned | @lumathieu ? |
Versions
See Releases.
Setup
To set up program, be enough to clone Git repository, set up software dependencies and build Python environnement. Recommended to use a virtual environnement (venv).
Python
Entire project is developed and tested on Python 3.11 (Windows x86-64).
Dépendances
Core script uses following Python libraries (see also requirements.txt) :
numpyopencv-pythonpiexiftomlkittqdm.
Compatibility
Code is designed to be platform-independent.
Official supported platforms are Windows and Linux (partially tested under Debian / Ubuntu).
Contribution
Coming soon.
If you are interested to project contribution, you can send a mail to campanu@luc-geo.fr.
License
This repository, except dependencies, is licensed under GNU GPL v3.
Dependencies are included in repository for development and keep their original license
(see dependencies/EXTRA_LICENSES.md).