Skip to content

iambumblehead/thu.sh

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

demo

thu.sh renders preview images to the terminal; ~1000 LOC bash

thu.sh renders images from audio, font, video, pdf, epub, svg and other files --supporting both kitty and sixel formats. It detects available commands from the system for a small dependency tree,

  • magick sixel or kitten icat display,
  • mutool, pdftoppm or magick pdf,
  • ffmpeg video audio,
  • magick font,
  • unzip epub,
  • exiftool or identify file type
thu.sh /path/to/image.png
thu.sh /path/to/font.ttf
thu.sh /path/to/video.mp4

# display image is placed to fit optional top, left, width and height params
thu.sh /path/to/music.flac $top $left $width $height
thu.sh /path/to/image.svg 0 0 600 600
thu.sh /path/to/book.pdf
thu.sh /path/to/book.epub
Which terminal emulators will render images?
`foot`, `xterm`, `kitty` and `iTerm2` can render images with this script. Sixel support for other terminals is listed here https://www.arewesixelyet.com/
Anything else?
Suggestions and improvements are welcome and appreciated. `thu.sh` may feel "slow" as it presently does not yet cache or reuse preview images it generates.

Warning

vifm image preview no longer working vifm/vifm#731 (comment)

Add sixel image preview to vifm file manager. Instructions at the wiki.

vifm vifm