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