Awesome
termimage
![Crates.io version](https://img.shields.io/crates/v/termimage)
Display images in your terminal, kind of
Documentation
Manpage
Installation
From Crates.io
Start by obtaining Rust from https://rustup.rs. Afterwards, run
cargo install termimage
After the installation process finishes, running termimage
should produce an error message.
If it does, you're ready to move on to the Usage sexion below.
If, however, you've encountered a problem during the installation, do not hesitate to open an issue here.
From Debian repository
The following line in /etc/apt/sources.list
:
deb https://debian.nabijaczleweli.xyz stable main
With my PGP key (the two URLs are interchangeable):
wget -O- https://debian.nabijaczleweli.xyz/nabijaczleweli.gpg.key | sudo apt-key add
# or
sudo wget -O/etc/apt/trusted.gpg.d/nabijaczleweli.asc https://nabijaczleweli.xyz/pgp.txt
Then the usual
sudo apt update
sudo apt install termimage
will work on x86_64, i686, and x32.
See the repository README for more information.
From AUR
There are three AUR packages, maintained by ohrun:
termimage
, which builds the latest released version,termimage-git
, which builds the latest git revision, andtermimage-bin
, which downloads the latest official build artifacts.
If you use an AUR helper, you should be able to
yay -S termimage
Otherwise, you should be able to clone an individual package repository and compile it with makepkg
by running
git clone https://aur.archlinux.org/termimage.git && cd termimage && makepkg -si
From pre-built executables
Alternatively, have a glance over at the releases page, which should host Windows and Linux x86_64 binaries.
Installation should be a matter of downloading them, marking as executable, and copying somewhere to your $PATH
.
Usage
Display an image
termimage IMAGE_PATH
Print all images in a dir to a file.
(for f in $(find image_dir -type f); do termimage -s 150x33 $f; done) > out_file
For more usage examples see the documentation.
Examples
Windows:
Linux with truecolor support:
Special thanks
To all who support further development on Patreon, in particular:
- ThePhD
- Embark Studios
- Lars Strojny
- EvModder