pbrewton / you-forgot-blueberries-in-ascii Goto Github PK

For those of us who want to see You Forgot Blueberries while in our terminal, but ain't got time to open YouTube.

• Python3
• PortAudio (Only required for installation with audio support)
• FFmpeg (Only required for installation with audio support)
• Linux or MacOS ... by now

Standard installation

$ pip3 install video-to-ascii

With audio support installation

$ pip3 install video-to-ascii --install-option="--with-audio"

Just run video-to-ascii in your terminal

$ video-to-ascii -f blueberries.mp4

--strategy Allow to choose a strategy to render the output.

-o --output Export the rendering output to a bash file to share with someone.

-a --with-audio If an installation with audio support was made, you can use this option to play the audio track while rendering the video ascii characters.

Every video is composed by a set of frames that are played at a certain frame rate. Since a terminal has a specific number of rows and columns, we have to resize our video to adjust to the terminal size limitations. To reach a correct visualization of an entire frame we need to adjust the frame height to match the terminal rows, avoiding using more characters than the number of terminal columns. When picking a character to represent a pixel we need to measure the relevance of that pixel's color in the frame, based on that we can then select the most appropriate character based on....

Eh.. who cares.. just sit back and watch the ASCII.