play any youtube video ▶ with ASCII in the terminal.
Project description
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:
-
Using OpenCV module to read each frame in the video
-
Resize it to the terminal size (if there's not a custom size in the options)
-
Convert the frame to a grayscale image (black & white)
-
Mapping each pixel to a given character depending on the grayscale value from black to the white. the default value:
" .'~;icok0XN"
-
finaly display the frame.
Overview
License
Distributed under the MIT license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.