Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/peregin/gps-overlay-on-video
Telemetry (GPS) data overlay on videos
https://github.com/peregin/gps-overlay-on-video
dashboard data-overlay garmin gauge gopro gps gps-overlay scala telemetry video videos-generated
Last synced: about 21 hours ago
JSON representation
Telemetry (GPS) data overlay on videos
- Host: GitHub
- URL: https://github.com/peregin/gps-overlay-on-video
- Owner: peregin
- License: mit
- Created: 2014-04-02T21:59:41.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-11-03T19:19:13.000Z (11 days ago)
- Last Synced: 2024-11-03T20:21:00.421Z (11 days ago)
- Topics: dashboard, data-overlay, garmin, gauge, gopro, gps, gps-overlay, scala, telemetry, video, videos-generated
- Language: Scala
- Homepage:
- Size: 7.12 MB
- Stars: 284
- Watchers: 26
- Forks: 36
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://circleci.com/gh/peregin/gps-overlay-on-video/tree/master)
[](https://opensource.org/licenses/MIT)
[](https://github.com/peregin/gps-overlay-on-video/issues)
[](https://github.com/peregin/gps-overlay-on-video/releases)
[](https://scala-steward.org)
GPS data overlay on videos
==========================
_The Ultimate Cycling Software_
## Table of Contents
- [Download](#download)
- [Overview](#overview)
- [How to run it](#how-to-run-it)
- [How to use it](#how-to-use-it)
- [Basic requirements](#basic-requirements)
- [Credits](#credits)
- [Resources](#resources)
- [Links](#links)
- [Videos](#generating-new-video-with-gps-overlay)
- [Gauge Ideas](#gauge-ideas)
## Download
Download the latest executable jar file (gps-overlay-on-video.jar) from [here](https://github.com/peregin/gps-overlay-on-video/releases/latest/).
It requires to have a `java` installation to run the application as follows:
```shell script
java --add-opens java.desktop/javax.swing.plaf.basic=ALL-UNNAMED -jar gps-overlay-on-video.jar
```
There are other options to run the application see [How to run it](#how-to-run-it) section.
When running make sure to use 64-bit java JDK/JRE (no video binaries included for 32-bit).
## Overview
The idea came after I bought a [GoPro](http://gopro.com/cameras/hd-hero3-silver-edition) camera and started to record
some of my rides with the bicycle which were also tracked with a GPS device.
For tracking the rides I was using the [Strava](http://www.strava.com) application on my phone
or a [Garmin Edge 510](http://www.dcrainmaker.com/2013/01/garmin-edge-510-in-depth-review.html).
After watching the videos I was asked why I'm not showing the speed and altitude information overlaid onto video?
Cool, great idea, I wanted to add all kind of telemetry data acquired via the GPS onto the video, but couldn't find a
software for it, running on my Mac. So I decided the write one :)
The generated video is able to show the current speed or the actual elevation information, eventually the grade of the slope when climbing
a steeper section or the current heart rate zone.
The main focus is on cycling videos, but with small effort, different gauge templates it is easy to create dashboard for different type of
activities.
Example of videos generated with the tool, links to youtube:
[](https://www.youtube.com/watch?v=tVCgP3Xh250)
[](http://www.youtube.com/watch?v=N74yLpdebJ8)
[](http://www.youtube.com/watch?v=0giJlMyX59I)
[](https://youtu.be/sU0WEkYdJ3s)
Screenshot of the tool:
## How to run it
The released packages are published regularly [here](https://github.com/peregin/gps-overlay-on-video/releases/latest/). On windows, you need to append `.cmd` extension.
The easiest way to run the application having just `java` installed:
```shell script
run.sh
```
The script will download the latest version published on github and will run it.
## How to use it
* Thank you [Bigjuergo](https://github.com/Bigjuergo) for creating the [how to use 4min tutorial](https://www.youtube.com/watch?v=yOvT8IoDUPA)
[](https://www.youtube.com/watch?v=yOvT8IoDUPA)
[](https://www.youtube.com/watch?v=kpHlk4FVELk)
## Basic requirements
Small list of wishes to achieve:
* show the video file and the track on the map to help synchronizing (shifting) the gps data to the beginning of the video
* add various gauges (drag'n drop into the video panel) like: speed, cadence, heart rate, altitude, acceleration, temperature, etc.
* once the gauges were added and adjusted (the size and position) allow to save the configuration as a template, so next time
it is easier to just load the template and create the new video
* and the final bit, export (or generate) to newly created video with the desired gauges.
All the information is extracted from the gps data, since mainly the coordinates and timestamps are known, it is easy to calculate
* distance
* speed
* acceleration
* direction (compass)
* provide charts about the elevation
* etc.
Telemetry data sample collected with a Garmin device (Edge 820):
```xml
902.4
205
8
160
90
```
## Credits
The application is using libraries and images created by other people or organizations:
* [JXMapViewer](http://wiki.openstreetmap.org/wiki/JXMapViewer) to show the map and the track
* [JavaCv](https://github.com/bytedeco/javacv) to decode, encode and manipulate video files
* [iconeden](http://www.iconeden.com/icon/category/free) for the beautiful icon packs they offer
* [digital true type fonts](http://www.styleseven.com/) for the gauges with seven segment display
## Resources
### Links
Useful links and information
* [Geographical distance](http://en.wikipedia.org/wiki/Geographical_distance)
* [Haversine formula](http://en.wikipedia.org/wiki/Haversine_formula) and [Versine function](http://en.wikipedia.org/wiki/Versine)
* [Slope calculation](https://www.calculator.net/slope-calculator.html)
* [Fonts and graphics](http://www3.ntu.edu.sg/home/ehchua/programming/java/J4b_CustomGraphics.html)
* [Latitude Longitude](https://cdn.ttgtmedia.com/rms/onlineimages/latitude_and_longitude-f.png)
### Generating new video with gps overlay
After synchronizing the video stream with the gps track (through the shift parameter) everything is prepared to generate a new video:
And here it is :) the first video generated with the software (Zugerberg Classic):
[](http://www.youtube.com/watch?v=N74yLpdebJ8)
### Gauge ideas
Besides the basic gauge types (speed, cadence, etc.) showing the current value so called _chart types_ are introduced as well.
The charts are showing all the data (for example an elevation chart) and the current value.
The very early drafts on the paper, how it started:
