🚴 Bike Dump

Bike Dump is a powerful Java GUI application designed to manage and extract comprehensive statistics from GPX 1.0, GPX 1.1, and TCX 2 activity files from your cycling and mountain biking workouts.

📚 Table of Contents

• ✨ Features
• 🗺️ New Feature: Offline Map Tiles
• 📸 Screenshots
• 📋 Prerequisites
• 🚀 How to use
• 🔨 How to Compile
• 📜 External Libraries & Licenses

✨ Features

• 📊 Comprehensive Statistics: Extract detailed stats from your cycling activities
• 📈 Interactive Graphs: Visualize elevation, speed, distance, and time data
• 📅 History Tracking: Monitor your progress over time
• 🗺️ Map Integration: View your routes with interactive maps
• 🌐 Offline Map Support: Use offline map tiles to avoid rate limiting
• 📱 Multiple Format Support: Compatible with GPX 1.0, GPX 1.1, and TCX 2 formats

🗺️ New Feature: Offline Map Tiles

Bike Dump now supports offline map tiles to avoid rate limiting and 403 errors from online OpenStreetMap servers. See OFFLINE_TILES.md for detailed setup instructions.

Quick Setup:

1. 📥 Download map tiles in TMS format ({z}/{x}/{y}.png)
2. ⚙️ Go to Options → Library tab
3. ✅ Check "Use offline map tiles" and select your tiles directory
4. 🎉 Enjoy unlimited map viewing without internet restrictions!

📸 Screenshots

Main Interface	Route Map	Statistics View

Elevation Chart	Calendar View	Data Comparison

📋 Prerequisites

• ☕ Java 11 or higher (tested with Java 11, 17, and 21)
• 🔧 Apache Maven (for building from source)

🚀 How to use

Run Bike Dump with the pre-built jar:

java -jar dist/bikedump-0.3.0-release.jar

🔨 How to Compile

Step 1: Install dependencies

Before compiling, add the required libraries to your local Maven repository:

cd dist
sh install-libs.sh

Step 2: Compile the project

Compile the source code with Apache Maven:

mvn clean compile

Step 3: Create executable jar

Build the executable jar file:

mvn clean package

Step 4: Run the compiled version

Execute the newly built jar:

java -jar target/bikedump-0.3.0-release.jar

📜 External Libraries & Licenses

Bike Dump uses the following external libraries:

Library	Link	License
sunrisesunsetlib	GitHub	Apache 2.0
jmapviewer	OpenStreetMap Wiki	GPL
kryo	GitHub	BSD-3-Clause
ormlite-core	GitHub	ISC
JFreeChart	GitHub	LGPL-2.1

📄 For additional details see: NOTICE file