# Command line tools **URL:** https://forum.mapillary.com/c/contributing-and-equipment/command-line-tools/71.md [Latest](https://forum.mapillary.com/latest.md) · [Categories](https://forum.mapillary.com/categories.md) --- ## [About the command line tools category](https://forum.mapillary.com/t/about-the-command-line-tools-category/1710)
**Author:** [@katrin](https://forum.mapillary.com/u/katrin)\ **Replies:** 1\ **Last updated:** [February 17, 2019, 11:05am UTC](https://forum.mapillary.com/t/about-the-command-line-tools-category/1710 "2019-02-17T11:05:47Z")
Discuss Mapillary Python tools and your own tools for preprocessing and uploading imagery. --- ## [Mapillary Tools 0.14.7 is released](https://forum.mapillary.com/t/mapillary-tools-0-14-7-is-released/10234)
**Author:** [@caglarpmeta](https://forum.mapillary.com/u/caglarpmeta)\ **Replies:** 4\ **Last updated:** [September 30, 2026, 1:28pm UTC](https://forum.mapillary.com/t/mapillary-tools-0-14-7-is-released/10234 "2026-09-30T13:28:38Z")
Fixes issues with timestamp handling for videos. --- ## [Local video\_process images from \*.360 not projected correctly](https://forum.mapillary.com/t/local-video-process-images-from-360-not-projected-correctly/8459)
**Author:** [@danbjoseph](https://forum.mapillary.com/u/danbjoseph)\ **Replies:** 27\ **Last updated:** [September 20, 2026, 12:25pm UTC](https://forum.mapillary.com/t/local-video-process-images-from-360-not-projected-correctly/8459 "2026-09-20T12:25:06Z")
I’m trying to process video files locally to images. I need them to run an analysis workflow as a demo and we don’t have the bandwidth to get everything up to Mapillary and then downloaded again in time. The images that … --- ## [GoPro Max (1/2) GPMF and video frame timing drift during distance-based sampling](https://forum.mapillary.com/t/gopro-max-1-2-gpmf-and-video-frame-timing-drift-during-distance-based-sampling/10639)
**Author:** [@TheWizard](https://forum.mapillary.com/u/TheWizard)\ **Replies:** 5\ **Last updated:** [August 22, 2026, 8:53pm UTC](https://forum.mapillary.com/t/gopro-max-1-2-gpmf-and-video-frame-timing-drift-during-distance-based-sampling/10639 "2026-08-22T20:53:46Z")
I am investigating a reproducible GPS placement issue when using mapillary\_tools sample\_video with GoPro TimeWarp footage recorded at approximately 29.97 fps. Images sampled near the end of a recording can receive a GPS… --- ## [Fixing the date with GPS time - for beginners](https://forum.mapillary.com/t/fixing-the-date-with-gps-time-for-beginners/5762)
**Author:** [@joostjakob](https://forum.mapillary.com/u/joostjakob)\ **Replies:** 18\ **Last updated:** [August 20, 2026, 10:11am UTC](https://forum.mapillary.com/t/fixing-the-date-with-gps-time-for-beginners/5762 "2026-08-20T10:11:17Z")
Hi, Many devices have the tendency to reset their date/time when they lose power for a moment. If you’re not careful, your device will save the pictures as if they were made in 2016. I didn’t find any step by step guide… --- ## [Do shorter sequences get processed more reliably?](https://forum.mapillary.com/t/do-shorter-sequences-get-processed-more-reliably/10592)
**Author:** [@rmic](https://forum.mapillary.com/u/rmic)\ **Replies:** 7\ **Last updated:** [July 29, 2026, 8:55pm UTC](https://forum.mapillary.com/t/do-shorter-sequences-get-processed-more-reliably/10592 "2026-07-29T20:55:51Z")
Hi everyone, I have a question for some of the more experienced contributors. I am aware of other similar posts about this topic (e.g : Long or short sequences, which is better? ) but they seem pretty old and even thou… --- ## [Appimage no longer works with new update on Ubuntu](https://forum.mapillary.com/t/appimage-no-longer-works-with-new-update-on-ubuntu/10488)
**Author:** [@nat1foot](https://forum.mapillary.com/u/nat1foot)\ **Replies:** 7\ **Last updated:** [June 19, 2026, 1:15am UTC](https://forum.mapillary.com/t/appimage-no-longer-works-with-new-update-on-ubuntu/10488 "2026-06-19T01:15:38Z")
Hello, With the newest version of libfuse 2 has broken appimage and the Linux desktop uploader. libfuse 3 is incompatible with appimage. Can we please get a flatpack version of the Linux uploader? Thank You --- ## [Mapillary\_tools usage for GoPro Max](https://forum.mapillary.com/t/mapillary-tools-usage-for-gopro-max/9605)
**Author:** [@MapMan](https://forum.mapillary.com/u/MapMan)\ **Replies:** 12\ **Last updated:** [May 29, 2026, 7:34am UTC](https://forum.mapillary.com/t/mapillary-tools-usage-for-gopro-max/9605 "2026-05-29T07:34:09Z")
I have \*.360 files from GoPro Max and want to process using mapillary\_tools to upload rectilinear 360 images that are spaced with GPS distance three meters. I am on Windows 10 so i cant generate rectilinear mp4 with embe… --- ## [Upload server error: File handle not found in the upload response {"debug\_info":{"retriable":true,"type":"ShutdownError","message":"Server shutting down. Please try again."}}](https://forum.mapillary.com/t/upload-server-error-file-handle-not-found-in-the-upload-response-debug-info-retriable-true-type-shutdownerror-message-server-shutting-down-please-try-again/9337)
**Author:** [@GITNE](https://forum.mapillary.com/u/GITNE)\ **Replies:** 74\ **Last updated:** [May 18, 2026, 12:32pm UTC](https://forum.mapillary.com/t/upload-server-error-file-handle-not-found-in-the-upload-response-debug-info-retriable-true-type-shutdownerror-message-server-shutting-down-please-try-again/9337 "2026-05-18T12:32:17Z")
mapillary\_tools version 0.13.2 Uploading ZIP mly\_tools\_737db28b51bb9e407ddf8a31abb1771e.zip (4/5): 100%|█████████████████████████████████████████████████████████████████████████████| 61.6G/61.6G \[14:36:08\<00:00, 1.26MB/s… --- ## [Increasing upload problems](https://forum.mapillary.com/t/increasing-upload-problems/10368)
**Author:** [@Hol\_Ger](https://forum.mapillary.com/u/Hol_Ger)\ **Replies:** 24\ **Last updated:** [May 14, 2026, 4:25pm UTC](https://forum.mapillary.com/t/increasing-upload-problems/10368 "2026-05-14T16:25:43Z")
Since about two days, I’ve been getting more and more errors like this when uploading: Error uploading chunk\_size 973273 at begin\_offset 0: HTTPError: 412 Client Error: Precondition Failed for url: https://rupload.faceb… --- ## [About image processing speed - ideas](https://forum.mapillary.com/t/about-image-processing-speed-ideas/10259)
**Author:** [@bob3bob3](https://forum.mapillary.com/u/bob3bob3)\ **Replies:** 14\ **Last updated:** [April 15, 2026, 3:13pm UTC](https://forum.mapillary.com/t/about-image-processing-speed-ideas/10259 "2026-04-15T15:13:37Z")
I am about to start using a “new” camera in the vehicle that requires some time to process each days take. After some local processing I run the job in separate “process” and upload steps. For a 200-300km travel day I m… --- ## [Are uploads working okay?](https://forum.mapillary.com/t/are-uploads-working-okay/10249)
**Author:** [@bob3bob3](https://forum.mapillary.com/u/bob3bob3)\ **Replies:** 9\ **Last updated:** [March 9, 2026, 11:30am UTC](https://forum.mapillary.com/t/are-uploads-working-okay/10249 "2026-03-09T11:30:21Z")
3-4 days ago I used the tools (0.14.7) to upload about half of a 30GByte 43,000 image set, but there hasn’t been any in progress visible on the usual GUI interface. This is a new camera experiment, but I don’t see anythi… --- ## [Ffprobe metadata misread on sample\_video](https://forum.mapillary.com/t/ffprobe-metadata-misread-on-sample-video/10231)
**Author:** [@bob3bob3](https://forum.mapillary.com/u/bob3bob3)\ **Replies:** 6\ **Last updated:** [February 22, 2026, 9:33am UTC](https://forum.mapillary.com/t/ffprobe-metadata-misread-on-sample-video/10231 "2026-02-22T09:33:50Z")
Having a dabble with 0.14.6 on a cheap dashcam. Using explicit sample interval by; ./mapillary\_tools-0.14.6-linux-x86\_64 sample\_video VIDS SAMPLES --video\_sample\_interval 0.5 --video\_sample\_distance=-1 It creates date/… --- ## [Batch adding CSV coordinate data to jpg EXIF](https://forum.mapillary.com/t/batch-adding-csv-coordinate-data-to-jpg-exif/10223)
**Author:** [@doktorpixel14](https://forum.mapillary.com/u/doktorpixel14)\ **Replies:** 16\ **Last updated:** [February 9, 2026, 2:52pm UTC](https://forum.mapillary.com/t/batch-adding-csv-coordinate-data-to-jpg-exif/10223 "2026-02-09T14:52:10Z")
Hey, I took some 360 images through a trimble Mobile Mapping system but unfortunately their coordinates and timestamps are not stored in the image EXIF data but in a separate CSV table. The data can be matched through t… --- ## [Mapillary Tools 0.14.6 is released](https://forum.mapillary.com/t/mapillary-tools-0-14-6-is-released/10225)
**Author:** [@caglarpmeta](https://forum.mapillary.com/u/caglarpmeta)\ **Replies:** 2\ **Last updated:** [February 6, 2026, 8:46am UTC](https://forum.mapillary.com/t/mapillary-tools-0-14-6-is-released/10225 "2026-02-06T08:46:12Z")
Highlights: Handle large thumbnails Fixes speed limit issues with timelapse videos Detect and block zigzag sequences in image uploads Reduce sequence cutoff distance to 100 meters Fix an issue replicating … --- ## [Uploading possibly existing files](https://forum.mapillary.com/t/uploading-possibly-existing-files/10044)
**Author:** [@Richlv](https://forum.mapillary.com/u/Richlv)\ **Replies:** 3\ **Last updated:** [January 20, 2026, 2:40pm UTC](https://forum.mapillary.com/t/uploading-possibly-existing-files/10044 "2026-01-20T14:40:33Z")
I have some photos that I’m not sure whether they have been uploaded - either due to bad connectivity when travelling somewhere, some upload workflow issue or for some other reason there is no mapillary\_tools output save… --- ## [Uploading cubemap images](https://forum.mapillary.com/t/uploading-cubemap-images/10067)
**Author:** [@eliasgander](https://forum.mapillary.com/u/eliasgander)\ **Replies:** 14\ **Last updated:** [November 16, 2025, 7:49pm UTC](https://forum.mapillary.com/t/uploading-cubemap-images/10067 "2025-11-16T19:49:41Z")
Hi! I have a large street imagery dataset that consists of cubemap images per datapoint (six separate images pointing front, back, left, right, up, down). I’d like to contribute these to Mapillary. AI has suggested us… --- ## [Mapillary\_tools: reliable upload status](https://forum.mapillary.com/t/mapillary-tools-reliable-upload-status/9943)
**Author:** [@Richlv](https://forum.mapillary.com/u/Richlv)\ **Replies:** 5\ **Last updated:** [September 17, 2025, 8:32pm UTC](https://forum.mapillary.com/t/mapillary-tools-reliable-upload-status/9943 "2025-09-17T20:32:23Z")
I’m using mapillary\_tools for nearly all my uploads for a while now. With a lot of images to upload, I have a few simple scripts to handle this - in particular, I have a script to check upload status of image directories… --- ## [Mapillary Tools 0.14 is released](https://forum.mapillary.com/t/mapillary-tools-0-14-is-released/9836)
**Author:** [@tao](https://forum.mapillary.com/u/tao)\ **Replies:** 52\ **Last updated:** [September 9, 2025, 3:43pm UTC](https://forum.mapillary.com/t/mapillary-tools-0-14-is-released/9836 "2025-09-09T15:43:17Z")
To upgrade: pip install -U mapillary\_tools # or simply run uv tool run mapillary\_tools --version mapillary\_tools version 0.14.0 :glowing\_star: Highlights :rocket: Performance Boosts: Enjoy massive speed improvement… --- ## [Current Processing delay \[Solved\]](https://forum.mapillary.com/t/current-processing-delay-solved/5380)
**Author:** [@bob3bob3](https://forum.mapillary.com/u/bob3bob3)\ **Replies:** 119\ **Last updated:** [September 5, 2025, 5:03am UTC](https://forum.mapillary.com/t/current-processing-delay-solved/5380 "2025-09-05T05:03:21Z")
Wondering what the current processing delay for uploaded images is? Days? Weeks? Month ie your experience over last few weeks. Tnx --- ## ["OSError: \[Errno 28\] No space left on device" when uploading](https://forum.mapillary.com/t/oserror-errno-28-no-space-left-on-device-when-uploading/5370)
**Author:** [@Richlv](https://forum.mapillary.com/u/Richlv)\ **Replies:** 30\ **Last updated:** [August 6, 2025, 9:25pm UTC](https://forum.mapillary.com/t/oserror-errno-28-no-space-left-on-device-when-uploading/5370 "2025-08-06T21:25:26Z")
mapillary\_tools 0.7.4. Uploading with ~300MB free on the root filesystem failed with the errors below. Upload happened from an external disk with hundreds of GB free. Could it be that the images are transferred to the… --- ## [Adding a nadir to .360 files from GoPro Max](https://forum.mapillary.com/t/adding-a-nadir-to-360-files-from-gopro-max/9632)
**Author:** [@ph4ni](https://forum.mapillary.com/u/ph4ni)\ **Replies:** 5\ **Last updated:** [June 16, 2025, 12:18pm UTC](https://forum.mapillary.com/t/adding-a-nadir-to-360-files-from-gopro-max/9632 "2025-06-16T12:18:36Z")
Are there any command line tools to add a nadir to my .360 videos saved by the Max? Since I am on Linux, GoPro Player is out of reach. I would want the output ideally to be a .360 video so that I can directly upload it t… --- ## [BlackVue upload with tools 12.1](https://forum.mapillary.com/t/blackvue-upload-with-tools-12-1/9191)
**Author:** [@bob3bob3](https://forum.mapillary.com/u/bob3bob3)\ **Replies:** 8\ **Last updated:** [April 15, 2025, 1:28am UTC](https://forum.mapillary.com/t/blackvue-upload-with-tools-12-1/9191 "2025-04-15T01:28:56Z")
Thought I’d jump in and ask, rather than try pulling the code apart. @tao @boris I haven’t uploaded any BlackVue vids for a while, so grabbed the newest tools and tried. Seems the syntax has changed from; mapillary\_to… --- ## [Mapillary won't pip install](https://forum.mapillary.com/t/mapillary-wont-pip-install/9377)
**Author:** [@delbyte](https://forum.mapillary.com/u/delbyte)\ **Replies:** 4\ **Last updated:** [March 19, 2025, 8:31pm UTC](https://forum.mapillary.com/t/mapillary-wont-pip-install/9377 "2025-03-19T20:31:14Z")
Mapillary won’t pip install on my machine, I’m using python 3.13, and it keeps saying my setuptools and wheel have problems but I tried upgrading, downgrading, reinstalling, doing literally everything, but nothing works.… --- ## [\[🐛\] \`mapillary\_tools\` Extracts Incorrect \`SubSecTime\`](https://forum.mapillary.com/t/mapillary-tools-extracts-incorrect-subsectime/9329)
**Author:** [@GITNE](https://forum.mapillary.com/u/GITNE)\ **Replies:** 5\ **Last updated:** [March 5, 2025, 6:52pm UTC](https://forum.mapillary.com/t/mapillary-tools-extracts-incorrect-subsectime/9329 "2025-03-05T18:52:12Z")
How to reproduce: Create images with SubSecTime\* Exif tags Run mapillary\_tools process on the files Compare the image file’s SubSecTime\* Exif tag values with the MAPCaptureTime values in mapillary\_image\_description.jso… --- ## [Heads up regarding ffmpeg processing BlackVue videos from Debian Bookworm/Deb-multimedia](https://forum.mapillary.com/t/heads-up-regarding-ffmpeg-processing-blackvue-videos-from-debian-bookworm-deb-multimedia/7577)
**Author:** [@bob3bob3](https://forum.mapillary.com/u/bob3bob3)\ **Replies:** 8\ **Last updated:** [February 14, 2024, 3:29pm UTC](https://forum.mapillary.com/t/heads-up-regarding-ffmpeg-processing-blackvue-videos-from-debian-bookworm-deb-multimedia/7577 "2024-02-14T15:29:18Z")
I have not run this completely to ground, but it appears that the latest deb-multimedia 10:6.0.1 now fails with a header error trying to decode frames from a BlackVue DR900S camera. eg; \[mov,mp4,m4a,3gp,3g2,mj2 @ 0x55e6… --- ## [\[🐛\] \`mapillary\_tools\` breaks TIFF directory structure](https://forum.mapillary.com/t/mapillary-tools-breaks-tiff-directory-structure/9330)
**Author:** [@GITNE](https://forum.mapillary.com/u/GITNE)\ **Replies:** 0\ **Last updated:** [February 27, 2025, 11:37am UTC](https://forum.mapillary.com/t/mapillary-tools-breaks-tiff-directory-structure/9330 "2025-02-27T11:37:15Z")
How to reproduce: Run process and zip commands on any image Extract an image from the zip file Examine the JPEG file’s TIFF directory structure, e.g. with exiv2 $ exiv2 -pv zip\_extracted\_file.jpg Warning: Directory Ph… --- ## [Proxy support for mapillary\_tools?](https://forum.mapillary.com/t/proxy-support-for-mapillary-tools/3944)
**Author:** [@mjc506](https://forum.mapillary.com/u/mjc506)\ **Replies:** 5\ **Last updated:** [July 8, 2024, 1:15pm UTC](https://forum.mapillary.com/t/proxy-support-for-mapillary-tools/3944 "2024-07-08T13:15:57Z")
I do quite some mileage locally through work (well, I do normally, but not so much just at the moment…) and have a robust process for extracting geotagged images from my dashcam footage. Unfortunately, our corporate IT … --- ## [Change date of pictures \[Solved\]](https://forum.mapillary.com/t/change-date-of-pictures-solved/3293)
**Author:** [@filipc](https://forum.mapillary.com/u/filipc)\ **Replies:** 22\ **Last updated:** [May 20, 2024, 2:24pm UTC](https://forum.mapillary.com/t/change-date-of-pictures-solved/3293 "2024-05-20T14:24:43Z")
Yesterday in good weather I recaptured and completed the grocery transport area in Sint Katelijne Waver. But with the wrong date and time. Now I have problems changing the date. Even with Total Commander. Does anyon… --- ## [Possible tools problem with image date offset](https://forum.mapillary.com/t/possible-tools-problem-with-image-date-offset/7565)
**Author:** [@bob3bob3](https://forum.mapillary.com/u/bob3bob3)\ **Replies:** 3\ **Last updated:** [November 13, 2023, 11:10am UTC](https://forum.mapillary.com/t/possible-tools-problem-with-image-date-offset/7565 "2023-11-13T11:10:26Z")
Though this worth a mention. Perhaps someone would like to check/replicate. I had been “stuck” on version 0.10.3a1 for a while. I was using an older distro that only had Python 3.7. Now have bookworm and the latest tool… [Next page](https://forum.mapillary.com/c/contributing-and-equipment/command-line-tools/71.md?page=1)