gps2htmlReport: GPS to HTML Summary Report

[ bsd3, data, library, program ] [ Propose Tags ]

Generate a HTML summary report of GPS tracks

[Skip to Readme]
Versions [faq] 0.1, 0.2, 0.2.1, 0.2.2, 0.3, 0.3.1
Dependencies base (==4.*), bytestring, cairo, Chart, cmdargs, colour, data-accessor, directory, filepath, gd (>=3000.7.1), gps (>=0.8.4), hsmagick, html, http-enumerator, process, random, tar, time, xsd (>=0.3.5) [details]
License BSD-3-Clause
Author Rob Stewart <>
Maintainer Rob Stewart <>
Category Data
Home page
Bug tracker
Source repo head: git clone git://
Uploaded by RobStewart at Sun Dec 25 22:58:49 UTC 2011
Distributions NixOS:0.3.1
Executables gps2htmlReport
Downloads 2902 total (77 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs uploaded by user
Build status unknown [no reports yet]




Maintainer's Corner

For package maintainers and hackage trustees

Readme for gps2htmlReport-0.3

[back to package description]

GPS 2 HTML Report

This is a utility written in Haskell, to generate HTML reports from GPS track files.

Included in the report:

  • Details of the journey... journey time, distance travelled etc..
  • Diagrams charting speed, elevation, accumulated distance etc..
  • OpenStreetMap diagram highlighting the GPS track

An example can be seen here.

The hackage page is here.


A user first of all needs to install the Haskell Platform. For exmaple, on an RPM-based machine, as root:

># yum install haskell-platform

The recommended way to install the `gps2HtmlReport' program, is to grab it via

cabal update
cabal install gps2htmlReport

Or to install the version in the github repository:

git clone git://
cd Gps2HtmlReport
cabal update
cabal configure
cabal install

This Haskell program also makes use of the bindings to GraphcsMagick and Cairo, and so the necessary system packages need to be installed, via a Linux package manager.

On an RPM-based package manager, run this command as root:

># yum install GraphicsMagick cairo gtk2hs-buildtools


First of all, you need to have your GPS date in a GPX file. There are many gpx exporters available. I use my Android phone to take GPX tracks, with a great application, OSMTracker. This application allows you to export your GPS tracks to GPX.


The program will search for all files ending in ".gpx", and for each one, generate a HTML report.

$ cd $location_of_gpx_files
$ ls
$ gps2HtmlReport --help

gps2HtmlReport [OPTIONS]
  A Haskell utility to generate HTML page reports of GPS Tracks and Track
  overlays on OpenStreetMap tiles

Common flags:
  -i --imageonly  Generates only an image of the track overlay on an
                  OpenStreetMap layer
  -a --archive    Produce tar archive for web and image files
     --hashnames  Create reports in hashed directory names
  -h --help       Display help message
  -v --version    Print version information
  -V --Verbose    Loud verbosity
  -q --quiet      Quiet verbosity


If you receive this error when trying to run the program:

can't load .so/.DLL for: stdc++ ( cannot open shared object file: No such file or directory)

... then you are experiencing this bug: #5289.

To fix this

  • Fedora 32bit: $# ln -vs $(gcc /usr/lib/
  • Fedora 64bit: $# ln -vs $(gcc /usr/lib64/
  • Ubuntu 32bit: $# ln -vs $(gcc /usr/local/lib/
  • Ubuntu 64bit: $# ln -vs $(gcc /usr/local/lib64/

If you experience other problems, please let me know - and preferrably sending me the problematic .gpx file.


Thanks to Thomas DuBuisson, for implementing the `gps' package and contributing it to Hackage.