Table of contents (abbreviated)

Do not edit - automatically created from DocMain!

• Quick start
• Schnellstartanleitung
• Быстрый старт
• Guía de Inicio
• Démarrage rapide

Basic usage

• Installing QMapShack
  • Install QMapShack
    • Windows
    • OS X
    • Linux
  • Compile instructions
    • Windows
    • Linux with QMapShack versions < 1.16.0
    • Linux with QMapShack versions >= 1.16.0
    • Linux with QMapShack versions >= 1.18.0
    • OSX
  • QMapShack AppImages for some Linux versions
    • Install QMapShack.AppImage
    • Build QMapShack.AppImage
  • Create Offline Documentation
    • Introduction
    • Installing and using QMS help browser
    • Installing and using local QMS Wiki copy
• Using QMapShack
  • Getting started
    • Add maps
    • Add digital elevation model
  • Commandline parameters
  • Install Maps & DEM Data
    • Organization of Maps & DEM
    • Installing Maps
    • Installing Raster Maps or DEM Data
    • Sources of Maps and DEM files
    • Maps & DEM
    • Control maps and DEM files
    • Sources of QMapShack-compatible maps and elevation data
  • Working with Projects
    • Handle GPX and QMS files
    • Search data
    • Geosearch
  • Data in QMapShack
    • Introduction
    • Sources of data
    • Save data
    • Data actions
    • Create and edit multi-point data)
    • Tracks
    • Routes and routing
    • Waypoints
    • Points of interest (POI)
    • Areas
    • Realtime data
  • Database
    • Workspace and Database
    • Add/Remove/Synchronize/Search a Database
    • Folders and Items
    • 'Lost & Found' Folder
  • GPS Devices
    • Supported USB protocols
    • Setup in QMapShack
    • Garmin additional memory card
    • USB mass storage specific
    • USB MTP specific
    • Handling in QMapShack
  • Text Editor Templates
    • Use a Template
    • Create a Template

Advanced usage

• Databases and projects
  • Organization of QMapShack data
  • Workspace and database windows
  • Summary projects and drop zones
  • General Actions
    • Working with databases
    • Working with projects
    • Working with project roadbook
• Details of map use
  • Adjustable map properties
  • Use of map visibility range
  • Adjustable elevation properties
    • Range of use of elevation data
    • Hillshading
    • Slope shading
    • Slope coloring
    • Elevation limit
    • Elevation shading
  • Map scale type
  • Projection and datum
  • Fullscreen display
  • Distance ruler
  • Synchronization of map views
  • Tips & tricks for online maps
    • Map service file formats
    • Basic procedure for using WMTS or TMS files
    • Overview of map regions mentioned on this page
    • Sources of WMTS and TMS map files
    • Tips for some widely used server types
    • Country-specific tips
  • Tips & tricks for raster maps, vector maps, and elevation data
    • Raster maps
    • Elevation data
    • Vector maps for Linux systems
• Overview of setup and configuration options
  • General options
    • Workspace setup
    • Waypoint icons setup
    • Toolbar setup
  • Map and DEM setup
    • Download and install
    • Map paths
    • Map cache path for online maps
    • DEM file paths
    • POI file paths
    • Map window display switches (toggles)
    • Map window display setup
    • Single map display options
  • Routing setup
    • Routino setup
    • BRouter setup
    • MapQuest setup
  • Further setup and configuration options
• Overview of toolbar actions

Getting Help

