An open API service indexing awesome lists of open source software.

https://github.com/hifly81/bikedump

Bike Dump is a Java GUI that can be used to manage and extract stats from GPX 1.0, GPX 1.1 and TCX 2 activities from your cycling/mountain biking workouts. It also offers graphs and history stats.
https://github.com/hifly81/bikedump

biking-applications bing cycling extract-stats gpx java map mountain-bike openstreetmap routes statistics workouts

Last synced: 3 months ago
JSON representation

Bike Dump is a Java GUI that can be used to manage and extract stats from GPX 1.0, GPX 1.1 and TCX 2 activities from your cycling/mountain biking workouts. It also offers graphs and history stats.

Awesome Lists containing this project

README

          

# 🚴 Bike Dump

[![Java](https://img.shields.io/badge/Java-11%2B-orange.svg)](https://www.oracle.com/java/)
[![License](https://img.shields.io/badge/License-Mixed-blue.svg)](LICENSE/)
[![Version](https://img.shields.io/badge/Version-0.4.0-green.svg)](dist/)

**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](#-features)
- [πŸ—ΊοΈ Offline Map Tiles](#️-new-feature-offline-map-tiles)
- [πŸ“Έ Screenshots](#-screenshots)
- [πŸ“‹ Prerequisites](#-prerequisites)
- [πŸš€ How to use](#-how-to-use)
- [πŸ”¨ How to Compile](#-how-to-compile)
- [πŸ“œ External Libraries & Licenses](#-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
- **Strava integration**: Connect Bikedump to your Strava account and import your workouts
- πŸ“± **Multiple Format Support**: Compatible with GPX 1.0, GPX 1.1, and TCX 2 formats

## Offline Map Tiles

Bike Dump supports offline map tiles to avoid rate limiting and 403 errors from online OpenStreetMap servers.

See dedicated instructions:

- `docs/OFFLINE_TILES.md`

## Strava integration

See dedicated instructions:

- `docs/STRAVA.md`

## Screenshots

| Main Interface | Route Map | Statistics View |
|:-------------:|:---------:|:---------------:|
| Bike Dump Main Interface | Route Map View | Statistics Dashboard |

| Elevation Chart | Calendar View | Data Comparison |
|:---------------:|:-------------:|:---------------:|
| 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:

```bash
java -jar dist/bikedump-0.5.0-release.jar
```

## How to Compile

### Step 1: Install dependencies
Before compiling, add the required libraries to your local Maven repository:

```bash
cd dist
sh install-libs.sh
```

### Step 2: Compile the project
Compile the source code with Apache Maven:

```bash
mvn clean compile
```

### Step 3: Create executable jar
Build the executable jar file:

```bash
mvn clean package
```

### Step 4: Run the compiled version
Execute the newly built jar:

```bash
java -jar target/bikedump-0.5.0-release.jar
```

## External Libraries & Licenses

Bike Dump uses the following external libraries:

| Library | Link | License |
|--------------------|------|---------|
| sunrisesunsetlib | [GitHub](https://github.com/mikereedell/sunrisesunsetlib-java) | [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) |
| jmapviewer | [OpenStreetMap Wiki](http://wiki.openstreetmap.org/wiki/JMapViewer) | [GPL](https://www.gnu.org/licenses/gpl-3.0.html) |
| kryo | [GitHub](https://github.com/EsotericSoftware/kryo) | [BSD-3-Clause](https://opensource.org/licenses/BSD-3-Clause) |
| ormlite-core | [GitHub](https://github.com/j256/ormlite-core) | [ISC](https://opensource.org/licenses/ISC) |
| JFreeChart | [GitHub](https://github.com/jfree/jfreechart) | [LGPL-2.1](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html) |
| Flat Look and Feel | [GitHub](https://github.com/JFormDesigner/FlatLaf) | [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) |

For additional details see: [NOTICE file](LICENSE/NOTICE.md)