Desktop uploader

The Mapillary Desktop Uploader is a desktop application that enables uploading Mapillary imagery in bulk. You can upload to individual as well as organization accounts (including both public and private organization imagery).

The Desktop Uploader is available for Windows, MacOS, and Linux and currently supports uploading of geotagged images and videos.

Download the Desktop Uploader →

In this article, you can read about:

1. Getting started
2. Uploading images
3. Uploading videos
4. Upload history and retrying uploads
5. Aborting the upload and reprocessing images
6. Reporting issues (including where to find error logs)

Note. To ensure our service is fast and high-performing, we've set an upper limit of 108 megapixels per image. If your imagery exceeds that, please reduce the resolution before uploading, otherwise it won't get processed.

 

Getting started

Download the installer file from the download page and run it on your computer like when installing any other application.

Open it and sign in with your Mapillary login credentials. You can’t use the application without signing in, so if you don’t have an account yet, create one on the Mapillary web.

Once you’ve signed in, you’re ready to start uploading.

1. Choose your upload target
2. Add files (they will be processed for uploading)
3. Upload

Uploading images

After you've signed in to the uploader, the first step is to make sure you've chosen the correct upload target.

If you are a member of an organization on Mapillary, you will see the option to change your upload target (individual or organization, public or private imagery). Do that before you add imagery (if you forget, you need to reprocess the images before uploading—read below how to do that).

Drag and drop or browse for image files, video files, or folders.

Your imagery needs to be already geotagged (i.e. have GPS information in the EXIF data which should be added by the camera you used); you can't add that manually to images in the Uploader. 

When you’ve added a folder, the images it contains will be pre-processed and you will see their locations displayed on the map. Depending on the volume, this may take some time. At this stage, the images are not yet uploaded. Note that if you’re trying to add a folder that contains images which have already been processed previously, the uploader will remember that and prompt you to resume the upload (even if you've added new images to the folder that are not processed).

When the imagery has been processed, you can preview it by clicking on an image marker on the map and then the image icon on the right-hand side. You can also see image details if you click on the button in the viewer that says EXIF.

If you want, you can edit the compass angle of the whole batch before you upload. Click on “Advanced options” and enter the offset angle in degrees (0 for north, 90 for east, 180 for south, 270 for west).

Finally, click “Upload” to start uploading the prepared images to Mapillary. You can leave your computer; the application will prevent it from going to sleep before it has completed the upload. This way, you can easily opt to upload images at the time you’re not using your bandwidth for other things (e.g. overnight).

 

Uploading video files

The Desktop Uploader supports video files from many popular 360, action, and dash cameras.

To upload videos, first make sure you've chosen the correct upload target in the drop-down menu of the file selection screen.

Next, add the folder(s) containing the videos. The uploader will prepare them for uploading (this may take a while, depending on the file volume). You'll see the GPS tracks of the processed videos on the map.

Hit the Upload button at the bottom left. You can leave the upload unattended; the application will prevent your computer from going to sleep until all files have been uploaded. If your connection drops, the Uploader will retry upload a number of times automatically. If repeatedly unsuccessful, the upload will be listed in your Upload history so you can retry manually later (see the next section).

After uploading, Mapillary will sample your videos for image frames. You should see your processed uploads on the platform within some hours normally (note that processing videos takes a bit longer compared to if you upload images).

 

Upload history and retrying uploads

At the top right of the Uploader window, you can see a button for accessing your upload history. There you’ll see all your uploads—completed as well as failed ones. This will help you keep track of what you’ve managed to upload. You can see which account you uploaded to, how many images or videos, when, and whether the upload was successful. For failed or canceled uploads, you can click the “Retry” button right there to resume the upload.

From the three dots at the end of the row, you can access some additional options such as opening the folder on your computer that contains the files, deleting the files from your computer, or removing this upload from the uploads list.

Error and bug reporting

If you encounter problems starting the Uploader on Linux, use the --no-sandbox flag.

If you run into any errors with the Uploader, please email us at support@mapillary.zendesk.com and provide the following information:

• Description of the problem (what happened vs what did you expect)
• Platform (macOS or Windows)
• App version (from the "About" menu item)
• A detailed description of the steps taken
• Screenshots or videos illustrating the problem
• Logfiles

To find the logfiles (you may need to allow viewing hidden files, see the previous section):

• On macOS: ~/Library/Logs/<app name>/log.log
  For example: ~/Library/Logs/Mapillary\ Uploader/log.log (expanded to /Users/username/Library/Logs/Mapillary\ Uploader/log.log)
• On Windows: %USERPROFILE%\AppData\Roaming\<app name>\log.log
  For example: C:\Users\IEUser\AppData\Roaming\Mapillary Uploader\log.log