1. Qmapshack Dem
  2. Qmapshack Online Maps
  3. Qmapshack Set Trail Color Palette
  4. Qmapshack Garmin
  5. Qmapshack Mint
  • Downloads
  • Maps for Trucks
  • Using the Maps

Links of interest:

QMapShack is a trip planner application for macOS that enables you to create routes or tracks for your trips while using custom maps. Moreover, QMapShack can also be used to view GPS data captured. QMapShack is a versatile tool for GPS maps in GeoTiff format as well as Garmin's img vector map format. You can also view and edit your GPX tracks. QMapShack – GPS mapping (GeoTiff and vector) and GPSr management QMapShack provides a versatile open source tool for GPS maps in GeoTiff format as well as Garmin’s img vector map format. You can also view and edit your GPX tracks. The application can import, view, edit GPS data in various file formats including GPX.

Linux: you can use Qlandkarte GT, its sucessor QMapShack or MapEdit (the latter is for Windows, but works fine under wine). For all of them, first step will be to unzip downloaded file in the folder where you want to keep the maps. Files named «OpenStreetMap.exe» can be uncompressed with p7zip (7z e OpenStreetMap.exe). Welcome to QMapShack Use QMapShack to plan your next outdoor trip or to visualize and archive all the GPS recordings of your past exciting adventures. QMapShack is the next generation of the famous QLandkarte GT application. And of course it's even better and easier to use. If you want to download QMapShack, visit the download page.

OpenStreetMap mailing lists


Here you can read sent messages or subscribe to the list for any question about OpenStreetMap

Qmapshack Dem

Maps can be installed on Garmin GPS's, as routable maps that will give you turn by turn instructions to go to a given place (depending on device's specifications). It can also be seen in your computer, where you can calculate your routes, using MapSource or BaseCamp Garmin software, or the open source programs QLandkarte GT or QMapShack. With the topographic maps you can also calculate profiles for your routes.

Viewing the maps in your computer:

  • Linux: you can use Qlandkarte GT, its sucessor QMapShack or MapEdit++ (the latter is for Windows, but works fine under wine). For all of them, first step will be to unzip downloaded file in the folder where you want to keep the maps. Files named «OpenStreetMap_*.exe» can be uncompressed with p7zip (7z e OpenStreetMap_*.exe). To use the map in QLandkarte GT use File->Load Map menu. Then give the path to file AAA-XXX.tdb in the folder you uncompressed the map and then to file AAA-XXX.img. AAA is the ISO code of the country and XXX a three digit code different for each map.

    You can also use MapSource with wine and load maps running the auto-install file (wine OpenStreetMap_*.exe) or installing maps with MapSetToolKit (wine MapSetToolKit.exe) as described below:

    • Unzip downloaded file in a directory of your choice.
    • Run MapSetToolKit and click «Install» button placed at the bottom right corner. A dialogue will appear with some blank fields:
      • Registry name: introduce any name for your reference.
      • TDB file: browse to the file AAA-XXX.tdb you have downloaded.
      • Overview map: browse to the file AAA-XXX.img.
      • Maps directory: it is filled automatically after giving the path to the files above.
      • TYP files: same than with previous files, but searching for AAA-XXX.TYP file.
      • Click «Install», close the application and you are done. You now have the map available on MapSource and BaseCamp.

  • Windows: maps can be used with the open source programs Qlandkarte GT, its sucessor QMapShack or MapEdit++ or with Garmin software MapSource/BaseCamp. For the first three, you must start uncompressing downloaded file in the folder where you want to keep the maps. Files named «OpenStreetMap_*.exe» are uncompressed with 7zip. To use the map in QLandkarte GT use File->Load Map menu. Then give the path to file AAA-XXX.tdb in the folder you uncompressed the map and then to file AAA-XXX.img. AAA is the ISO code of the country and XXX a three digit code different for each map.

    In order to load maps in MapSource or BaseCamp, you just have to run the file named «OpenStreetMap_*.exe» or «Curvas_nivel_*.exe» and follow wizard steps.

  • Mac: you will need the programs Stuffit Expander, Garmin BaseCamp and Garmin MapManager installed in your system. To see the maps on BaseCamp you must proceed as follows:

    • Unzip downloaded file in a directory of your choice with Stuffit Expander.
    • Start Garmin MapManager. You will be prompted to select a file to open. Select the map file previously uncompressed and click «Open».
    • Click «Install» and quit MapManager when it has finished. The map is now ready to be used on BaseCamp.

