← back

fork/oculante

git clone https://git.julia.blue/fork/oculante

StoppedpumaMerge pull request #770 from joshuamegnauth54/fix-last-dir-savingb47bf97

master
7 folders18 files

files

.cargo/
.github/
benches/
egui-modal-diag/
res/
src/
tests/
.gitignore150 B
CHANGELOG.md17.0 KiB
CODE_OF_CONDUCT.md5.1 KiB
Cargo.lock241.4 KiB
Cargo.toml4.4 KiB
Cross.toml1.6 KiB
LICENSE1.0 KiB
PKGBUILD1.1 KiB
README.md11.4 KiB
build.rs4.9 KiB
build_deps_linux.sh256 B
build_deps_win.bat227 B
build_mac.sh4.0 KiB
build_netbsd.sh43 B
create_release.sh1018 B
icon.ico170.4 KiB
setup_ext_libs.sh426 B
winres.rc17 B
<h1 align="center"> <img alt="banner" src="res/banner.avif"> </h1>

A no-nonsense hardware-accelerated image viewer

<img src="res/download.svg" height="50">

Oculante's vision is to be a fast, unobtrusive, portable image viewer with a wide range of supported image formats while also offering image analysis and basic editing tools.

Oculante is a free, open-source, bloat-free, and privacy-respecting image viewer that is fast to start up and open images. It is available on Windows, Mac, Linux, FreeBSD, and NetBSD, and supports a wide range of image formats. Oculante caches images for faster reloading and can correctly display unassociated channels. It also includes features for basic image analysis, and offers SIMD-accelerated, basic nondestructive editing tools such as cropping, resizing, painting, rotating, blurring, and more!

OSX NetBSD Ubuntu Windows ARM

GitHub all releases Crates.io Screenshot

Flipbook

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

Screenshot

Inspection

Get information about pixel values and position, with precise picking:

Screenshot

File Management

Oculante's built-in File Manager allows you to access files on your system without leaving the application. This makes it easy to compare images, especially with the dedicated compare option that lets you flip between images while preserving the zoom level and position.

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

Find and download the correct executable for your operating system on the releases page. The download is small, around 25MB, as we link dependencies statically by default. We also have packages available for ARM Linux. Have a different OS? Please feel free to open an issue if you want your operating system of choice supported!

For those looking to manage Oculante through a package manager, please see the options below.

Cargo

cargo install oculante

Linux

pacman -S oculante
paru -S oculante-git
environment.systemPackages = [
    pkgs.oculante
];
zypper install oculante
flatpak install flathub io.github.woelper.Oculante

BSD

pkg install oculante
pkgin install oculante
NetBSD builds currently use glsl-to-spirv instead of shaderc

Windows

scoop install extras/oculante

Build Dependencies

Linux (Debian):

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

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

Mac: brew install nasm cmake

Updates

Oculante only gets updated when it improves something for you. You'll still see new releases about every month or two! To stay up to date you can use the update button in settings, or download the new release executable. Updates are also managed through your package manager if you installed through one.

Uninstalling

To uninstall Oculante, simply delete the executable file and the data folder. You can find the data folder in the relevant location for your operating system below.

Roadmap

You can see what we're currently working on in our Release Plan, or our Milestones!

Features

Image format support

Misc examples:

Viewing EXIF data

Screenshot

Extracting a signature

signature example

Credits

Photos used in tests and screenshots:

https://unsplash.com/@mohsen_karimi

https://unsplash.com/@frstvisuals

https://unsplash.com/@eberhardgross

UI Design:

Stoppedpuma

Privacy pledge

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

In addition, Oculante saves some settings locally, for example:

License

This project is MIT licensed, but some parts such as the LUTs in res/LUT are under the GPL license. As a result, we're making our entire source code public. If you would like to use Oculante without publishing your source code, please remove any GPL-licensed components and their references.

Extras

<details> <summary>Cargo Features</summary> </details> <details> <summary>Extended Language Support</summary>

Oculante can support some additional languages such as Arabic, Chinese, Japanese, Korean. This support depends on if your system has a supported font family installed. One supported font family is Noto Sans.

Simplified Chinese

Traditional Chinese

Japanese

Korean

Taiwanese

Arabic

</details> <details> <summary>Default Shortcuts</summary>

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)

<kbd>T</kbd> = AlwaysOnTop

<kbd>F</kbd> = Fullscreen

<kbd>I</kbd> = InfoMode

<kbd>E</kbd> = EditMode

<kbd>Right</kbd> = NextImage

<kbd>Home</kbd> = FirstImage

<kbd>End</kbd> = LastImage

<kbd>Left</kbd> = PreviousImage

<kbd>R</kbd> = RedChannel

<kbd>G</kbd> = GreenChannel

<kbd>B</kbd> = BlueChannel

<kbd>A</kbd> = AlphaChannel

<kbd>U</kbd> = RGBChannel

<kbd>C</kbd> = RGBAChannel

<kbd>V</kbd> = ResetView

<kbd>Minus</kbd> = ZoomOut

<kbd>Equals</kbd> = ZoomIn

<kbd>Key1</kbd> = ZoomActualSize

<kbd>Key2</kbd> = ZoomDouble

<kbd>Key3</kbd> = ZoomThree

<kbd>Key4</kbd> = ZoomFour

<kbd>Key5</kbd> = ZoomFive

<kbd>LShift</kbd> + <kbd>C</kbd> = CompareNext

<kbd>LShift</kbd> + <kbd>Left</kbd> = PanLeft

<kbd>LShift</kbd> + <kbd>Right</kbd> = PanRight

<kbd>LShift</kbd> + <kbd>Up</kbd> = PanUp

<kbd>LShift</kbd> + <kbd>Down</kbd> = PanDown

<kbd>Delete</kbd> = DeleteFile

<kbd>LShift</kbd> + <kbd>Delete</kbd> = ClearImage

<kbd>RBracket</kbd> = LosslessRotateRight

<kbd>LBracket</kbd> = LosslessRotateLeft

<kbd>LControl</kbd> + <kbd>C</kbd> = Copy

<kbd>LControl</kbd> + <kbd>V</kbd> = Paste

<kbd>LControl</kbd> + <kbd>O</kbd> = Browse

<kbd>Q</kbd> = Quit

<kbd>Z</kbd> = ZenMode

</details>