Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.

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 status Downloads Crowdin

Build nomacs (Windows)

We assume you have an IDE (i.e. Visual Studio), python, git, and Qt installed.

Get all dependencies:

git submodule init
git submodule update

Project folders in 3rd-party will not be empty anymore. Now call:

python scripts/ "qtpath/bin"

This will build nomacs into build/nomacs. If you are using Visual Studio, you can then double-click build/nomacs/nomacs.sln. Right-click the nomacs project and choose Set as StartUp Project.

Build individual projects using:

python scripts/ "qt/bin" --project quazip,libraw --force

Developer Build

I like having a separate developer build (without submodules) that uses 3rd party libs already compiled. To do so you need to:

git submodule update --init --remote scripts 

# python scripts/ "C:\Qt\Qt-5.14.1-installer\5.14.2\msvc2017_64\bin" --lib-path C:\coding\nomacs\nomacs\3rd-party\build
python scripts/ "qt/bin" --lib-path "nomacs/3rd-party/build"

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 libquazip5-dev libwebp-dev git build-essential lcov libzip-dev

Clone the nomacs repository 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:

mkdir build
cd build
cmake ../ImageLounge/.

Compile nomacs:


You will now have a binary (~/nomacs/build/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

after a successful install.

Install the heif plugin for HEIF support.

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

Clone the nomacs repository from GitHub:

git clone

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

$ cd nomacs
$ mkdir build
$ cd build

For Homebrew on Intel models:

$ Qt5_DIR=/usr/local/opt/qt5/ cmake -DQT_QMAKE_EXECUTABLE=/usr/local/opt/qt5/bin/qmake ../ImageLounge/.

For Homebrew on Apple Silicon models:

$ Qt5_DIR=/opt/homebrew/opt/qt5/ cmake -DQT_QMAKE_EXECUTABLE=/opt/homebrew/opt/qt5/bin/qmake ../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

Build in Docker

We have created a docker image that best simulates the travis system (currently it's ubuntu xenial 16.04). To build nomacs in a docker, you have to create the image:

docker build --rm -f "Dockerfile" -t nomacs:latest empty-docker-dir

To deploy nomacs in a docker on your system, you can mount this directory using:

docker run --rm -it -v C:\\coding\\nomacs:/usr/nomacs nomacs:latest

If needed, you can upload the image:

docker login
docker tag nomacs diemmarkus/nomacs
docker push diemmarkus/nomacs:latest