Skip to content

MarcelloPerathoner/kartaview-tools

Repository files navigation

KartaView Commandline Image Uploader

PyPI version

Commandline tools to upload discrete images to KartaView.

Also supports Vantrue OnDash X4S videos.

Usage

  1. Install:

    pip3 install kartaview-tools
  2. Authorize: This step is needed only once. You need an OSM account.

    kv_auth

    Your KartaView credentials are now stored in the file ~/.config/kartaview/credentials.json. Keep this file secret. The KartaView credentials do not expire, but you can delete the credentials file, in which case you must authorize again.

  3. Sequence the images:

    kv_sequence ~/Pictures/kartaview/*.jpg

    This step sorts your images into sequences. It extracts the GPS data from your images and stores it in sidecar files, where you can easily review it.

  4. Upload the images:

    kv_upload ~/Pictures/kartaview/*.jpg

    The script remembers which images were successfully uploaded. In case of errors, if you run the upload script on the same images again, the ones already uploaded will not be uploaded again.

Run the scripts with '-h' to see more options.

Videos

This software only supports videos produced by the Vantrue OnDash X4S dashcam.

To split a video file into discrete images use ffmpeg.

Proposed workflow:

mkdir -p /tmp/frames
# extract I-frames for better clarity
ffmpeg -skip_frame nointra -i ~/Videos/dash.mp4 -vsync 0 -frame_pts 1 /tmp/frames/%08d.jpg
# patch GPS data into image files
kv_vantrue_x4s -i ~/Videos/dash.mp4 /tmp/frames/%08d.jpg
# sequence image files
kv_sequence /tmp/frames/%08d.jpg
# upload files
kv_upload /tmp/frames/%08d.jpg

See:

GPX Files

You can extract the GPS data in your video into a GPX file and then use third-party tools (eg. exiftool) to further process it.

Proposed workflow:

kv_vantrue_x4s -i ~/Videos/dash.mp4 --gpx=track.gpx
exiftool -geotag=track.gpx /tmp/frames

See: https://exiftool.org/geotag.html

About

KartaView Commandline Image Uploader

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published