Installing the maps in a GPS:

  • First of all, download file for GPS of the country you want from Downloads page and unzip it. You'll get a file called gmapsupp.img. The easiest way to have the map in your Garmin device is copying file gmapsupp.img in the external SD/micro SD card of the device, within a folder called «Garmin» (create it if it doesn't exist); in some models gmapsupp.img file must be copied into «Map» folder instead of «Garmin» folder (note «Map» folder may be hidden). This method is also recommeded because in case of any problem with the map, removing the card and restarting device will be enough to solve it. To copy it use a card reader (faster) or connect your device to the computer with a suitable cable, in 'Mass storage' mode (slower).

    Once copied, switch on the GPS, go to Settings>Map>Map Info and enable OpenStreetMap map. The way to activate the map varies from one model to other:

nüvi 300:

Under Map Setup, enter Map Info

Legend HCx:

Check OpenStreetMap map to activate it

Enter Map Setup

You have to activate each tile

  • If you don't have an external card, you can use any of the free programs sendMap or Qlandkarte; you can also use MapSource or BaseCamp from Garmin. In the last cases, you first have to load the map in MapSource/BaseCamp as explained above.

Using on Android devices:

If you want to see maps from this site on your Android mobile device, you can use OruxMaps app. For that, follow the steps below:

  • Download file for GPS of the country you want from Downloads page and unzip it. You'll get a file called gmapsupp.img. You can change the name to something more descriptive, such as MyCountry.img.
  • Copy that file into OruxMaps maps folder, by default oruxmaps/mapfiles/.
  • Open OruxMaps app, click on «Switch map» button and select previously saved file.
  • For a better visualization of maps, it is recommeded to go Global settings->Maps->Garmin maps settings, and uncheck Wpt labels background, Polygon labels background and Line labels background boxes.
  • Note: these maps are not routable on OruxMaps.

You can leave your comments on this page below:

Comments (59)

Topic: Use
4/5 (16)
Pawel Miciak (Warszawa, Poland)
I have a problem with installation of South Africa map on my Naigator VI. After unzipping folder there is no gmapsupp.img file. Could you tell me how to instal this map on my GPS?
Best regards,
Hi Pawel
I have checked South-Africa files and they all contain gmapsupp.img files. Are you sure you downloaded file for GPS, not the one for computer?
9th March 2021 4:51pm
Mustapha BENAISSA (Aïn Témouchent, Algeria)
Comment utiliser gmapsupp.img avec l'application 'Maps me' sur Android ?
'Maps me' permet de télécharger seulement 2 cartes du nord de l'Algérie mais pas celles du Sahara.
Je suis désolé, mais je n'ai pas d'expérience avec Maps.me.
7th February 2021 4:11pm
Mustapha Benaïssa (Aïn Témouchent, Algeria)
Merci pour votre réponse. J'ai trouvé la solution grâce à 'Hot Export Tool' de 'Humanitarian OpenStreetMap Team'.
8th February 2021 11:48am

Qmapshack Online Maps

