Prev (Manual) | Home | Manual | Index | (Windows with VisualStudio 2013) Next

---

Table of contents

• Install QMapShack
  • Windows
  • OS X
  • Linux
    • From distribution's package system
    • From Source
      • Prerequisites
      • Obtaining the Source
      • Compiling and Installing

---

Install QMapShack

Windows

For 64-bit Windows, there is a binary installer available in the download section. There is also an outdated version for 32-bit Windows. To get up-to-date 32-bit binaries it needs someone maintaining.

Hint: Never use non-ASCII characters in installation directory names (limitation due to external packages used by QMapShack)!

If you want to compile QMapShack for Windows have a look at "Compiling and Building QMapShack for Windows" in the source tree.

OS X

A binary bundle is available in the download section. The binary is built with compatibility for Mac OS X 10.14 and later.

The application can also be installed through cask (homebrew addition). Installing homebrew and cask, if not already done:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install caskroom/cask/brew-cask

Installing QMapShack (latest provided version):

brew cask install qmapshack

Update QMapShack to the latest version:

brew cask install qmapshack --force

Additional instructions about how to install can be found here

Linux

Check out your distribution's package system. Probably there is a binary package already.

QMapShack AppImages are provided for several Linux versions (Fedora, openSUSE, Ubuntu, ...). Detailed information about the supported versions including download links can be found here.

From distribution's package system

Many distributions come with a prebuilt version of QMapShack.

Installing via the official repository is the preferred way of installing QMapShack. Below is a (non-exhaustive) list of Linux Distributions shipping QMapShack:

• Debian
• Ubuntu
• OpenSUSE
• Downloads for Linux (deb, eopkg, rpm, txz, xz, zst) from pkgs.org
• archlinux (official release)
  • AUR (current development version)

Refer to your distribution's manual on how to install packages using the package system.

From Source

Prerequisites

To compile QMapShack, you need to have installed:

• Qt5 (at least 5.8)
• GDAL
• Proj4 (at least 8.2.0)
• Routino (at least 3.1)
• QuaZip
• CMake/Make
• a C++ compiler (supporting C++11)

Prefer installing those dependencies via the distribution's package system. You also need to install the development packages to build QMapShack

Additional instructions about how to install can be foundf

• for QMapShack versions < 1.16.0:
  • here for Ubuntu-14-04,
  • here for Ubuntu-18 and Ubuntu 20,
  • here for Linux Mint 19,
• QMapShack version >= 1.16.0:
  • here for Ubuntu version < 22.04,
  • here for Ubuntu version 22.04,
  • here for Linux Mint 20.1.
  • here for Fedora 33.

Obtaining the Source

The latest stable release can be downloaded here. You have to download and unpack the *tar.gz files.

Keep in mind: The cutting edge may be less stable and/or contain bugs

Clone the QMapShack repo into a folder QMapShack by executing:

git clone https://github.com/Maproom/qmapshack.git QMapShack

To update the code to the cutting edge change to the folder QMapShack and execute:

git pull

Compiling and Installing

Create a new directory build_QMapShack parallel to the source directory (if it does not yet exist)

mkdir build_QMapShack

And run:

cd build_QMapShack
cmake ../QMapShack
make

And install the application with:

sudo make install

---

Prev (Manual) | Home | Manual | Index | Top | (Windows with VisualStudio 2013) Next