nomacs is a free image viewer for windows, linux, and mac systems.
Clone or download
Latest commit 2394779 Oct 15, 2018

nomacs - Image Lounge 🍸

nomacs is a free, open source image viewer, which supports multiple platforms. You can use it for viewing all common image formats including RAW and psd images. nomacs is licensed under the GNU General Public License v3 and available for Windows, Linux, FreeBSD, Mac, and OS/2.

Build Status

Build nomacs (Windows)

Compile dependencies

  • Qt SDK or the compiled sources (>= 5.2.1)
  • expat (needed for exiv2)
  • Exiv2 (>= 0.26)
  • OpenCV (>= 3.4) optional
  • LibRaw (>= 0.17) optional
  • QuaZip (>= 0.7.6) optional
  • Python (>= 3.6) for build scripts

Compile LibRaw

  • only needed if ENABLE_RAW is checked
  • clone libraw
  • checkout to the latest 0.XX-stable branch
  • follow the build instructions
  • in the nomacs CMakeUserPaths.cmake, add the build path to ${CMAKE_PREFIX_PATH}

Compile nomacs

  • copy CMakeUserPathsGit.cmake and rename it to CMakeUserPaths.cmake
  • add your library paths to the ${CMAKE_PREFIX_PATH} in CMakeUserPaths.cmake
  • Open CMake GUI
  • set your ImageLounge folder to where is the source code
  • choose a build folder (i.e. build2017-x64)
  • Hit Configurethen Generate
  • Open the Project
  • Right-click the nomacs project and choose Set as StartUp Project
  • Compile the Solution

If anything did not work

  • check if you have setup opencv (otherwise uncheck ENABLE_OPENCV)
  • check if your Qt is set correctly (otherwise set the path to qt_install_dir/qtbase/bin/qmake.exe)
  • check if your builds proceeded correctly

Build nomacs (Ubuntu)

Get the required packages:

sudo apt-get install debhelper cdbs qt5-qmake qttools5-dev-tools qt5-default qttools5-dev libqt5svg5-dev qt5-image-formats-plugins libexiv2-dev libraw-dev libopencv-dev cmake libtiff-dev libquazip-dev libwebp-dev git build-essential lcov libzip-dev

Get the nomacs sources from github:

git clone

This will by default place the source into ~/nomacs

Go to the nomacs/ImageLounge directory and run cmake to get the Makefiles:

cmake .

Compile nomacs:


You will now have a binary (~/nomacs/nomacs), which you can test (or use directly). To install it to /usr/local/bin, use:

sudo make install

note that you have to execute

sudo ldconfig

on your own after a successfully install

For Package Maintainers

  • Set ENABLE_TRANSLATIONS to true (default: false)
  • Build all officially supported plugins

Build nomacs (MacOS)

Install Homebrew for easier installation of dependencies. Install required dependencies:

$ brew install qt5 exiv2 opencv libraw quazip cmake pkg-config

Go to the nomacs directory and run cmake to get the Makefiles

$ mkdir build
$ cd build
$ Qt5_DIR=/usr/local/opt/qt5/ cmake -DQT_QMAKE_EXECUTABLE=/usr/local/opt/qt5/bin ../ImageLounge/.

Run make:

$ make

You will now have a binary (, which you can test (or use directly). To install it to /usr/local/bin, use

$ sudo make install