Yet another image viewer.

CI	Build Status
Windows Build
macOS Build
Ubuntu Build

Summary

Pineapple Pictures is a lightweight image viewer that allows you view JPEG, PNG, GIF, SVG, PSD, KRA, XCF, TGA, HDR, AVIF and some other frequently used image formats files quickly and easily, and also provide a Stay-on-Top window setting that allows you pin the window so you can use it to pin a reference image at the top and then you can work with other software.

Get it!

Maintained by the original author

• GitHub Release Page
• SourceForge
• Archlinux AUR: pineapple-pictures | pineapple-pictures-git
• Itch.io Store

Maintained by contributors / curtain distro's package maintainers

• Debian (since bullseye) or Ubuntu (since 21.04): sudo apt install pineapple-pictures
• Nix / NixOS: pineapple-pictures (maintained by @wineee)

Help Translation!

Translate this project on Weblate!

Build it manually:

Current state, we need:

• cmake: as the build system.
• qt6 with qt6-svg and qt6-tools: since the app is using Qt.
• libexiv2: able to display more image metadata. (optional, but recommended)

Then we can build it with any proper c++ compiler like g++ or msvc.

Building it just requires normal cmake building steps:

$ mkdir build && cd build
$ cmake ..
$ cmake --build . # or simply using `make` if you are using Makefile as the cmake generator.

After that, a ppic executable file will be available to use. You can also optionally install it by using the target install (or simply make install in case you are using Makefile). After the build process, you can also use cpack to make a package.

The project will try to build with exiv2 when it's available at build time, if you would like to build the project without exiv2, pass -DEXIV2_METADATA_SUPPORT=OFF to cmake. The project will also not use exiv2 if it's not found, the EXIV2_METADATA_SUPPORT option can be useful if you have exiv2 but specifically don't want to use it.

Image formats supports rely on Qt's imageformats plugins, just get the plugins you need from your distro's package manager will be fine. For Windows user, you may need build and install the imageformats plugin manually, read the content below.

It's possible to build it under Windows, Linux, macOS, and maybe other desktop platforms that Qt is ported to. For platform specific build instructions, please read the related wiki page.

Note

Although there is a pineapple-pictures.pro file which can be used for QMake build, it's only for testing purpose and it doesn't have exiv2 support included. Using QMake to build this project is NOT supported, please use CMake if possible.

License

Pineapple Pictures as a whole is licensed under MIT license. Individual files may have a different, but compatible license.