Skip to content

Latest commit

 

History

History
39 lines (30 loc) · 1.5 KB

README.md

File metadata and controls

39 lines (30 loc) · 1.5 KB

fbimg: display images in the Linux Framebuffer

Display images in tty using the Linux Framebuffer!

Original code found in Qt Documentation, a little bit modified by Hugo Rodde.

The stb_image library is part of the stb single-file public-domain libraries collection.

Supports every image format supported by stb_image.h (jpeg, png, bmp, hdr, psd, tga, gif, pic, psd, pgm, ppm).

Only the first image of animated gifs is displayed.

Compiling

GNU/Linux

Simply use

gcc -o fbimg fbimg.c -lm

Other OSes

Sadly, the Framebuffer is a Linux-only feature.

Usage

./fbimg path/to/img.png

Important

You need either to run it as root, either to add yourself in the video group!

Roadmap

  • Use stbimg instead of libpng to support more image formats
  • Allow the user to draw at any position on screen via CLI arguments
  • Allow the user to crop the image via CLI arguments
  • Add an option to rezise the image if it is too big for the screen (using this for example)
  • Add -v (--verbose) that print the commented stuff
  • Add -h (--help)
  • Support videos
    • Get videos frame by frame and display each frame
    • Arrow keys to skip 5 seconds