imagey/README.md
2026-08-03 11:27:29 -07:00

1.1 KiB

imagey

image viewer and maybe editor; inspired by mpv's simplicity

name is subject to change, suggestions welcome :)

usage

# try it out!
nix run git+https://git.federated.nexus/electria/imagey

# install it imperatively
nix profile install git+https://git.federated.nexus/electria/imagey

keybinds are shown on startup if you didn't start it with an image

known issues

JXL

  1. encoding is not implemented (jxl-oxide is decoding-only)

  2. oreintation is incorrect in some cases

    if the image has metadata oreintation AND

    it's a jxl without the right extension OR it's a jpeg with the jxl extension

    this is due to the JXL decoder automatically rotating the image, while the JPEG decoder (for instance) requires the extra step.

    my workaround is to check the path of the input file, not changing the oreintation if it has the jxl extension; causing these caveats for cases where the extension is wrong.

clipboard

  1. large images (eg photos) don't seem to copy on linux/wayland, (despite set_image not returning any error)