docs: add readme
This commit is contained in:
parent
e57c1c9322
commit
db457fc4e7
1 changed files with 41 additions and 0 deletions
41
README.md
Normal file
41
README.md
Normal file
|
|
@ -0,0 +1,41 @@
|
||||||
|
# imagey
|
||||||
|
|
||||||
|
image viewer and maybe editor; inspired by mpv's simplicity
|
||||||
|
|
||||||
|
name is subject to change, suggestions welcome :)
|
||||||
|
|
||||||
|
## usage
|
||||||
|
|
||||||
|
```sh
|
||||||
|
# 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)
|
||||||
Loading…
Reference in a new issue