Openmtbmaps and Qlandkarte GT (Linux)

Note: As Qlandkarte GT is not developed anymore since a couple of years - I actually recommend you to use Basecamp 4.6.2 via WineHD instead. Also Mapsource 6.16.3 can be use via WineHD.

What is Qlandkarte GT? Well it's an open source universal offline map viewer. It can both display Raster maps and Garmin vector .img maps. You can even overlay your raster maps with vector maps. As Qlandkarte GT is constantly improving, I recommend you to always use the latest version. Qlandkarte GT is available for all major desktop platforms (Linux, Mac OSx and Windows).

Forthmost of course, Qlandkarte GT will be of interest to Linux users in conjunction with Openmtbmaps and Velomaps, as there is no Garmin program for Linux natively (Mapsource runs under Wine though)....



Preparations, Downloads Installing

1. Install and get Qlandkarte GT from - Click on Download then select your OS

2. If not yet installed, make sure you can unpack lzma2 files. The Openmtbmap .exe Windows files are simple lzma files (though I plan to change that to lzma2 sometimes soon).

apt-get install 7z or aptitude install 7z

3. Download the Openmtbmap or Velomap of your choice from here: respectively

4. Put the maps into a directory of your choice - e.g. openmtbmap_austria for the the austrian openmtbmap and then unpack it

7z x -y -openmtbmap_austria mtbaustria.exe

Alternatively if you prefer not to use commandline, rename mtbaustria.exe to mtbaustria.7z, and then right click it in your file manager to unpack it!

5. For some maps, you need to unpack the contourlines too. Make sure all 6*.img and 7*.img as well as *.tdb and mdr.img and *.typ files, are in the same folder - and not in subfolders.
Here is a screenshot of what needs to be in a single folder (this plus 6*.img - the example is from the Latvia Map) - you can see 6*.img - theese are the map files. 7*.img - theese are the contourlines and some more files like *.TYP - which are defining the layout of the maps, or mapset* files, which are like the index for the maps.



Using the Maps with Qlandkarte GT

First of all, in case of questions - here is a good help: QLandkarte_GT Help


1. We click on Load Map (in German Karte Öffnen):


2. We have to select the main map file - This is always the *.tdb file. Note that there are three *.tdb files:

mapsetc --- Theese are the mapset files which integrate the contourlines into the map
mapsetx --- Theese are the mapset files which do not integrate the contourlines into the map
mapsetz --- Theese mapset files are for you if you want to have a separate contourlines only map.

The normal way is to load the map - using the mapsetc.tdb file - however you could also load the map without contourlines (mapsetx) and load the contourlines as a separate map (mapsetz).

Here I select mapsetc.tdb and click on open to continue.


3. Now we have to select the according overview map. You need to choose the same mapset? as chosen before. Therefore I click on mapsetc.img and click on open.


4. Voila - that's it. You can see the map added to your list of vector maps in the left window. If you load more maps, they will be added there. Now you can zoom into the map.


5. Zooming in the map appears.


6. Choosing the map layout and map detail for a given zoom level:

When you look in the lower right edge of the Qlandkarte GT window - you find some dropdown menus.

Detail: If you select a + value, more information is shown even while zoomed out further. If however too much details obstruct your view, or make loading the map slow, you can set it to "-"

Night: Openmtbmaps have no separate night layout - hence this won't change anything.

Unspecified/Language: Please leave this on Unspecified - I have not translated all the relevant files. If you select German or English - then some POI or lines won't show labels.

easy/Layout: This is the most interesting dropdown menu - here you can quickly change the layout - for working with Qlandkarte GT - I recommend trad?? (?? stading for the country prefix).


7. After we have chosed tradlv - the map now looks like this:

The Openmtbmap maps have 5 Layouts - choose according to your needs:

*clas --- Classic - optimized for Vista/Legend/edge_705 series
*thin --- thinner tracks and pathes - optimized for Gpsmap60/76 or Dakota series
*wide --- high contrast layout, like classic but with white forest and wider streets/lines - optimized for Oregon/Colorado dull displays
*easy --- Simple Layout with (nearly) no additional info over traditional topo maps. Same width as Classic. No add. lines for (mtb:scale(:uphill)/cycleway=*/sac_scale)
*hike --- Similar to easy but fully optimized for hiking. 

*trad --- Mapsource/Basecamp/Qlandkarte_GT/Desktop --- General big screen/resolution layout. It is the easiest to understand layout and optimized for big screens (800x600 or bigger). Street colors similar to google maps. Medium contrast - therefore bad for GPS use.


