To install Mapper follow the instruction on the Download page.


Mapper has a predefined (since list of map sources, so you don't need to configure anything. At first the screen is most likely black, so enable automatic downloading or use the Manage maps interface to download map tiles for a specific area.


To get the most out of Mapper you need a GPS. Many kinds of interfaces are supported, direct bluetooth, GPSd and a simulator for quick testing. Go to the GPS settings dialog to configure you GPS.


On N900, select: liblocation
On N810, select: GPSD Connection, address and port 2947
On N800 and 770, select: Bluetooth

Basic usage


You can drag the map with your mouse/finger/stylus. Double-clicking will put you at that location if GPS is disabled.

Right-mouse button (or tap-and-hold) will bring up a context menu.


A new track will be created automatically when you start Mapper. New points will be added to the track when you have a GPS fix and move around with your GPS. You can text marks points to tracks from the Track menu. Tracks can be saved and opened as .gpx files.


You can adjust when track points will be added, depending on the quality of the GPS fix.


Routes can be Opened (.gpx files) or downloaded using the Route download dialog. Mapper will automatically start tracking any loaded route and inform you what to do at any defined route way points, if there are any. Mapper in itself does not do routing at this time.

Point of interest

POIs or Point of interests can be displayed on the map if you have configured your database properly. You can search for POIs and get more information about them. You can also click on any POI icon the map view to get more information about the given POI.

Using OSM data

Mapper can use OpenStreetMap data to provide you with lot of information (and in the future, proper routing). OSM data provides you with POIs, Places and Streets.

Your location (street+place), if known, will be displayed on the screen. You can also search for streets and places.

Using CLI osm2db

Import data from planet.osm.bz2 or from a .osm file saved from JOSM. The file must be compressed with bzip2.

 osm2db planet.osm.bz2

The full planet database can be quite large and requires a lot of memory, so you can limit the import to a bounding box. This requires 4 parameters, min lat/lon and max lat/lon:

 osm2db planet.osm.bz2 60.0 18.0 70.0 33.0

From inside Mapper


 File -> Import OSM data 

and fill in the fields.


Configure the database path so it points to the file you created, using

 File -> Settings -> Map info

Map Database

Mapper uses database file for street and POI information. These can be made using the integrated import function or the CLI based osm2db program. Importing should always be done on a proper desktop machine, never on a tablet (only very tiny areas can be imported on the tablet). Reason for this is that the full OSM file is (currently) read into memory and then stored in a database file.

The database file(s) are compressed with bzip2 so you need to bunzip2 them before use.

Follow mapperproject on Twitter