avis-imgv

avis-imgv is a fast, configurable and color managed image viewer built with Rust and egui. My goal was for it to be fast and to be able to adapt to any kind of hardware power through user configuration.

As of now it's only been tested in Linux, but I don't see why it wouldn't work in Windows/macOS. Configuration and cache directories are obtained through the directories crate which is platform-agnostic.

Changelog

Dependencies

• coreutils (for installation)
• sqlite
• exiftool
• libwebp for WebP
• libdav1d for AVIF if you enable it in cargo.toml

Build

With rust installed simply run:

cargo build --release

Install

Take a look at the install.sh script. Works in most systems but might need to be adapted. It's still in a rudimentary state and untested in most systems. Linux only for now.

Color Management

Color management is done through qcms.

As of now avis-imgv is shipped with three(sRGB, Adobe RGB and Display P3) profiles. A profile is chosen based on the exiftool tag "Profile Description" through a contains function. This is pretty lax as we can match more specific profiles like RT_sRGB with srgb. Open to suggestions on this behaviour. If no profile is matched an extraction will be attempted, although it isn't optimal for maximum performance. For this reason it is suggested opening a PR with additional profiles.

Output Profile is sRGB by default and only supports built in profiles. If you need extra profiles either open a PR or edit icc.rs and add whichever ones you need for your local builds. It can be configured in config.json.

sRGB and Adobe RGB(ClayRGB) were taken from elles_icc_profiles.

Supported Image Formats.

Supported image formats can be found here and here.

Default feature flag for the image crate is used by default.

Planned Features

• Allow to sort by name or date
• Theme Configuration

User Actions and Context Menu

avis-imgv supports adding user actions, both with a shortcut or a context menu when right-clicking on an image. User actions are simple commands which will be spawned and take in parameters.

As of now three parameters are supported:

• {} Full path
• {.} Path without extension
• {/} File name only
• {/.} File stem only
• {//} Parent path (without last slash)

It is recommended to use simple commands. If you need more complex behaviour, you can use a script and pass the path as a param.

Examples

• 'gimp {}' - Opens the file in GIMP.
• 'darktable {.}.RAF' - Opens adjacent Fujifilm raw file in darktable. This one will work best with a script that checks if the file exists.
• 'rate.sh {.}.RAF 5' - Run script which writes a base xmp with image rating. Provided in the examples folder.

Callbacks

After successfully executing a user action, we can choose to automatically run a function by specifying a callback. For this just add an entry under either a context menu or a user action. An example is provided under the example config.

• Pop - Removes the selected image from the collection
• Reload - Reloads the selected image
• ReloadAll - Reloads the entire collection

Configuration

Configuration file should be: ~/.config/avis-imgv/config.json. An example is provided under examples/config.json.

General

Gallery

Multi Gallery

Default Shortcuts

Shortcuts can be configured in the settings. Check examples/config.json for an example and keys.txt for valid keys and modifiers.

General

Single Gallery

Multi Gallery