I downloaded the DEM-maps for germany twice today. The first time I run the .exe-file and extracted the files to the suggested path then went on with the installation and also used the suggested path. Basecamp didn't show the DEM-map. The second time I saved the zip, run the .exe-file, always chosed the suggested paths and once again Basecamp didn't display any new map. It's a pitty that I spend so long trying to get it to work without any results. What can I do? Is there a way to manually .. Read More
I'm sorry to hear installer doesn't work for you. If you know the path where other maps are in your computer, you can just copy OpenStreeMap_Germany.gmap folder on that route. Depending on your operating system version, route will vary. You can look at some of the followings:
C:Program Files (x86)GarminBaseCampMaps
C:Program FilesGarminBaseCampMaps
C:Documents and SettingsAll UsersProgramDataGarminMaps
Please report if you get it to work and in which folder
6th May 2020 12:48am
Mat (Germany)
I finally got it to work today: since the installer didn't work I tried manually. to use the DEM-map the folder 'OpenStreeMap_Germany.gmap' needs to be moved into the folder where the basic map (the one which comes with basecamp) is stored! It does not work if it is in the same folder with the img-data for the 2D-maps. I've got a 64-bit system with windows 10. So what works for me is: the 2D-maps are installes in 'C:GarminMaps' the 3D-maps I downloaded (which is basically the .. Read More
Thank you very much for your reply. Sure it will help others with the same problem.
6th May 2020 12:41pm
Page 1 of 12

Add Comment

Powered by Commentics

QMapShack visualizes maps and tracks

Article from Issue 213/2018

QMapShack displays a wide variety of maps, making it easy to plan and manage your journeys.

QLandkart GT was once considered the best tool for displaying free maps on Linux and loading them on Garmin devices. Map enthusiasts were quite disappointed when the project came to a halt a few years ago, but fortunately, a number of developers quickly came together and launched a new project that extended the functions of QLandkarte.

QMapShack [1] lets you display map data from various sources, both online and offline. You can visualize, create, and edit GPX tracks and routes. Automatic routing is even possible. QMapShack combines information from different sources as a 'project,' which makes the program interesting for larger projects with several different elements. All in all, QMapShack is best described as a universal map planning and routing tool.

QMapShack Hands On

Qmapshack Set Trail Color Palette

Some Linux package repositories contain packages for QMapShack, but they might not have the latest version. See the box entitled 'Building QMapShack' for a brief look at how to build a QMapShack application yourself.

Most current distributions do not yet include the current QMapShack version 1.11.0 in the package sources, so you usually have to build the latest version of the application yourself. You need the Mercurial versioning system (version 4, or preferably 4.5) and CMake or CCMake v3.1. You also need GDAL, PROJ.4, and Routino, as well as QuaZIP and Qt v5.

Listing 1 shows the individual steps. First, clone the Mercurial repository to the local disk. Then create a working directory and change to the new folder. Now use CCMake to create a makefile: Create the configuration in the Ncurses interface by pressing C. Press G to create the makefiles and Q to end CCMake.

The make call builds the programs under bin/. This step creates several binaries: the main program qmapshack, the qmaptool utility for displaying maps, and the qmt_map2jnx and qmt_rgb3pct tools for converting data formats. sudo make install lets you import the program to /usr/local/ per the previously defined settings.


If necessary, you can update QMapShack directly from the cloned directory. Change back to the working directory and get the current code by typing:

Vectorize photoshop

Re-running make generates the new version, and sudo make install installs the update.

Installing QMapShack

QMapShack comes up with an intuitive user interface (Figure 1). The most important functions are in the menu and toolbar. QMapShack supports various online and offline map formats, especially VRT, TMS, WMTS, RMAP, and Garmin IMG (see the 'GMap' box).

Figure 1: Views and settings structure the QMapShack interface. The current version includes an easy-to-understand manual for setting up the program.

One of the special features of QMapShack is the support for Garmin IMG files. This features is limited to maps created by mkgmap for Garmin devices, but QMapShack handles them very well. Testing an IMG file with QMapShack works much better than trying to test it with a navigation device. In addition, you can use the IMG info offline with QMapShack (i.e., exactly where it is important: outdoors, where no Internet is available). Currently the developers are working on the possibility of integrating navigation devices, such as GPS coordinate generators, with QMapShack.


The setup process for QMapShack has improved considerably since the last version. In the past, you had to create special directories for many aspects of the program and enter them in the configuration. The current version simplifies this step: Using the Give me a path… link on the welcome page (Figure 1), you just enter a base directory, and all the required folders are automatically created by QMapShack and entered in the configuration. Keep in mind that 10GB or more can quickly accumulate below the base directory. You may therefore need to distribute the different directories across several drives.

Offline maps are configured using FileSetup map paths (Figure 2). When you get there, you will see the path under which the software saves the map tiles (in the standard configuration, the default is ~/.QMapShack/). The application only loads maps from the specified folder, not from its subfolders.

Figure 2: Before using QMapShack, you'll need to complete the configuration: First enter one or more directories, in which you will be saving map material.

If you do not have offline maps, you can also revert to online maps. For example, *.tms ('Tile Map Server') files are used with online map services. The button with the plus symbol lets you add maps and map directories. When you create new .tms files, they will appear in the left view window of QMapShack under the file name you specify. The program won't distinguish identical file names in different directories, so make sure you don't give two files the same name (Figure 3).

Figure 3: QMapShack can integrate several maps at the same time and display them one on top of the other.

In addition to real maps, QMapShack also displays arbitrary tiles (e.g., the aerial images provided by Microsoft on Bing). Integrating these images is not exactly intuitive, as Listing 2 shows. Please note that the legal situation is not clear for all map sources: Google does not allow the use of its tiles with programs other than Google Earth or its own online services. In addition, some of the maps are not very practical and only cover small areas or provide small zoom ranges. Others, such as the Alpine map, have a considerable scope and show many details.

Integrating Tiles

In addition to pure map data, QMapShack also supports the use of Digital Elevation Model (DEM) data, which refers to digital elevation or terrain data. A whole series of servers provide DEM data that you can integrate into QMapShack as online maps. The original documentation dedicates a separate chapter [2] to the topic of DEM maps.

Navigating in the map window is quite intuitive: Hold down the middle mouse button to move the displayed map section, and use the mouse wheel to scale the view size. (By the way, you can use the same feature when creating tracks and routes.)

Services such as OpenCycleMap place a watermark on tiles until the user registers and obtains an API key (see the box entitled 'API Key for OpenCycleMap.')

The OpenCycleMap server operated by Thunderforest.com (and some others) requires an API key to deliver tiles without an API Key Required message (Figure 4). You receive the key free of charge [6] after registration as part of a noncommercial project. After a confirmation email, you will find the API key in the service's dashboard.

Figure 4: A number of servers mark the maps with a watermark if you do not specify an API key.

You then need to configure QMapShack so that the application sends the API key to the OpenCycleMap tile server with every request. Open the OpenCycleMap.tms file in the map directory, which only contains a few lines of XML code (Listing 3). In the <ServerUrl> line, add the API key with ?apikey=API key before the closing </ServerUrl>. This modification gives you 'undisturbed' tiles from the OpenCycleMap server again.

Where the OpenCycleMap.tms file is located in the configuration files depends on several factors and can be specified with Setup map paths during configuration. When importing old data from QLandkarte, you will often find it below ~/qlandkartegt-Konto/OpenCycleMap.tms. If necessary, search for this file using find ~ -iname OpenCycleMap.tms.

Setting Up OpenCycleMap

Installing Maps

Manually installed maps must first be activated. To activate or deactivate a map, right-click on the map in the list and choose the function in the context menu (Figure 5). QMapShack always sorts enabled map views at the top of the list.

Figure 5: You can enable and disable maps via the context menu.

QMapShack lets you enable multiple maps at the same time. For example, you could superimpose an aerial image on a map display or vice versa. This feature allows completely new forms of 'realistic' map images, which, until now, could only be created by combining the maps with image-processing techniques.

The order of the maps plays an important role: Maps further down the list cover the maps above. The opacity of each activated map is controlled by a hidden dialog that opens after a mouse click on the small triangle in front of the map icon (Figure 6). The uppermost slider controls the opacity of the layer.

Figure 6: You can adjust the opacity of map displays to allow partial overlapping of maps and aerial photos.

You also need to pay attention to the two sliders below: Cache Size (MB) limits the amount of disk space used per map view, and Expiration (Days) automatically removes obsolete tiles and replaces them later when the region is called.

123Next »

Buy this article as PDF

Buy Linux Magazine

UK / Australia


Qmapshack Garmin

Related content

  • FOSSPicks

    We explore KDevelop 5.1, Riot.im, Cursynth, QMapShack 1.8, KWipe 2.1.3, Rapid Photo Downloader 0.9, Kakoune, VPG 0.2.8, Anbox (alpha), Terasology Alpha 7, and Mudlet 3.0.

  • GPS Tools

    Almost all manufacturers of GPS devices use proprietary formats to save routes, tracks, and waypoints. Vendors unfortunately rarely offer Linux software for uploading and downloading or processing the data. Four GPS editors keep Linux users on the right track.

  • Welcome

    RadioShack has dug itself into serious financial straits through the years by failing to stay with the times. When I was a kid, “Radio Shack” was a cool little store with lots of strange gadgets for electronics hobbyists and do-it-yourself home repair types. Any business that intentionally calls itself a “shack” is clearly trying to evoke an image, and the Radio Shack image was a preserve for the home inventor, laboring in a backyard shop, contentedly stringing wires and soldering connections amid piles of loose parts and circuit diagrams.

Qmapshack Mint

Please enable JavaScript to view the comments powered by Disqus.comments powered by Disqus