A command line based video player written in python that converts and plays videos using ascii characters
This program is featured in one of my YouTube videos.
This program has only been tested to work on some Linux and macOS environments listed below:
| OS Name | Architecture | Python Versions |
|---|---|---|
| Arch Linux | amd64 (x86_64) | python 3.10, python 3.11 |
| Ubuntu 20.04 | amd64 (x86_64) | python 3.8, python 3.10 |
| macOS Big Sur | amd64 (x86_64) | python 3.10, python3.11 |
| Debian 11 (on Chrome OS) | amd64 (x86_64) | python 3.9 |
| Termux 0.118.0 (on Android 13) | AArch64 (arm64) | python 3.11 |
The program has been tested to work on python 3.8 and later.
It might work on Windows if you use cygwin, Otherwise you will manually need to install a curses package, and you may run into environment related errors such as the behaviour of shared memory objects.
Only mp4 files have been tested and most are guaranteed to work. FFmpeg might not support some formats.
This program requires both python packages and binary packages than can't be installed with pip alone.
Just install the packages in the requirements.txt file
python3 -m pip install -r requirements.txtThe binary dependencies are listed in the binary-requirements.txt file. You should be able to install them using your package manager.
Some test files are provided to use. To run the program using e.g., one of the test files run:
./vidtty.py ./fake-mr-beast-bad-apple-remix.mp4See vidtxt.md for more information