Maps in XCTrack

TL;DR How to install the maps

  1. Download maps from OpenAndroMaps.
  2. Unzip the files and copy the resulting .map files to your phone to the XCTrack/Map/RoadMap directory.
  3. Start XCTrack, swipe down, select Customize, double-click the map widget and check the Display road map option.


XCTrack from version 0.7 (and alpha 0.6.0-675) supports road maps. It uses the VTM library. As a result it supports maps in a mapsforge format (the same as Locus, OruxMaps, Cruiser, etc.).

If you are using other software that supports mapsforge maps 1 2 you only need to configure XCTrack to look into the appropriate directory (Preferences > Maps > Road map > Select mapsforge files). When a directory is selected it will be recursively searched and all map files found will be used.

You can download the maps of the whole world from several map providers.


The library provides different built-in themes for the maps (Preferences > Maps > Road map > Map theme). We decided to use Zsolt’s Hyperpilot theme as a default map theme for white color schemes because it is optimized for flying.

However, you can use a custom one (Map theme > Custom file) and Hyperpilot is a good place to start for creating your own theme.

More about map themes:

Keep in mind that using large custom theme can prolong the initialization time of a map widget (see issue VTM#431 for details).

If you have created and tuned a theme for flying, let us know and we will happily host/link it!


XCTrack currently supports only one widget per page with the road map enabled. It is a library limitation, see issue VTM#194 for details.


If you have any problem with the road maps try the Cruiser application first. The Cruiser GL application uses VTM library too and it is developed by the VTM library developers. If the Cruiser GL application does not work either, we probably cannot fix it in XCTrack.

Help us