Skip to content
This repository has been archived by the owner on Jul 2, 2021. It is now read-only.

Lightroom Web Gallery plugin focused on location (displaying track and using GPS info of photos)


Notifications You must be signed in to change notification settings


Repository files navigation

Map Lightroom Web Gallery

This project is unmaintained. I switched to simply exporting the pictures and building the website via Hugo and my theme hugo-split-gallery

Important note: You will need an API key from IGN (free) to use the maps.

It is missing a lot of configurations options (color themes, etc.), and rendering is not optimized for mobiles devices.

Loosely based on The Gallerific Lightroom Web Gallery.

Using with Lightroom


  1. Unzip the Maps.lrwebengine folder and copy this to the Lightroom Web Galleries folder. This folder can be opened within Lightroom preferences (Win: Edit->Preferences, Mac: Lightroom->Preferences) by clicking on the “Show Lightroom Presets Folder” button, then opening Web Galleries.
    • On Mac this is located under: /Users/username/Library/Application Support/Adobe/Lightroom/Web Galleries/
    • On Windows Vista/7/8/10, this is normally under: _C:\Users\username\AppData\Roaming\Adobe\Lightroom\Web Galleries_
  2. (Re-)Start Lightroom; the Maps gallery should appear in the list at the top right under the Web workflow


  1. As with any web album, select the images you wish to export using the Library view in Lightroom. Be sure they have all the metadata you want to include in the album, including GPS location. When you’re happy with the images and their order, open the Web view.
  2. Select the Map Lightroom Web Gallery from the Layout style at the top right.
  3. Choose the options you want:
    • Site Infos:
      • Site Title: name of your website
      • Collection Title: name of this gallery
      • Collection Description: description of the gallery; will appear on the cover page above the thumbnails
      • Homepage: Complete address to the root of your website (e.g. "", or "/my-subdirectory") - no trailing slash
      • Destination URL path: subfolder where the gallery will be stored - no trailing slash
      • IGN API key: Key for using the IGN features
    • Appearance:
      • Slide Size: Max size to be displayed on the webpage - I set it to 2000px
      • Full (expanded) Size: Max size for full-res downloadable images - I set it to 20 000px
      • Discourage search engines from indexing this site: indicate to search engines not to index this gallery
      • Search keywords: keywords to put in the page metadata for search engines
    • Image Info:
      • Image Title: which field will be used as title of each images
      • Image Description: which field will be used as description of each images
      • Map Zoom Level: which field will be used to indicate which level of zoom to display when the image is displayed (optional)
    • Output Settings:
      • JPG Quality: quality (the higher the better quality, but gives larger files) - I set it to 70%
      • Metadata: which metadata to have embedded in the exported images
      • Watermarking: adds watermarking
  4. Export... and the resulting HTML pages and resources files will be generated in the folder you selected.
    • The generated folder can then be loaded onto a web server for access via the web - it will not fully work if launched locally from your file browser
    • The plugin automatically picks the featured image: the first photo which has a colored label or, if none, the first best rated photo
    • If a .gpx file is present in the same folder as the featured image, the plugin exports it and displays it on the map
      • Once the album exported, you can replace the track.gpx file besides index.html to load and display another track on the map

Advanced Usage

Handling multiple galleries and a homepage

If you have multiple galleries, a script is provided to automatically:

  • re-generate them using the latest template,
  • mutualize the resources at the root folder,
  • and generate a homepage to reference all the galleries

The script relies on some parameters within the params.json file:

    "title": "",
    "ign-key": "mykey",
    "host": "",
    "root": "/my-subdirectory",
    "links": [
        [{"title": "", "link": "", "icon": "fa-area-chart"}],
        [{"title": "My Github profile", "link": "", "icon": "fa-github"}, {"title": "My pro. website", "link": "", "icon": "fa-address-card"}]
  • title: name of your website (as entered in Lightroom in Site Title)
  • ign-key: IGN API key (as entered in Lightroom as IGN API key)
  • host: Complete address of the host of your website (e.g. "", without any subfolder) - no trailing slash
  • root: root of your website (e.g. "/my-subdirectory", or empty if your website is at the root of your domain) - no trailing slash
  • links: optionally, you can define 2 lists of links to be displayed in top-right corner of the homepage

Here, the samples parameters are for a homepage hosted at

The script will overwrite the Sites Infos entered in Lightroom. This is handy to be able to switch between multiple IGN API keys (local vs. on server).

To run the script on Mac OS X:

virtualenv venv
. venv/bin/activate
pip install -r requirements.txt
python <path/to/root>

Use python -h to obtain help.

Other scripts

Other scripts are provided to:

  • merge two galleries together:
  • reverse the list of images in a gallery:

Use -h to obtain help on these scripts.

In both cases, you will have to re-generate the galleries using

Customizing the templates

You can customize the templates and resources. When using, it will use:

  • the resources from the res folder
  • gallery.mako for each gallery's index.html
  • homepage.mako for the homepage's index.html

gallery.mako is, however, re-built automatically so you should not edit it directly.

When using the Lightroom plugin, it will use the resources and templates embedded in the plugin.

To keep resources and templates aligned between this folder and the plugin, you can use It will:

  • re-generate gallery.mako from gallery-master.mako
  • re-generate the templates in Maps.lrwebengine from gallery-master.mako
  • copy the res folder into Maps.lrwebengine

You will have to re-install Maps.lrwebengine after re-building the plugin. You can keep Lightroom opened during the installation; no need to restart it.


Licensed under MIT License. Source code is available at

This projects relies on:


Lightroom Web Gallery plugin focused on location (displaying track and using GPS info of photos)