50 lines
1.4 KiB
Markdown
50 lines
1.4 KiB
Markdown
|
# GPX Overlayer
|
||
|
|
|
||
|
|
This software is a command line tool that reads a given GPX file
|
||
|
|
and interprets the data as speed and elevation, interpolating the
|
||
|
|
values and generates still images to be used as an overlay for
|
||
|
|
action camera videos. It is aimed at Linux systems since there's
|
||
|
|
a lack of this type of software in this platform that's easy to
|
||
|
|
use and install.
|
||
|
|
|
||
|
|
## Installing
|
||
|
|
|
||
|
|
Make sure you have python version 3 available.
|
||
|
|
|
||
|
|
Install virtualenv: `$ apt-get install python3-virtualenv` (Debian & Ubuntu)
|
||
|
|
`$ dnf install python3-virtualenv`
|
||
|
|
|
||
|
|
Clone this repository and create a virtualenv in the newly created
|
||
|
|
repository:
|
||
|
|
|
||
|
|
```
|
||
|
|
$ virtualenv gpx-overlayer
|
||
|
|
```
|
||
|
|
|
||
|
|
Go into the directory and activate the virtualenv
|
||
|
|
|
||
|
|
```
|
||
|
|
$ cd gpx-overlayer
|
||
|
|
$ source bin/activate
|
||
|
|
```
|
||
|
|
|
||
|
|
Now install the requirements:
|
||
|
|
|
||
|
|
```
|
||
|
|
$ pip install -r requirements.txt
|
||
|
|
```
|
||
|
|
|
||
|
|
Now you can run the program. Remember to activate the virtualenv before
|
||
|
|
running.
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
The program needs two parameters; the GPX file, and where to output the
|
||
|
|
still images. You can also use the `--fps` parameter to specify the
|
||
|
|
frames per second you need (by default, it will 30 frames per second).
|
||
|
|
|
||
|
|
After the program has run, the specified directory will be filled with
|
||
|
|
a lot of `.png` images named `still-xxxxxxxx.png` that you can then
|
||
|
|
import into your favourite video editor as an image sequence or you can
|
||
|
|
run `ffmpeg` to generate a video.
|