Instant feature rich terminal image viewer (as fast as catimg, if not faster).
Compilation of this repository requires dlang.
- Clone this repo and build it with
dub build -b release - Copy created binary
./bin/pxvto somewhere in your path, for example~/.local/bin/
- Go to releases and download binary.
- Copy downloaded binary
pxvto somewhere in your path, for example~/.local/bin/
- Install with any package manager of your choice. Assuming you have
yayinstall withyay -Syu pxvor if you havepkminstall withpkm install pxv
- Fetch package with
dub fetch pxv - Build and install into
/usr/binwithdub build pxv -b release -c install
| Flag | Description | Notes |
|---|---|---|
| -c, --columns | Sets width/columns. | Can be used together with -r to set custom image size |
| -r, --rows | Sets height/rows. | If -c and -m are not set will change -m to height |
| -s, --size | Matches set dimention. Must be one of: width, height, fit. | Fit option will fit image automatically. Defaults to width. Gifs are always matching to fit |
| -C, --color | Sets color type. Must be one of: ansi8, ansi256, truecolor. | ansi8 prints with \e[$1m, ansi256 with \e[38;5;$1m and truecolor with \e[38;2;$1m |
| -g, --grayscale | Prints image in grayscale. | Keeps -C palette. |
| -l, --lowres | Renders image in half of resolution. | Must be turned on if your terminal doesn't have support for unicode since by default pxv prints with "â–€" and "â–„". |
| -i, --ascii | Uses ascii palette. | Default palette is .`^,:;!-~=+<>[]{}*JS?AX#%@ |
| -p, --palette | Sets ascii palette for output. | Works only with -i flag. |
| -b, --background | Disables background. | Does not work when using -l without -i. |
| -o, --once | If image is gif and flag is set then it's going to do only one loop | |
| -S, --still | Shows only first frame in gif | Marks image as not gif |
| -f, --frame | Shows only N frame in gif | Marks image as not gif |
