Image browser and viewer
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Přemysl Eric Janouch b07fba0c9c
Make multi-monitor CM work better with xiccd
Let's assume the profile it picks is appropriate for all monitors.
1 month ago
docs Implement our own Preferences dialog 5 months ago
resources Distinguish removed files more prettily 6 months ago
submodules Move git submodules to a subdirectory 6 months ago
subprojects Make the jpeg-quantsmooth wrap work on Debian 1 year ago
tools Add a tool to find hot pixels 1 month ago
.clang-format Add clang-format configuration 2 years ago
.gitignore Update .gitignore 1 year ago
.gitmodules Move git submodules to a subdirectory 6 months ago
LICENSE Bump copyright years 8 months ago
README.adoc README.adoc: update package information 5 months ago
fiv-browse.desktop Use the X-GNOME-FullName desktop file key 2 years ago
fiv-browser.c Fix build under Cygwin 5 months ago
fiv-browser.h Move FivIoModel to its own compilation unit 6 months ago
fiv-collection.c Support opening collections of files 1 year ago
fiv-collection.h Support opening collections of files 1 year ago
fiv-context-menu.c Remove inappropriate ellipses 4 months ago
fiv-context-menu.h Add the information dialog to context menus 1 year ago
fiv-io-model.c Prevent a class of crashes in monitoring 4 months ago
fiv-io-model.h Process some GFileMonitor events 6 months ago
fiv-io.c Fix double colour management in the librsvg loader 5 months ago
fiv-io.h Colour-manage SVGs 5 months ago
fiv-jpegcrop.c Fix build under Cygwin 5 months ago
fiv-jpegcrop.desktop Add a lossless JPEG cropper 2 years ago
fiv-reverse-search Integrate online reverse image search 9 months ago
fiv-reverse-search.desktop.in Integrate online reverse image search 9 months ago
fiv-sidebar.c Update sidebar entries on change automatically 6 months ago
fiv-sidebar.h Move FivIoModel to its own compilation unit 6 months ago
fiv-thumbnail.c Colour-manage SVGs 5 months ago
fiv-thumbnail.h Process some GFileMonitor events 6 months ago
fiv-update-desktop-files.in Integrate online reverse image search 9 months ago
fiv-view.c Make multi-monitor CM work better with xiccd 1 month ago
fiv-view.h Add support for copying to clipboard 1 year ago
fiv.c Switch to a GAction-based menu 4 months ago
fiv.desktop Support opening collections of files 1 year ago
fiv.gschema.xml Move and extend the browser toolbar 8 months ago
fiv.manifest Automate Windows builds, add icons to executables 1 year ago
fiv.rc Automate Windows builds, add icons to executables 1 year ago
fiv.svg Improve the icon 2 years ago
fiv.wxs.in Centralize the project's URL 5 months ago
meson.build Add a tool to find hot pixels 1 month ago
meson_options.txt Add support for the Little CMS fast float plugin 6 months ago
msys2-configure.sh Add libjxl to Windows packages 5 months ago
msys2-install.sh msys2-install.sh: don't install the whole MIME DB 5 months ago
msys2-package.sh msys2-package.sh: fix iconv transliteration 5 months ago
tiff-tables.awk Extract some full-size raw previews without LibRaw 6 months ago
tiff-tables.db Move MPF constants and table to tiff-tables.db 6 months ago
tiffer.h Fix 32-bit build warnings 5 months ago
xdg.c Fix build under Cygwin 5 months ago
xdg.h Split out xdg.{c,h} 2 years ago

README.adoc

fiv

fiv is a slightly unconventional, general-purpose image browser and viewer for Linux and Windows (macOS still has major issues).

Screenshot of both the browser and the viewer

Features

  • Uses a compact thumbnail view, helping you browse collections comfortably.

  • Supports BMP, (A)PNG, GIF, TGA, JPEG, WebP directly, plus optionally raw photos, HEIC, AVIF, SVG, X11 cursors and TIFF, or whatever your gdk-pixbuf modules manage to load.

  • Employs high-performance file format libraries: Wuffs and libjpeg-turbo.

  • Makes use of 30-bit X.org visuals, whenever its possible and appropriate.

  • Has a notion of pages, and tries to load all included content within files.

  • Can keep the zoom and position when browsing, to help with comparing zoomed-in images.

Explicit non-goals

  • Editing—thats what editors are for, be it GIMP or Rawtherapee; nothing beyond the most basic of adjustments is desired.

  • Following the latest GNOME HIG to the letter—header bars are deliberately avoided, for their general user hostility.

  • Memory efficiency is secondary to both performance and development effort.

Aspirations

Show colours as accurately as hardware allows. Open everything. Be fast. Not necessarily in this order.

Packages

Regular releases are sporadic. git master should be stable enough. You can get a package with the latest development version using Arch Linuxs AUR, or as a Nix derivation.

Building and Running

Build-only dependencies: Meson, pkg-config, asciidoctor or asciidoc (recommended but optional)
Runtime dependencies: gtk+-3.0, glib>=2.64, pixman-1, shared-mime-info, libturbojpeg, libwebp, librsvg-2.0 (for icons)
Optional dependencies: lcms2, Little CMS fast float plugin, LibRaw, librsvg-2.0, xcursor, libheif, libtiff, ExifTool, resvg (unstable API, needs to be requested explicitly)
Runtime dependencies for reverse image search: xdg-utils, cURL, jq

$ git clone --recursive https://git.janouch.name/p/fiv.git
$ cd fiv
$ meson setup builddir
$ cd builddir
$ meson compile
$ meson devenv fiv

The lossless JPEG cropper and reverse image search are intended to be invoked from a file manager context menu.

For proper integration, you will need to install the application. On Debian, you can get a quick and dirty installation package for testing purposes using:

$ meson compile deb
# dpkg -i fiv-*.deb

Windows

fiv can be cross-compiled for Windows, provided that you install a bunch of dependencies listed at the beginning of msys2-configure.sh, plus rsvg-convert from librsvg2, icotool from icoutils, and msitools ≥ 0.102. Beware that the build will take up about a gigabyte of disk space.

$ sh -e msys2-configure.sh builddir
$ meson compile package -C builddir

If everything succeeds, you will find a portable build of the application in the builddir/package subdirectory, and a very basic MSI installation package in builddir.

Faster colour management

To get the Little CMS fast float plugin, youll have to enter MSYS2 and rebuild mingw-w64-lcms2 with the following change:

sed -i 's/meson setup /&-Dfastfloat=true /' PKGCONFIG

Documentation

For information concerning usage, refer to the user guide, which can be invoked from within the program by pressing F1.

Contributing and Support

Use https://git.janouch.name/p/fiv to report any bugs, request features, or submit pull requests. git send-email is tolerated. If you want to discuss the project, feel free to join me at ircs://irc.janouch.name, channel #dev.

Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9

License

This software is released under the terms of the 0BSD license, the text of which is included within the package along with the list of authors.