CATIMG(1)

📦 version 2.8.0, in alpine 3.24, arch rolling, debian bookworm, debian trixie, epel 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NAME 💖

catimg — fast image printing in to your terminal. yes bestie, images. in your terminal. slay.

✨ SYNOPSIS ✨

catimg [-hct] [-w width | -H height] [-l loops] [-r resolution] image

🦋 DESCRIPTION 🦋

okay so listen. catimg is a little program written in C with no dependencies that prints images in the terminal. that's it, that's the whole vibe. it supports JPEG, PNG and GIF formats. no cap.

🌸 OPTIONS 🌸

  • -c — coerce colors to a restricted palette. this one's for the terminals with limited color support — it lets them render a more accurate version of the image than if the terminal itself was just raw-dogging the color handling directly. 💅
  • -h — prints a help message. classic. iconic. when in doubt, ask for help.
  • -H HEIGHT — specify the height of the displayed image. passing '0' will use terminal height. yes 0 means "bestie just use the whole terminal", it's giving main character energy.
  • -l LOOPS — specify the amount of loops that catimg should repeat a GIF. a value of 1 means that the GIF will be displayed twice (yes, twice, do not come for me, that's literally what it says). a negative value implies infinity. 🌀
  • -r RESOLUTION — possible values 1 or 2. force the resolution of the image. by default catimg will check if rendering in higher resolution is possible and do so, or use the lower one. it's adaptive like that. ✨
  • -t — disables true color (24-bit) support, falling back to 256 color escape codes instead. sad for your eyes but sometimes you gotta do what you gotta do. 😭
  • -w WIDTH — specify the width of the displayed image. when not provided, catimg will use the terminal width. let the terminal decide, she knows what she's doing. 🫶

💀 BUGS 💀

please report any bugs to https://github.com/posva/catimg/issues. be nice, be specific, bring receipts. 🙈

👑 AUTHORS 👑

catimg was written by Eduardo San Martin Morote (https://github.com/posva).

this manual page was written by Jonathan Carter <jcarter@linux.com>, Eduardo San Martin Morote and Thomas Kupper.

and that's the whole page bestie 🎀 this one's catimg, from the General Commands Manual, dated June 2020. go print some pictures in your terminal, you absolute legend. mwah. 💖✨

📦 where this page comes from