Requirements

• python 3.3 or above
• Linux or MacOS

Installation

install it with pip command

$ pip install ascii-yt

or use pip3 in Linux or MacOS

$ pip3 install ascii-yt

Usage

you can use URL as well between double quotes

$ ascii-yt "https://www.youtube.com/watch?v=dQw4w9WgXcQ&"

Options

--colors Allow to use colors in the ascii video

$ ascii-yt "URL.." --colors

-s --size Set a custom size and it must be WIDTHxHEIGHT

$ ascii-yt "URL.." -s 110x40

-c --chars Allow using your own characters depending on the grayscale value from black to white. the default value: " .'~;icok0XN"

$ ascii-yt "URL.." -c " .:!lM" --colors

How it works

ascii-yt is a python program that renders ASCII videos based on 5 steps:

1. Using OpenCV module to read each frame in the video

2. Resize it to the terminal size (if there's not a custom size in the options)

3. Convert the frame to a grayscale image (black & white)

4. Mapping each pixel to a given character depending on the grayscale value from black to the white. the default value: " .'~;icok0XN"

5. finaly display the frame.

Overview

License

Distributed under the MIT license.