Updating the maps:

Simply unpack the new .exe, and overwrite the old data - before Qlandkarte opens, it will ask you again to select the overview map again - so usually (see instructions above) you will select mapsetc.img and click on open to continue.


Working with the maps and uploading them to your Garmin GPS:

I might in future add some more info here - for right now, please read the Qlandkarte online help:

QLandkarte_GT Help

16 comments to Openmtbmaps and Qlandkarte GT (Linux)

  • r0ckarong

    So apparently the format has changed. When I unpack the mtbgermany.exe file I do not get the same files that I used to and I can not apply mkgmap on them. What do I need to do now to build a map compatible for my device (Garmin eTrex 30x)?

    • extremecarver

      Sorry I have not found time to explain this- use the linux link behind the mtbgermany.exe – The installer is now over 2GB in size so I had to change from NSIS to NSISBI (a branch/fork of NSIS). Sadly it’s not possible to unpack the .exe files anymore. Therefore I now upload for all those countries a linux version. It’s linked right behind the normal version. Currently this applies to Germany, France, Africa continent map and Russia. As long as those files are <4GB I will continue using NSISBI. If they go even bigger I will put the mapdata into a separate download like with the Europe and Asia continent map.

  • Ciliberto

    Basecamp under wine does not work. I had a lot of problems in installing dot46.Net and I finally renounced.
    Qlandkarte is very nice and I do not understand why the stopped the updating.
    QMapshack has nice idea but it works very badly.

    Finally I find that Qlandkarte is in my oipinion the best and the easiest to use in Linux.
    If somebody has suggestions on how to use basecamp I am happy to hear.

  • petrus82

    Hallo Felix,

    vielen Dank für Deine Arbeit für! Ich möchte gerne meine Tourenplanung mit QMapShack (dem Nachfolger von QLandkarteGT) machen. Leider sind in der openmtbmap keine .osm.pbf Dateien für Routino und die originären .osm.pbf (z. B. Download über führen unter Nutzung z.B. des Auto-Profils dann tatsächlich vorwiegend über Landstraßen, was ja bei der Routenplanung mit Basecamp anders ist. Gibt es eine Möglichkeit das Routing für Routino anzupassen?


    • extremecarver

      osm.pbf ist nicht für Routing oder irgendwas anderes als zum Karten erstellen gedacht – das sind die OSM Rohdaten – damit zu routen macht keinen Sinn. Routino kenne ich nicht,

      • petrus82

        Mir ist schon klar, dass die .osm.pbf Dateien nicht primär für das Routing gedacht sind, schließlich habe ich gerade in QMapShack eine Routino Datenbank auf Grundlage der .osm.pbf Dateien erstellt. Routino ermöglicht ein offline Routing auf der Grundlage von Profilen und kann damit verschiedene Wegearten unterschiedlich priorisieren. Ich nehme mal an das funktioniert in Basecamp ähnlich. Für mich ist die Frage, warum man mit einer Autokarte über eine Landstraße im Profil “Auto und Motorrad”, in der Openmtbmap mit dem gleichen Profil über einen schönen Singletrail geroutet wird.

  • solitone

    Hi extremecarver,

    are you aware that QMapShack (the successor of QLandkarte GT) doesn’t support .tdb files? It only supports the consolidated gmapsupp.img file, as Garmin devices do. The major drawback with this is that with QMapShack you can’t select a submap and export that submap to a reasonably sized gmapsupp.img file that you can upload to your Garmin device.

    I’ve commented on an bitbucket issue on this:

    If you will, please add your opinion there as well. I believe it would be a pity not having an open source alternative to extract small sub maps from large collections like the Europe map.


    • extremecarver

      well – I think Oliver said he will keep Qlandkarte GT working for this should something break – but Qmapshack won’t support garmin maps anymore. And yeah – I know it’s the only solution on Linux (besides using old Mapsource via Wine) to create gmapsupp.img
      I asked Oliver a long time ago already via private email.

  • pete.dawgg

    ich teile gerne meine guten Erfahrungen, die ich mit Qlandkartegt und Linux gemacht habe.

    1. 7zip steckt in vielen Distris in einem Paket, das p7zip, Peazip oder so ähnlich heisst. Das kann im Normalfall auch “exe”-Dateien auspacken und enthält meist auch ein GUI. Wine sollte also nicht nötig sein.

    2. Ich glaube, dass QLandkartegt keine Karten hochladen kann; Tracks, Routen und Punkte gehen bei meinem Vista HCx, aber für Karten fehlt die Auswahlmöglichkeit. Das ist aber nicht schlimm, denn der Transfer solch riesiger Dateien über den USB1.1(?)-Anschluss/das langsame Transferprotokoll des Gerätes würde eh viel zu lange dauern.

    3. ich habe ein kurzes Script geschrieben, dass die Karten-Updates nicht-interaktiv runterlädt und auspackt; es hat ein paar persönliche Einstellungen/Pfade von meinem Rechner drin, lässt sich aber leicht anpassen. Gerne kann ich es generisch(er) machen oder mit Parametern/Variablen versehen und weitergeben.
    Ich habe auch noch eins, das “garmin.img”s für alle deutschen Bundesländer erstellt (für Oruxmaps auf meinem Telefon; einzeln pro Bundesland, weil das Telefon schon ewtas älter ist.) Auch das lässt sich beliebig anpassen.

    4. Ich fände es nett, wenn es auf den Download-Servern pro Datei einen Timestamp oder eine Prüfsumme (o.ä.) gäbe, denn dann liessen sich die Downloads vollständig automatisieren bzw. die Dateien würden nur heruntergeladen, wenn sie neuer sind.

    Und wie immer: Danke für die Super-Karten und die guten Anleitungen!

  • Radlindianer

    So mache ich das, vielleicht hilft es dem ein oder anderen:

    1. QLandkarte GT installieren
    2. Karten downloaden von
    3. .exe-Dateien entpacken (geht bei mir, Ubuntu 14.04, nicht mit 7z aber mit Wine. Einfach die .exe-Datei doppelklicken.
    4. zu surfen und die neueste Version von mkgmap downloaden.
    5. die gepackte Version von mkgmap entpacken
    6. Das Programm mkgmap benötigt Java 1.6 oder höhere Version um zu laufen
    7. alles im Ordner mkgmap in den Ordner mit dem Kartenmaterial kopieren
    8. mit der Shell in den Ordner wechseln
    9. Die MB aller vorhandenen .img-Dateien zusammenrechnen, grob. Bei mir (DE) ca. 2400 MB
    10. In der Shell eingeben:

    java -jar -Xmx2500M mkgmap.jar –family-id=6371 –index –description=”mtbmap_germany_srtm” –series-name=”mtbmap_germany_srtm” –family-name=”mtbmap_germany_srtm” –product-id=1 –gmapsupp 6*.img 7*.img tradde.TYP

    Dies sind die Erklärungen für die Shell-Eingabe:
    –index (if you are low on memory, or don’t want to have address search enabled for the map, simply remove it)
    -XMx2500M — here you can set the memory available to java. If you don’t need an address index 128 is enough. Otherwise it needs to be at minimum of around the total size of all 6*.img and 7*.img files. >> Also bei mir auf 2500M gestellt.
    “mtbmap_germany_srtm” — this is just an example name. exchange it with a name of your choice so you know which map is active/not active on your GPS device.

    11. Die Datei, die erstellt wird heißt am Ende: gmapsupp.img Sie ist bei mir, ganz Deutschland, 2,2 GB groß. Diese Datei wird auf die Speicherkarte des Garmin-Gerätes (bei mir Vista HCx) in den Ordner “garmin” kopiert. Das geht am besten, indem die Speicherkarte aus dem Gerät genommen wird und in einem Speicherkarten-Adapter direkt mit dem PC verbunden wird. Auf der Speicherkarte einen Ordner “Garmin” anlegen, und die gmapsupp.img dort hineinkopieren.

    12. Speicherkarte wieder in das GPS einlegen. Fertig!

  • fergus

    ich finde das tutorial auch super, aber genau der Punkt mit dem hochladen der Karten suche ich.
    Ich habe alle Karten in QL GT und möchte die auf ein android-Tablett mit locus bringen.
    Hier im Forum habe ich zwar einiges darüber gelesen, es aber schlichtweg nicht verstanden.
    kann mir das jemand genauer erklären

    • extremecarver

      Für Locus musst du einfach nur eine gmapsupp.img generieren – als wäre es ein Garmin GPS. Auf Linux ist das mit QLGT sicher am einfachsten – auf Windows würde ich dir Mapsource/Mapinstall via Basecamp empfehlen – dann siehe Karten senden Tutorial.

Leave a Reply