Skip to content
A simplified touch optimized interface for QGIS
C++ QML Java Shell QMake CMake Other
Branch: master
Clone or download

Latest commit

m-kuhn Merge pull request #999 from suricactus/picture_source_desktop
Add option to change attachments on desktop build
Latest commit da485d9 Jun 3, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
.ci fix line texts Feb 17, 2020
.docker/testing Run ctest Oct 19, 2019
.github Delete package.yml Feb 24, 2020
.tx Remove incompatible translation directories Jan 7, 2019
3rdparty Improve legend icon matching and fix unwanted indent Jun 3, 2020
android Do not set KEEP_SCREEN_ON on startup Mar 26, 2020
cmake some fixes to CMake build (#1037) May 28, 2020
i18n Translate interface into Bulgarian. България на три морета! 🇧🇬 May 8, 2020
images Add missing images May 25, 2020
resources Nicer styles in advanced demo project (#1036) May 26, 2020
scripts adapt mac-deploy script for cmake builds (#1039) May 28, 2020
src Merge pull request #999 from suricactus/picture_source_desktop Jun 3, 2020
templates make gradle read build numbers from versions.pri Nov 16, 2015
test test Apr 30, 2020
.clang-format Adjust clang style Apr 1, 2020
.gitignore Ignore unwanted flies May 8, 2020
.gitmodules changed URL to submodule repositories Feb 2, 2016
.travis.yml Fix travis for out of repo prs May 24, 2020
CMakeLists.txt some fixes to CMake build (#1037) May 28, 2020
LICENSE Initial commit featuring some very basic map display and interaction Jan 16, 2015 Do not build test with qmake pro Oct 19, 2019 Update Jan 19, 2020
RELEASE_NAME new release name Piz Palü (#900) Mar 23, 2020
assets.pri Do not package world map Jan 17, 2020
config.pri.default Modernize config.pri Sep 26, 2018
keystore.p12.enc Upload pull request builds Feb 24, 2018
paths.pri cleaned files Mar 11, 2018
qfield.pri Load libexiv2 lib to fix crash on android platform (#834) Feb 14, 2020
qgis.pri fix include on mac Feb 19, 2020
sdk.conf bump SDK to 20200421 Apr 21, 2020
version.pri Fix version code string (#814) Feb 10, 2020

Read the documentation Join the chat at Release

QField for QGIS

A simplified touch optimized interface for QGIS.

Perfect for field work on portable touch devices.

Get it

Check the documentation

Get in Google play


QField is an open source project, licensed under the terms of the GPLv2 or later. This means that it is free to use and modify and will stay like that.

We are very happy if this app helps you to get your job done or in whatever creative way you may use it.

If you found it useful, we will be even happier if you could give something back. A couple of things you can do are

Get master (unstable) version

We automatically publish the latest master build to a dedicated channel on the playstore at You'll need to join the beta program ( to start getting the latest version.

Please remember that this is the latest development build and is not tested much.


For Android

Quick and dirty

Use the dockerized QField SDK.

# get the latest tag from
cd QField

git submodule init
git submodule update

docker run -v $(pwd):/usr/src/qfield$TAG /usr/src/qfield/scripts/ --rm

This will put the apk into a subfolder build-docker/out/build/outputs/apk

Go the hard way

Build OSGeo4A

cd QField

git submodule init
git submodule update

cp config.pri.default config.pri
# Edit config.pri

The advantage of this is, you will be able to build and deploy directly from QtCreator.

For Desktop

  • Get QGIS 2.99 (3.0) development libraries.
cd QField
git submodule init
git submodule update

cp config.pri.default config.pri
# Edit config.pri
  • open with QtCreator (installed during OSGeo4A installation)
  • hit build

On Mac

In Qt Creator > Projects > Build > In Build Environment

add the following variables:

  • QGIS_INSTALL_PATH: the same value than in the config.pri (could be /usr/local/opt/qgis3/ or the installation folder of a local build)

Invalid version number issue

If you get the error invalid version number in '-mmacosx-version-min=', you need to hardcode the minimum deployment target by setting version_min_flag = -m$${version_identifier}-version-min=10.10 in /usr/local/opt/qt/mkspecs/features/mac/default_post.prf.

One line command:

gsed -i "s/version_min_flag = -m\$\${version_identifier}-version-min=\$\$deployment_target/version_min_flag = -m\$\${version_identifier}-version-min=10\.10/" /usr/local/opt/qt/mkspecs/features/mac/default_post.prf

In Qt Creator > Projects > Run >

  • Check Use debug version of frameworks
  • Add a custom deployment step: _QField_SOURCE_DIR_/scripts/ with ${QGIS_INSTALL_PATH} as argument.
  • In Debugger settings, check Enable QML

Other issues

If you have any issue with qmake not finding the proper SDK, in /usr/local/opt/qt/mkspecs/features/mac/default_post.prf, replace $$QMAKE_MAC_SDK_PATH (3 occurences) by /Applications/

You can’t perform that action at this time.