consoleImageViewer(1)

🦋 consoleImageViewer(1) — USER COMMANDS 🦋

okay bestie, sit down, hydrate, and let me tell you about consoleImageViewer — the manual page name is consoleImageViewer and the manual is section 1, so you know it's a user command, and it is so good.

---

✨ NAME ✨

consoleImageViewer — a highly scale-able, high quality, image viewer for ANSI terminals. yes. in your terminal. obsessed.

---

🎀 SYNOPSIS 🎀

consoleImageViewer
[-h][--help][-best][-fg][-bg][-nochar][-names][-ratio][-rect][-negChar][-negColor][-wX][-hX]
image-name(s)

ngl, the number of hyphens nor the case meter for the switches. it's giving chaos, it's giving free spirit. type it however, she'll cope.

---

💅 DESCRIPTION 💅

It's not exactly a photo-viewer, okay? But when you're in the terminal and you need a quick preview of (small) image(s), then honestly? it is best of its kind. periodt. 👑

It is strongly recommended that you export COLUMNS LINES so it adapts correctly to your terminal. like, please, do this. your girl needs to know how big the room is before she starts dancing. 🩰

---

🌈 OPTIONS 🌈

• -h, --help — prints the help and then exits. bye! 👋
• -best — overwrite everything and set the best settings. she said "I got this." 💖
• -bestnchar — same as above, but it sets nochar to true. bestie with a twist ✨
• -fg — use linux ansi escape color for the character.
• -bg — use linux ansi escape color for the background.
• -nochar — disable shadowing by characters.
• -names — prints out the image name before drawing it. name tag era 🏷️
• -ratio — force it to keep the image ratio.
• -rect — will force rendering assuming that a console char is not a square, but a rectangle of 2w~=h. the geometry is geometrying 📐
• -negChar — invert the chars.
• -negColor — invert the colors.
• -wX — force the width to width X, ignoring exported COLUMNS.
• -hX — force the height to height X, ignoring exported LINES.

---

🍓 EXAMPLES 🍓

No switch is considered as -best:

consoleImageViewer <image_name(s)>

same as:

consoleImageViewer -best <image_name(s)>

Pretty good black and white (or any terminal default view):

consoleImageViewer -ratio -rect  -negChar  <image_name(s)>

Overriding default or COLUMNS/ROWS by size of 128 (-noChar is ignored because -best is used):

consoleImageViewer -best -noChar  -w128 -h128 <image_name(s)>

lowkey watch out for that last one — -noChar gets ignored because -best is in the room and -best does not share the aux. 💀

---

⭐ EXIT STATUS ⭐

consoleImageViewer returns zero unless it crashes. that's it, that's the whole vibe check. if it ate, you get 0. 🙈

---

👑 AUTHOR 👑

Jiri Vanek (judovana (at) email.cz) — the main character who made all of this happen. 🫶

---

💜 SEE ALSO 💜

dispaly(1)

---

🌸 okay that's the whole page, bestie. this is version 1.2, dated December 04, 2015, from the USER COMMANDS manual — now go export your COLUMNS and LINES and slay some images in your terminal. mwah. 💖✨🎀