Weekend project with Vibe Coding!
Where did I take this picture? This app displays thumbnails of photos on a map.
This was a feature that used to be well-used in Google Maps' timeline, but it disappeared, so I made it.
-Related article: My memories were stolen by Google-
https://damoang.net/free/1005788
If you specify a folder where your photos are stored on your computer, it will scatter thumbnails on the map where they were taken. Clicking on a thumbnail will enlarge the photo.
It reads subfolders as well, and you can specify multiple folders.
You can compile directly from the source code,
but I'll also post a link to the portable executable file for Windows.
https://github.com/stream9k/photomap/releases/download/v1.1.4/PhotoMap.1.1.4.exe
PhotoMap (v1.1.4)
An independent executable (Portable) Electron desktop app that displays photos based on GPS location information in map and gallery formats.
🚀 Key Features
Multiple Folder and Subfolder Scanning: Manage multiple photo folders simultaneously, and recursively search all subfolders within the specified folder to read photos.
Automatic Setting Saving: The list of registered photo folders is automatically saved even when the app is turned off and on.
Support for Two View Modes:
🗺️ Map Mode (Explore): Displays photos' GPS locations as markers on a map, supporting clustering to summarize densely populated areas. (Cluster icons display the thumbnail and number of the most recent photo).
🖼️ Gallery Mode (Gallery): Arranges photos in a grid format by date, sorted in descending order of capture time.
GPS Warning Badge & Filtering: Photos without location information are displayed faintly with a warning badge in Gallery mode. You can use the toggle switch at the top to view only photos with location information.
Lightbox Viewer (Detailed View): Clicking on a map marker popup or gallery thumbnail allows you to view the original high-resolution photo on a large screen, and navigate using arrow keys.
Automatic Rotation: Analyzes EXIF Orientation information and automatically rotates vertical photos to the correct direction.
📦 How to Use (Portable)
This app is provided as a portable version that requires no separate installation process or server execution.
Run the PhotoMap Portable 1.1.4.exe file located in the dist folder. (Or use the zip version)
Run PhotoMap.exe inside the unzipped folder.
Once the app opens, click the ⚙️ Settings button in the upper right corner to specify the folder where your photos are stored.
After specifying the folder, the app will automatically scan the photos and construct the map and gallery!
🛠️ Development Information
Technology Stack: Electron, Vanilla JavaScript, CSS (Glassmorphism design), HTML
Open Source Libraries: leaflet, leaflet.markercluster (map), exifreader (metadata parsing), sharp (thumbnail generation and image rotation processing)
How to Run/Build Source Code Directly (For Developers)
# Install dependencies
npm install
# Run the app
npm start
# Build portable distribution for release (dist/win-unpacked)
npm run build:portable