97 lines
3.2 KiB
Markdown
97 lines
3.2 KiB
Markdown
# 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_](https://git.luc-geo.fr/lumathieu/video2geoframes.py/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`) :
|
|
- `numpy`
|
|
- `opencv-python`
|
|
- `piexif`
|
|
- `tomlkit`
|
|
- `tqdm`.
|
|
|
|
## 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 AGPL v3**.
|
|
|
|
Dependencies are included in repository for development and keep their original license
|
|
(see `dependencies/EXTRA_LICENSES.md`).
|