14 releases (4 stable)

Uses old Rust 2015

1.2.1 Jul 15, 2023
1.2.0 Feb 9, 2022
1.1.0 Mar 18, 2020
0.5.1 Feb 28, 2020
0.3.0 Sep 17, 2016

#1 in #picture

Download history 80/week @ 2023-10-21 63/week @ 2023-10-28 25/week @ 2023-11-04 76/week @ 2023-11-11 59/week @ 2023-11-18 48/week @ 2023-11-25 63/week @ 2023-12-02 66/week @ 2023-12-09 49/week @ 2023-12-16 46/week @ 2023-12-23 42/week @ 2023-12-30 118/week @ 2024-01-06 67/week @ 2024-01-13 195/week @ 2024-01-20 54/week @ 2024-01-27 22/week @ 2024-02-03

355 downloads per month
Used in 2 crates

MIT license

388 lines

termimage TravisCI build status AppVeyorCI build status Licence Crates.io version

Display images in your terminal, kind of




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, and
  • termimage-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.


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.


Windows: DS3 image after

Linux with truecolor support: DS3 image after Rust logo image after playing dice image after

Special thanks

To all who support further development on Patreon, in particular:

  • ThePhD
  • Embark Studios
  • Lars Strojny
  • EvModder


~72K SLoC