Added README.md

README.md

@@ -0,0 +1,49 @@
+# 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.