simono41/imcat
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
No description
12 commits 1 branch 0 tags 647 KiB
C 99.3%
Roff 0.5%
Makefile 0.2%
Find a file
Bram Stolk 51a2924cb4 Use sample image with correct aspect ratio.
2018-04-19 11:42:35 -07:00
images Use sample image with correct aspect ratio. 2018-04-19 11:42:35 -07:00
imcat.c Support for double-res on other platforms that windows, using unicode. 2018-04-19 11:30:17 -07:00
Makefile First import. 2018-04-18 11:14:04 -07:00
README.md List aspect ratio fix as done. 2018-04-19 11:31:38 -07:00
stb_image.h First import. 2018-04-18 11:14:04 -07:00

README.md

imcat

Preview any size image in a terminal window.

Sample use

Platform

Supports Linux, MacOS and Microsoft Windows 10 terminals.

Introduction

Do you ever find yourself logged into a server, over SSH, but there is no X11 connection. And you want to see the contents of an image?

imcat to the rescue!

imcat is a 24-bit image viewer that uses ANSI terminal colours to display any image supported by STB. It automatically resizes to the width of your terminal, using proper sampling kernels.

imcat also works on the latest version of Windows 10.

Todo

Done

  • Correct for aspect ratio of terminal font.

Building

Unix

On Linux, just use 'make' to build the imcat binary.

Windows 10

On Windows, you need clang.exe from Visual Studio 2017 to build the imcat.exe binary. It's actually quite hard to get that compiler working, so you may just as well grab the pre-built imcat.exe binary.

License

  • Public Domain.

Authors

Bram Stolk.

stb_image.h is by Sean Barrett et al.

Acknoledgements

A shout out to Frogtoss for the idea and help. Thanks!