Electron desktop application for displaying the locations of geotagged photos on a Google map.

Features

• Photo locations are displayed using Google Maps
• Photo locations are saved to a database for fast reading - the photos only need to be read once to get their location
• Clustering of map markers for improved performance when displaying the locations of large numbers of photos
• Lightbox with a gallery for viewing the mapped photos
• Filtering of photos on the map by the date they were taken

Getting started

Windows dependencies for development

On Windows, you must have the Visual C++ build tools installed to build a project dependency:

1. Download and run the Microsft Visual Studio installer
2. Choose the specific components of the Visual Studio Build Tools to install, and select the Visual C++ build tools workload and both the optional Windows 8.1 SDK and UCRT SDK and VC++ toolset for dekstop (The current version as of this writing is VC++ 2015.3 v14.00 (v140)). You do not have to install Visual Studio itself.
3. Create the environment variable VCTargetsPath with the value being the directory containing the Microsoft.cpp.* files. The default path for version 14 of the build tools should be C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\v140.

Setting up the project for development

1. Install nodejs
2. Install npm
3. Install dependencies using using the command npm install <repository_location>.
4. Build the sqlite3 package by running the command npm run rebuild in the root directory. On Windows, if you get an error like The build tools for <version> (Platform Toolset = <version>) cannot be found, you will need to use the --msvs_version flag to specify the version of the build tools you have installed.
5. Compile the TypeScript files: npx tsc
6. Run the application using the command /<repository_location>/node_modules/.bin/electron <repository_location>

Currently, the map works without a Google Maps API key. If this ever changes in the future, you will have to sign up for a Google Maps API key and then create the file google_maps.key in the repository's root directory, and then add your key to the file.

Testing

Unit tests for the application are written using Mocha.

Run the tests with the command: npm test

Screenshots

Map view, showing clustering of photos

Zoomed in view

Lightbox view

Modal to search for geotagged photos