Skip to content
JFritzle edited this page Feb 18, 2026 · 10 revisions

Prev (Getting started) | Home | Manual | Index | (Install Maps & DEM Data) Next


Table of contents


Commandline parameters

Switch Parameter Comment
-d enable debug output on the console¹
-f enable debug output and write it to file²
-c <filename> read/write the configuration from/to a configuration file
-l <code> QMapShack application locale (QMapShack version >= 1.20.0)
-n do not show splash screen
-v display version on the console¹ (QMapShack version > 1.19.0)
-h display help on commandline options on the console¹

¹ Debug, version and help output goes to channel stdout.
  When started from Windows cmd console, stdout is not attached to console and no output is written to console.
  To see console output however with Windows, start QMapShack from Windows powershell console
  by command <QMS installation folder>\qmapshack.exe <commandline parameters> 2>&1 | write-output

² Debug output filename
  Windows: %temp%\org.qlandkarte.QMapShack.log
  Linux: /tmp/org.qlandkarte.QMapShack.log
  macOS: ~/Library/Logs/org.qlandkarte.QMapShack.log

If you start the application without the -c option, the configuration will be stored wherever your system stores application configurations. Otherwise it is stored in <filename> during the QMapShack run.

Remark for Windows users:

There is no default configuration file. Instead, the default configuration is saved in the registry branch HKCU\Software\QLandkarte\QMapShack.

If the configuration does not yet exist, then QMapShack uses it's default configuration location mentioned above and the configuration is written to that location during the QMapShack run.

The configuration location keeps information about

  • the databases used,

  • the routing information used,

  • the map views with their structure,

  • other user interface properties.

Configuration files are standard INI-files and can be edited (be careful!).

The -c option is pretty handy if you start QMapShack from a memory stick and want to take your configuration with you.

It is handy too for the definition of a top level basic data structure. The user can define and use different configuration files and in doing so define separate data and map sets (e.g. referring to different countries). As a consequence QMapShack starts much faster due to the fact that less map data must be loaded.


Prev (Getting started) | Home | Manual | Index | Top | (Install Maps & DEM Data) Next

Clone this wiki locally