GPX Collection Viewer

A Python tool that generates beautiful static HTML pages with interactive Leaflet maps to visualize collections of GPX files. Perfect for organizing and sharing GPS tracks from hiking, cycling, running, or any GPS-recorded activities.

Features

• Interactive Maps: View GPX tracks and waypoints on beautiful interactive maps powered by Leaflet
• Collection Organization: Organize GPX files into collections using folder structure
• Multiple Map Layers: Support for Mapbox outdoor and satellite map layers (optional)
• Responsive Design: Mobile-friendly interface with collapsible sidebars
• Markdown Content: Add descriptions and content to collections using markdown files
• File Downloads: Direct download links for original GPX files
• Track Highlighting: Click on filenames to zoom and highlight specific tracks
• Overview Map: Master overview page showing all collection locations

Quick Start

1. Install dependencies:

   pip install jinja2 markdown
   

2. Organize your GPX files:

   input/
   \x00\x00 hiking-trails/
      \x00\x00 trail1.gpx
      \x00\x00 trail2.gpx
      \x00\x00 index.md (optional description)
   \x00\x00 cycling-routes/
      \x00\x00 route1.gpx
      \x00\x00 route2.gpx
   \x00\x00 running-tracks/
       \x00\x00 morning-run.gpx
   

3. Generate the static site:

   python run.py input/ output/
   

4. Open the result: Open output/index.html in your web browser

Usage

Basic Usage

python run.py INPUT_DIR OUTPUT_DIR

With Mapbox Tokens (Recommended)

For enhanced map layers, obtain Mapbox access tokens and use:

python run.py input/ output/ --mapbox_outdoor_token YOUR_TOKEN --mapbox_satellite_token YOUR_TOKEN