lumathieu/video2geoframes.py
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 11 Wiki Activity

README.md improvement

Browse Source
This commit is contained in:
Lucas MATHIEU
2024-06-28 23:52:39 +02:00
parent b635a2795e
commit 710a5e2fc6
2 changed files with 32 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
README.md
View File

@@ -1,5 +1,34 @@
# video2geoframes.py
Python script to generate a collection of geotagged images from a video and a GPS track.
Python program to generate a collection of geotagged images from a video and a GPS track.
Designed for contribution to street-level imagery projects like Mapillary or Panoramax.
## Notes
This program was originally designed for personal use to contribute to Mapillary and now to Panoramax with a smartphone
(video mode) or a dashcam.
This v1 is the last version of the original code, published "as it is" with certain known bugs and limitations.
Since June 2024, a v2 was started to develop with the aim of :
* enhance performances
* fix known bugs
* clean code
* remove non-Python dependencies
* implement more flexible configuration with TOML.
## ⚠ Bugs and limitations
| Report | Workaround |
|------------------------------------------------------------------------------------------------------|-------------------------------------------------------|
| [bug] in non-timelapse mode, **FFmpeg** doesn't extract first video frame and shifts every timestamp | 🔃 adding chosen framesampling interval to GPS offset |
| [bug] **ExifTool** timestamp very long (~1 frame / s) | ❌ |
| [bug] uncontrolled incrementation if export directory is on a Samba share (ZFS) | ❌ |
| 9999 frames limit (naming model) | ❌ |
## License
This repository, except dependencies, is licensed under **GNU GPL v3**.
Dependencies are included in repository for development and keep their original license.

2
video2geoframes.py
View File

@@ -2,7 +2,7 @@
# -*- coding: utf-8 -*-
"""video2geoframes.py
Python script to generate a collection of geotagged images from a video and a GPS track.
Python program to generate a collection of geotagged images from a video and a GPS track.
Designed for contribution to street-level imagery projects like Mapillary or Panoramax.
"""