Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stolk/imcat
Show any image in a terminal window.
https://github.com/stolk/imcat
Last synced: about 8 hours ago
JSON representation
Show any image in a terminal window.
- Host: GitHub
- URL: https://github.com/stolk/imcat
- Owner: stolk
- Created: 2018-04-18T18:12:03.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-11-17T17:04:12.000Z (almost 2 years ago)
- Last Synced: 2024-08-03T09:03:32.344Z (4 months ago)
- Language: C
- Size: 577 KB
- Stars: 322
- Watchers: 11
- Forks: 25
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-linux-ricing - imcat
README
# imcat
Preview any size image in a terminal window.
# 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.
## Usage
```
$ imcat file1 [file2 .. fileN]
```
If you want to blend the image with the terminal background, then you need to specify the background color of your terminal. For instance:
```
$ export IMCATBG="#dad9cc"
```
## Todo
* Handle alpha-transparency. Requires reading the terminal background colour, somehow. Tricky.
## 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
* [CC0](https://creativecommons.org/publicdomain/zero/1.0/)
## Authors
[Bram Stolk](http://stolk.org).
[stb_image.h](http://nothings.org/stb_image.h) is by Sean Barrett et al.
## Acknowledgements
A shout out to [Frogtoss](http://github.com/mlabbe) for the idea and help. Thanks!
## Gallery
