Installation

Prebuilt binaries

Every version is built by the project’s CI and published on the GitLab Releases page, one archive per platform:

Each archive also holds README.md, the two license files and THIRD-PARTY-LICENSES.html, the list of the third-party licenses that apply to the binary (see Licenses below). A SHA256SUMS.txt file published with each release lets you check the downloads.

There is no installer: extract the archive and run the program. On macOS, move the .app to /Applications if you like.

The binaries are not signed with a paid certificate, so each operating system warns about them on first launch. The sections below explain how to get past that.

macOS

The app is ad-hoc signed but not notarized by Apple, so Gatekeeper blocks it the first time you open it.

1. Open the app once. macOS refuses to open it and shows a warning; close the warning without moving the app to the Trash.
2. Go to System Settings → Privacy & Security (System Preferences → Security & Privacy → General on macOS 12 and earlier), scroll down to the message about the app, and click Open Anyway.
3. Confirm. From then on the app opens normally.

Alternatively, remove the quarantine flag that macOS put on the download, from the Terminal app. Replace the placeholder with the path of the app; dragging the app from the Finder onto the Terminal window types its path for you:

xattr -dr com.apple.quarantine /path/to/the/app

Windows

SmartScreen may show “Windows protected your PC” on first launch. Click More info, then Run anyway.

Linux

The program needs:

• A graphics driver with Vulkan or OpenGL support. The interface is drawn on the GPU.
• An X11 or Wayland session. Both are supported by the same binary; the client libraries are loaded at run time and are part of any desktop installation.
• xdg-desktop-portal for the folder picker, together with a backend that provides the file chooser, for example xdg-desktop-portal-gtk, xdg-desktop-portal-gnome or xdg-desktop-portal-kde. GNOME and KDE Plasma install them by default. On minimal window-manager setups you may have to install them yourself; xdg-desktop-portal-wlr alone does not provide the file chooser. If no portal works, the folder picker falls back to zenity when it is installed; with neither, the Open folder… dialog cannot appear.

Building from source

With rustup installed:

git clone https://gitlab.com/julienbltt/image-toolkit.git
cd image-toolkit
cargo run --release

The repository pins its Rust version in rust-toolchain.toml, and rustup installs it on first use. The runtime requirements above apply to your own builds too. See Building from source for details.

Licenses

Image Toolkit is licensed under MIT OR Apache-2.0, at your option.

The release binaries include third-party code under other licenses. THIRD-PARTY-LICENSES.html, in every release archive, names every dependency compiled into the binary, with its license. In particular, rawler, which reads the RAW files, is licensed under the LGPL-2.1 and is statically linked; since the complete source code of Image Toolkit is public, you can rebuild it against a modified version of rawler, as the LGPL allows.

The lens corrections planned for 0.8.0 will add lensfun: the library is licensed under the LGPL-3.0 and its lens database under CC BY-SA 3.0.