• Frequently Asked Questions
  • Configuring and running
    • Can I run several QMS instances at the same time?
    • Why does QMS ask for authorization on start-up (Ubuntu version)
    • How to resolve SSL certificate problems?
    • User-relevant QMapShack directories (Windows version)
    • How to change the GUI language?
    • Where does QMS save setup, configuration, and other information?
    • What to do if QMS doesn't start?
    • What is the recommended screen size?
  • Use of issue templates
    • Why was my bug report, feature request or pull request closed without further notice?
    • Why do you insist on using templates for issues?
    • But I always write decent descriptions in issues and hate templates?
  • Databases and projects
    • Why does QMapShack use a separate workspace.db to save data?
    • Why are there no checkboxes for data in workspace projects?
    • How to edit quickly the name of a project?
    • How to find the location of a database file used in QMapShack?
    • How to find database to which a project belongs?
    • Why does a database not allow creating new folders?
  • Data handling
    • How to create waypoint from POI (point of interest) in map?
    • Why are new waypoints always saved in a single workspace project?
    • Where are new waypoints and tracks saved?
    • How to find distance between waypoints?
    • Which track data is saved in GPX files?
    • How to access data from legacy Garmin devices?
    • What is the difference between speed and gpxtpx:speed?
    • How to remove DEM info from elevation graph?
    • How to edit tracks without losing track data?
    • How to compose a track from pieces of other tracks?
    • What is the difference between a clone and a copy of a QMS GIS object?
  • Routing
    • Why do route instructions use different languages?
    • Is there a possibility to choose the preferred road class when routing?
    • Does QMapShack/Routino support cross-border routing?
    • Does the Routino router support fly-as-a-bird routing?
    • What can be the reason for unexpected Routino routing results?
  • Maps
    • How to control visibility of POI info?
    • Why are waypoints shown with a blue dot icon?
    • How to find information about a position (a POI) on the Web?
    • How to move map to a certain location?
    • What is the difference between Copy position and Copy position (Grid)?
    • Is there a possibility to display small roads/tracks in a vector map without zooming in too much?
    • Does QMS support the use of single Garmin-style map tiles?
    • How to change the layout of vector maps?
    • Why is Google Terrain map a black-and-white map?
    • Which raster map formats are supported?
    • How to use Russian military and similar raster maps with QMapShack?
    • Why is a raster map not displayed?
    • How to find the location of a raster map?
    • Is it possible to use several VRT files?
    • When to use GDALWarp to get VRT file?
    • Is it possible to use EPSG codes for the coordinate system setup?
    • What requirements must a WMTS file fulfill?
    • How to use WMTS files without ResourceURL?
    • How to build the URL when using WMS via TMS?
    • What are the differences between the WMTS and the WMS approach in QMS?
    • How to get information about a WMTS or WMS service?
  • WMS Examples
    • Preliminary remarks
    • Summary of differences between WMS versions
    • TMS file template for EPSG:4326 and CRS:84
    • TMS file template for EPSG:3857
    • Examples
  • WMTS Examples
    • Preliminary remarks
    • TMS file template for EPSG:3857
    • Examples
  • Elevation (DEM) data
    • How to use DEM data in GeoTIFF or ESRI Grid ASCII format?
    • Why are there data gaps between adjacent DEM tiles?
  • OpenSource, Donation, etc
    • How does the QMapShack project understand the idea of OpenSource
    • But you provide binaries next to the source code, not just code
    • But I do not know how to compile binaries
    • I really want that feature, please add it
    • If I donate money can I buy a feature?
    • Can't I just donate money?
    • I want to donate! How?
• Troubleshooting QMapShack
  • Create a backtrace of a crash on Linux
  • Limitations of QMapShack for Windows, short: QMS
    • Qt comes without SSL support
    • GDAL comes without curl support
    • GDAL comes without support for exotic formats
  • Limitations of QMapShack for MacOS
    • Launching the app will display a pop-up window saying the app is damaged
    • curl SSL certificate problem
• Reporting a bug
• Requesting a feature
  • Preface
  • Things to include in your request
    • Implement it yourself
• Making a donation
  • Code
  • Translations
  • Documentation
  • Eye Candy

Developing QMapShack

• Coding Guideline
• Contribute Code
  • Process for Contributing Code
  • Commit Code
    • Fork the repository
    • Create a local clone of your fork
    • Configure Git to sync your fork with the original QMapShack repository
    • Keep your fork synced
    • Open a new branch
    • Commit changes locally
    • Push your commits
    • Rebase your branch
• Add translations
  • HOWTO enable/disable source translations extraction
  • HOWTO translate qmapshack.desktop (UNIX like only)
• Developing Documentation
  • Prerequisites
  • Remarks about the Markdown language
  • General rules for building GitHub fragment identifiers
    • Preliminaries and recommendations
    • General fragment identifier build rules
    • Differences for Google Chrome fragment identifier build rules
    • Overview of slugify rules
  • General recommendations for editing QMS Wiki pages
  • QMapShack-specific rules for Markdown use
  • Further recommendations for editing Wiki pages
  • Rules for new pages
  • Offline editing workflow
  • Recommendations for editing QMS Wiki pages
    • General recommendations for editing the manual
    • More recommendations
    • Workflow after editing page
    • Formatting rules
    • Comments on some script-created pages in the Appendix part
  • Maintaining the QMS Wiki Index
    • Preface
    • Short description of index maintenance
    • Structure of the raw index
    • Structure of the index
    • Consistency checks
    • Updating the index
    • Updating the navigation bars
    • Summary of recommended workflow for index maintenance
    • Further remarks
    • Some remarks on the design of the index page
  • Maintaining TOCs on Wiki pages
    • The AddToc.py script
    • Differences in rendering TOCs
• Discussion of extended activity system
  • Foot = 100
  • Cycle = 200
  • Bike = 300
  • Car = 400
  • Cable = 500
  • Swim = 600
  • Ship = 700
  • Aero = 800
  • Ski = 900
  • Public Transport = 1000 (formerly Train)
  • REMARKS and REFERENCES
    • Hiking
    • Running
• Playground - start your new Wiki page
• How to piss off open source developers

Appendix

• Hotkeys
• Main and context menu overview
• Complete table of contents
  • Basic usage
  • Advanced usage
  • Getting Help
  • Developing QMapShack
  • Appendix
• Glossary
• Index