Skip to content

Latest commit

 

History

History
21 lines (20 loc) · 1.16 KB

README.md

File metadata and controls

21 lines (20 loc) · 1.16 KB

ttyvideo

Pushing the limits of resolution and color depth... backwards!
ttyvideo is a video player that runs in a 256-color terminal.

Dependencies

ttyvideo requires OpenCV (2 or 3) compiled with video codecs. If your package manager doesn't carry a version of OpenCV like this, you're going to need to download and compile its source code before you can use ttyvideo. ttyvideo also uses CMake>=2.8 to generate files used in the installation process.

Installation

You can compile ttyvideo with CMake and Make.

cmake .
make

After compiling, it can be installed by performing

sudo make install

How it works

ttyvideo works with most visual media types: videos, images, GIFs, etc. This is due to the usage of OpenCV to read media.
Right now, ttyvideo doesn't do anything special when rendering videos.
ttyvideo will scale any video to fit the aspect ratio of the terminal it's running in. ttyvideo also does not perform any smoothing operations; each character slot in the terminal corresponds to exactly one pixel in the source video, not a combination of them. Feel free to add smoothing ttyvideo!