PhotoQt Image Viewer -

Name Last Update
CMake Loading commit data...
build Loading commit data...
cplusplus Loading commit data...
flatpak Loading commit data...
icons Loading commit data...
img Loading commit data...
lang Loading commit data...
qml Loading commit data...
qmlresources Loading commit data...
windows Loading commit data...
CHANGELOG Loading commit data...
CMakeLists.txt Loading commit data...
COPYING Loading commit data...
INSTALL Loading commit data...
README Loading commit data... Loading commit data...
for_photoqt_desktop_FULL Loading commit data...
for_photoqt_desktop_QT Loading commit data...
img.qrc Loading commit data...
lang.qrc Loading commit data...
photoqt.appdata.xml Loading commit data...
windowsicons.rc Loading commit data...

PhotoQt v1.5.1

Copyright (C) 2011-2017, Lukas Spies ( License: GPLv2 (or later) Website:

PhotoQt is a fast and highly configurable image viewer with a simple and nice interface.


  • Qt >= 5.3
  • CMake (needed for building PhotoQt)

Make sure that you have the required Qt modules installed:
QtQuick, QtQuick.Controls, QtQuick.Controls.Styles, QtQuick.Layouts, QtQml.Models, Qt.labs.folderlistmodel, Qt.labs.settings, QtGraphicalEffects, QtMultimedia.
Dependencies, that are needed by default, but can be disabled via CMake

  • Exiv2
  • GraphicsMagick
  • LibRaw


On some systems you also need the *-dev package for compiling (e.g. exiv2-dev - names can vary slightly depending on your distribution). These files usually can be uninstalled again after compilation is done.


Even though GraphicsMagick initially started as a fork of ImageMagick (back in 2002), trying to build PhotoQt with ImageMagick wont work!


These dependencies are not needed for compiling PhotoQt. However, if they are installed, you can set PhotoQt (via settings) to make use of them for improved XCF/PSD support.


  1. cd build/

  2. cmake ..

    # Note: This installs PhotoQt by default into /usr/local/{bin,share}
    # To install PhotoQt into another prefix e.g. /usr/{bin,share}, run:

    cmake -DCMAKE_INSTALL_PREFIX=/usr ..

    # PhotoQt makes use of the libraries Exiv2, GraphicsMagick ("gm") and LibRaw.
    # You can en-/disable them with the following options:
    # (if you don't specify anything, it asumes a value of ON)


    # You can combine them in any way you want.
    # The following option equates to setting the three above options to OFF


    # If CMake aborts with the error that it can't find Exiv2 and/or GraphicsMagick and/or LibRaw,
    # but you're certain that the header files are available, then
    # you can pass their locations to CMake:


  3. make
    # This creates an executeable photoqt binary located in the ./build/ folder

  4. (as root or sudo) make install

    # This command:

    1. installs the desktop file to share/applications/
    2. moves some icons to icons/hicolor/
    3. moves the binary to bin/


If you want to uninstall PhotoQt, simply run make uninstall as root. This removes the desktop file (via xdg-desktop-menu uninstall), the icons and the binary file. Alternatively you can simply remove all the files manually, that should yield the same result.