Mapollage Documentation


Mapollage is a photo kml generator with a number of options listed below.


Settings are stored in profiles that you can run from the gui or from the command line. Profiles can be added, removed, renamed and cloned.


The source tab lets you select the image directory to process, a (glob) pattern to match each file and exclude strings separated by :: (double colon). When an exclude element is found in the image path, that file will be excluded.

You can choose if you want to process subdirectories, follow links and include photos without a coordinate.

This tab also includes the output log.


The folders tab defines the folder structure to be created in the kml file. First of all you will have to set the root folder name and description. Sub folder creation is done by either

  1. The image directory name
  2. A date pattern of the image timestamp
  3. The first file path match of the specified regular expression
  4. Or not at all


The path tab lets you select wether or not to create a connecting path between the images. You can set the path width and control how to split the paths.


The placemark tab controls how the placemark is presented. Its name can come from the filename, a date pattern of the image timestamp or be nothing at all. The symbol can be the photo or a pushpin.

The scale value controls the size of the placemark in its normal state and the zoom value the size when hovered.

Be sure to set a good enough value for the thumbnail size under the global program options to match scale and zoom.

Finally, it is possible to set the timestamp of the placemark and by doing so, Google Earth can filter the images by a time slider.


The description tab controls what the placemark description will look like. The description will be displayed after clicking on a placemark.

A description can be defined either by a customized template or by selecting from the static elements. Hovering a static element displays a tag that can be used in the custom form.

The photo tab is enabled only if the photo is part of the description.


The photo tab controls the images displayed in the description. The image size can be limited and the image reference can be one of

  1. A relative link to the thumbnail from the kml file
  2. A relative link to the original image from the kml file
  3. An absolute link to the original image
  4. An absolute link to a base name plus the image name

When selecting a relative reference, remember that the interrelation between the image and the kml document must not change.

There has been some reports that in some circumstances, windows have problem with the extension case and because of that, there is an option to force lower case extension. Use with caution.


The information tab displays a textual summary of the profile. The same information can be displayed from the command line with:

mapollage --view-profile <profile>


Besides the look and feel settings there are a couple of global options controlling the kml generation:

  • Calendar language
  • Thumbnail and border size
  • Default coordinate





5 Replies to “Mapollage Documentation”

  1. Is there anyway I can set the folder name of the thumbnails? I’m working in a document storage system that defines folder names for me, so I would need the folder name to be something like “d0163618”. My current solution would be to edit the icon location for each photo.

  2. Hello,

    I have tried to use the Mapollage program and it stops running after it identifies the last jpg image. It doesn’t continue with the script. I was wondering if you could help me troubleshoot! Thanks!

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.