#graphics #image #viewer

app oculante

A minimalistic image viewer with analysis and editing tools

59 releases

new 0.6.56 Mar 23, 2023
0.6.52 Feb 19, 2023
0.6.35 Dec 30, 2022
0.6.22 Nov 13, 2022
0.2.3 Jun 15, 2020

#40 in Images

Download history 83/week @ 2022-12-02 240/week @ 2022-12-09 88/week @ 2022-12-16 56/week @ 2022-12-23 92/week @ 2022-12-30 109/week @ 2023-01-06 146/week @ 2023-01-13 17/week @ 2023-01-20 20/week @ 2023-01-27 310/week @ 2023-02-03 310/week @ 2023-02-10 238/week @ 2023-02-17 8/week @ 2023-02-24 20/week @ 2023-03-03 6/week @ 2023-03-10 34/week @ 2023-03-17

70 downloads per month

MIT and maybe GPL-3.0-or-later

7.5MB
5K SLoC

Oculante

A no-nonsense hardware-accelerated image viewer

Oculante's vision is to be a fast, unobtrusive, portable image viewer with wide image format support, offering image analysis and basic editing tools.

  • Free of charge, bloat-free, ad-free, privacy-respecting open source application
  • Fast opening of images, fast startup
  • Available for Win, Mac, Linux and NetBSD
  • Supports a wide range of images and SVG
  • Caches images for faster reloading
  • Can display unassociated channels correctly (If your image uses alpha and color channels to encode data in a special way)
  • Lets you pick pixels, display location and color values
  • Offers basic nondestructive editing: Crop, resize, paint, contrast, HSV, rotate, blur, noise, ...
  • SIMD-accelerated image editing

OSX NetBSD Ubuntu Windows ARM v7

GitHub all releases Crates.io

Screenshot

Flipbook

With configurable caching, Oculante can quickly step through image sequences: Screenshot

Inspection

Get info about pixel values and position, with precise picking: Screenshot

Network

Raw image data can be sent to Oculante and will be loaded if possible, regardless of format. Streams of images will be played as a video. You can send images from cameras or headless systems such as a Raspberry Pi for example. Screenshot

Correct color channel display:

Images may contain color information that is masked by the alpha channel. Although it is present you will not see it since usually RGB values are multiplied with the A channel when displayed. Oculante allows you to inspect all channels individually and see color data without transparency applied. Screenshot

Installation

Oculante needs no installation, as it is just one executable. Just download it for your system from the releases tab (https://github.com/woelper/oculante/releases). In order to open images you can configure your system to open your desired image formats with oculante, drag them onto the executable or into the window. Right now the executables are roughly 12MB.

On NetBSD, a pre-compiled binary is available through the native package manager. To install it, simply run

pkgin install oculante

Features

Image format support:

  • bmp
  • gif (animation support and correct timing)
  • hdr, tonemapped
  • ico
  • jpeg
  • png
  • pnm
  • tga
  • avif
  • tiff
  • webp (via libwebp-sys - image had very limited format support)
  • farbfeld
  • DDS (DXT1-5, via dds-rs)
  • psd (via psd)
  • svg (via resvg)
  • exr (via exr-rs), tonemapped
  • RAW (via quickraw - nef, cr2, dng, mos, erf, raf, arw, 3fr, ari, srf, sr2, braw, r3d, nrw, raw). Since raw is a complex field without true standards, not all camera models are supported.

Platform support:

  • Linux
  • Mac
  • Windows
  • NetBSD

Misc features

  • Image info (i) (pixel position, color info)
  • Threaded image loading
  • Fit image to view
  • Window can be configured to be always on top - helpful to keep image as reference
  • Low cpu usage
  • Non-destructive painting and operator stack - edit very large images interactively by scaling them down first, then deleting the downscale operator once you want to export.
  • Metafile support: Edit stack can be saved into a metafile which will be auto-loaded and applied when loading the original.
  • Pretty fast startup / loading time
  • Configurable image caching (Select how many images to keep in memory)
  • Display unassociated / unpremultiplied alpha (u)
  • Lossless JPEG editing: Crop, rotate, mirror without recompressing data
  • Network listen mode: Start with oculante -l port and oculante will switch to receive mode. You can then pipe raw image data to that port, for example using nc localhost 8888 < image.jpg. Image types will be auto-detected. If you pipe image sequences, these will be played at about 30 fps so you can pipe videos to it. This can be useful to visualize images from a headless system.

Misc examples:

EXIF display

Screenshot

Extract a signature

signature example

Roadmap:

  • Image loading time is still worse than feh or xv This is now very close, in particular after switching to turbojpeg
  • Tests and benchmarks
  • Image rotation (and read EXIF for that)
  • Investigate PVR / ETC support
  • Brighness/gamma adjust for HDR
  • SVG support
  • Custom display for images with unassociated channels
  • EXR support
  • Read next image(s) in dir and advance to them

Privacy pledge

Oculante does in no way collect or send anonymous or non-anonynmous user data or statistics. There are only two instances where oculante interacts with the network, and both never happen without being triggered by the user:

  • Updating the application (must be triggered manually from settings)
  • Listening for incoming images on a custom port (must be set on command line)

In addition, the only data saved locally by the application is:

  • UI accent color
  • Keybindings
  • Vsync preferences
  • Keep view offset/scale
  • Whether the directory index bar is displayed

Attribution

Test / benchmark pictures:

https://unsplash.com/@mohsen_karimi

https://unsplash.com/@frstvisuals

Building

Linux:

sudo apt-get install libxcb-shape0-dev libxcb-xfixes0-dev libgtk-3-dev libasound2-dev nasm cmake libssl-dev

Win: Install Nasm from https://www.nasm.us/pub/nasm/releasebuilds/2.15.05/win64/

Mac brew install nasm

Cargo Features

If you disable turbo (on by default), the turbojpeg library will not be used to open jpeg images. You won't need Nasm to be installed. The feature file_open will enable/disable a file open dialog. This pulls in additional dependencies and is enabled by default.

Shortcuts:

mouse wheel = zoom

left mouse,middle mouse = pan

ctrl + mouse wheel = prev/next image in folder

Right mouse pick color from image (in paint mode)

T = AlwaysOnTop

F = Fullscreen

I = InfoMode

E = EditMode

Right = NextImage

Home = FirstImage

End = LastImage

Left = PreviousImage

R = RedChannel

G = GreenChannel

B = BlueChannel

A = AlphaChannel

U = RGBChannel

C = RGBAChannel

V = ResetView

Minus = ZoomOut

Equals = ZoomIn

Key1 = ZoomActualSize

Key2 = ZoomDouble

Key3 = ZoomThree

Key4 = ZoomFour

Key5 = ZoomFive

LShift + Left = PanLeft

LShift + Right = PanRight

LShift + Up = PanUp

LShift + Down = PanDown

RBracket = LosslessRotateRight

LBracket = LosslessRotateLeft

LControl + C = Copy

LControl + V = Paste

LControl + O = Browse

Q = Quit

Dependencies

~46–89MB
~1.5M SLoC