Skip to main content

Map viewer, using cached offline map tiles and track files

Project description

This is PyTopo, an application for exploring tiled maps cached locally.

See the project home page at for more information, examples, screenshots, hints on creating custom maps, and more.

It can download data from OpenStreetMap or other map servers, which may or may not require API keys; or you can use tiles from commercial programs like the Topo! or tiles you’ve generated yourself.

It can also display GPX, KML or KMZ track logs, and can measure distances and angles between points or give you the coordinates of a point.

It uses PyGTK for its user interface, so you will need to PyGTK. Linux users can get it through their distro, or by compiling from source; Windows users can install it from pip. I don’t have a good answer for Mac users; possibly the easiest solution is to install GIMP (follow the install links from then munge paths so that other programs can find the PyGTK that comes with GIMP.

You can install it with pip install pytopo. Or run it from the project directory by running pytopo/ if you have the pytopo directory in your PYTHONPATH. But if you want to see pin images, create a directory /usr/share/pytopo and copy pytopo-pin.png into it. Or just have pytopo-pin.png in the current directory when you run pytopo.

The first time you run it, pytopo will create a ~/.config/pytopo directory for its configuration files, and a Maps directory for map data.

pytopo -h gives usage examples.

If you need custom maps., edit ~/.config/pytopo/pytopo.sites to add new map Collections (see examples in that file or on the project home page).

Code contributions appreciated!

Also in this project: ellie, a little script for reporting and plotting statistics (distance and elevation change) read from a GPX track log. More information:

Have fun!

Project details

Release history Release notifications

This version
History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pytopo-1.4.tar.gz (53.5 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page