Documentation Status https://travis-ci.com/joergbrech/mapfix.svg?token=3j1KXvuZPDDLeees2fes&branch=master https://codecov.io/gh/joergbrech/mapfix/branch/master/graph/badge.svg

MapFix lets you take photographs of maps and place markers on the image, whenever you know where you are. These markers are used to calibrate the image, so your current location based on your mobile phone’s GPS device is dispayed in the image.

Add markers by double tap. A minimum of two markers is required. The more you add, the better the calibration will be.



  • Corrects for orientation, scale and perspective
  • Many different map projections
  • Modify/Add/Delete calibration markers
  • Recalibrate manually
  • Lock a calibrated map


MapFix is in experimantal state and is currently available in the Play Store for registered alpha testers. If you are interested, send me your google username and I will add you to the list of alpha testers!


Contributions in the form of issues or PRs are more than welcome!


To run MapFix on Windows, OSX or Linux, you need the following python packages: kivy, click, piexif, pillow, unidecode, exifread, numpy, pyproj and plyer. These will automatically be installed when you setup MapFix.

Depending on the features that you want to use, you do require additional libs though.

  • pytest - implement readable tests without boilerplate-code
  • pytest-cov - generate an html coverage report
  • Sphinx - generate a readable html documentation
  • Buildozer - deploy your app to an Android mobile device


Clone the repository:

$ git clone https://github.com/joergbrech/mapfix.git
$ cd mapfix

Create a new virtual environment. Given that you are using virtualenvwrapper:

$ mkvirtualenv -a $(pwd) --system-site-packages mapfix


If you prefer to set up a fresh env, feel free to omit the according option. Chances are that you want to use your systems Kivy including all its dependencies such as Cython.

Install the app package in “editable” mode:

$ python setup.py develop


Launch the app via:

$ mapfix

Run the pytest test suite:

$ make test

Generate an html coverage report:

$ make coverage

Generate Sphinx html documentation:

$ make docs

Build an android apk with Buildozer:

$ make apk-debug
$ make apk-release

Deploy the app to your android device with Buildozer:

$ make deploy


Distributed under the terms of the MIT license, MapFix is free and open source software


If you encounter any problems, please file an issue along with a detailed description.

This Kivy app was generated with Cookiecutter along with @hackebrot’s Cookiedozer template.