ncurses Image Viewer
Switch branches/tags
Nothing to show
Clone or download
Latest commit de613ca Nov 8, 2015
Failed to load latest commit information.
include Colors extracted from terminal Jul 15, 2012
.gitignore Basic functionality Jun 27, 2012
Makefile Hardcoded charset data Jul 15, 2012



imgcurses is a smart console based image viewer.


  • Do you browse the internet using lynx?
  • Do you wish the world was only 8 colors?
  • Do you pity your peers with their pathetic desktops applications?

imgcurses might just be for you...

The limited color pallet introduces some pretty bad limitations, but unlike alternatives imgcurses is fully interactive and employs smart techniques to get the most out of viewing - it doesn't just map pixel values to ascii characters. Images are best viewed scaled up, from a distance, and with a blurred focus. The combination of modes highlights different image features and makes an overall understanding of the image much more plausible.


Me Sunflower Car


  • To zoom use '[ ]'
  • To scroll use the arrow keys.
  • To change mode press 'm'
  • To quit press 'q'.


If anyone has any bright ideas for new algorithms or techniques I'd more than welcome trying to implement them.

  • Solid - Simply evaluates the subsection of the image and uses the closest console color. The fastest mode.
  • Value - A Black & White mode similar to most other programs. Looks at the darkness of the pixel and chooses an appropriate ascii character. Good for overall contrast.
  • Color - Blends between the two nearest colors using an appropriate ascii character. Best for trying to get a grasp of the color pallet, limited as it is.
  • Detail - Looks at the sub-image detail and tries to match it to appropriate an ascii character. Best for seeing shapes and smaller details of the image but can be slow.

File Formats

Currently imgcurses supports .tga .png .jpeg