Crates.io | oculante |
lib.rs | oculante |
version | 0.9.1 |
source | src |
created_at | 2020-06-14 21:24:21.159603 |
updated_at | 2024-09-23 18:30:31.245761 |
description | A minimalistic image viewer with analysis and editing tools |
homepage | |
repository | https://github.com/woelper/oculante/ |
max_upload_size | |
id | 253990 |
size | 11,568,259 |
A no-nonsense hardware-accelerated image viewer
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.
With configurable caching, Oculante can quickly step through image sequences:
Get information about pixel values and position, with precise picking:
You can use the File Manager built into Oculante to do basic tasks such as accessing recent images or stepping through a virtual list of files so you can compare easily. There is also a dedicated compare option to flip between images, remembering zoom level and position.
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.
Get started with Oculante by downloading the executable relevant to your platform from the releases page. The download size is kept small (currently around 25MB) by linking dependencies statically by default. Packages for ARM Linux are also built, 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 install oculante
pacman -S oculante
environment.systemPackages = [
pkgs.oculante
];
zypper install oculante
flatpak install flathub io.github.woelper.Oculante
pkg install oculante
pkgin install oculante
scoop install extras/oculante
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
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 releases executable! Updates are also managed through your package manager if you installed through one.
Uninstalling Oculante is a quick process, just delete the executable and delete the data folder. You can find the data folder in the relevant location for your operating system below.
~/AppData/Local/.oculante
~/Library/Application Support/oculante
~/.local/share/oculante
rust-icns
)jpeg2k
, feature "j2k", on by default)jxl-oxide
)tiff
with additional float/half support)libwebp-sys
- image
had very limited format support)dds-rs
)psd
)resvg
)exr-rs
), tonemappedquickraw
- 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.libheif-rs
). Enabled on Windows builds, but optional dependency on MacOS and Linux - available behind heif
flag.krita_support
branch)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.cat image | oculante -s
Viewing EXIF data
Extracting a signature
Test / benchmark / screenshot pictures:
https://unsplash.com/@mohsen_karimi
https://unsplash.com/@frstvisuals
https://unsplash.com/@eberhardgross
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:
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.
turbo
(on by default), the turbojpeg library will not be used to open jpeg images. You won't need Nasm to be installed.
file_open
will enable/disable a OS-native file open dialog. This pulls in additional dependencies and is enabled by default. Disabling it will enable a custom file dialog. This will probably the default in the future.
notan/glsl-to-spirv
(default) uses the spirv shader compiler
notan/shaderc
uses shaderc as a shader compiler. Longer build time.
update
(default) enable app updating.
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 + C = CompareNext
LShift + Left = PanLeft
LShift + Right = PanRight
LShift + Up = PanUp
LShift + Down = PanDown
Delete = DeleteFile
LShift + Delete = ClearImage
RBracket = LosslessRotateRight
LBracket = LosslessRotateLeft
LControl + C = Copy
LControl + V = Paste
LControl + O = Browse
Q = Quit
Z = ZenMode