Skip to content

BlackThunder080/vit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VIT - View Images in Terminal

Crates.io CI Status

Install

Install using cargo

cargo install vit

or download from releases

Dependancies

On linux you need x11 and openssl installed, to install on ubuntu or debian run

sudo apt-get install xorg-dev libssl-dev

Windows and Mac do not require any dependancies

Usage

$ vit --help
View Image in Terminal

Usage: vit.exe [OPTIONS] [FILE]

Arguments:
  [FILE]  Path to image: can be a file or url. If no path is provided the clipboard will be used

Options:
  -c <CHARS>      Number of characters per pixel [default: 2]
  -b              Open in browser as well
  -h, --help      Print help
  -V, --version   Print version

file can be a path to a file or an image url

char-size is the number of characters per pixel, usually 2 or 3 works best for square pixels

Example

$ vit "https://cdn.pixabay.com/photo/2023/12/08/16/07/chocolate-8437801_1280.jpg" -c 2 Example Output

Resolution

Resolution is dependant on terminal font size High Res Example

You can usually use mouse wheel scroll or trackpad pinch to set change font size