Skip to content

Latest commit

 

History

History
49 lines (33 loc) · 1.77 KB

README.md

File metadata and controls

49 lines (33 loc) · 1.77 KB
Raw

ASCII Media Player

A python program that creates ASCII graphics from images and videos. It can also play videos with subtitle support (given a .srt file)! 😱

🍎 Motivation

You have seen Music Players, Stack-overflow surfers, Hacker News portals etc. in the terminal, so it is the logical next step 😅. Besides, the terminal makes almost everything appear x10 times more cool.

⚗️ Dependencies

Language and Packages

The program runs using python3 The following python packages are used in the program:

  • pysrt
  • opencv-python
  • Pillow
  • numpy

These packages can be installed using any package manager for python like pip, conda, etc.

Terminal Requirements

All POSIX compliant terminals should work well. If you use windows, and the program doesn't work well, try switching to WSL (Windows Subsystem for Linux)

🎥 A Demo

demo-video.mp4

🛠️ Usage

Navigate to the directory of the python script and run the following command

python generate.py $VIDEO_FILENAME $SUBTITLE_FILENAME $OPTION

If you want to run without subtitles then

python generate.py $VIDEO_FILENAME $OPTION

Here $VIDEO_FILENAME and $SUBTITLE_FILENAME are the full path to the files and $OPTION takes values 0 for black and white output and 1 for true colour output (see if your terminal supports true colour before enabling)

📝 TODO and Future Plans

  • Support 3-bit RGB (8-colours)
  • Support true colour (24-bit RGB) visit tc-version branch
  • Support automatic resizing
  • Support B&W output
  • Support subtitles