NajmAjmal-old / video-to-ascii

Convert videos into colourful ASCII art for terminal display using Python and OpenCV.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Video to ASCII Art Converter

Convert videos into colorful ASCII art for terminal display using Python and OpenCV.

Description

This project provides a Python script that takes a video file as input and converts each frame of the video into ASCII art. The resulting ASCII art frames are displayed in the terminal, creating a unique visual experience. The conversion is achieved by mapping pixel colors to corresponding characters from a predefined character set.

Features

  • Convert video frames into colorful ASCII art.
  • Customizable character set and color mapping.
  • Automatic resizing of frames to fit terminal dimensions.

Usage

  1. Install the required dependencies:

    python3 -m pip install numpy opencv-python
    
  2. Run the script with a video file as an argument:

    python3 main.py path_to_video.mp4
    

License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) license. This means you are free to use and modify the code for non-commercial purposes, provided you give appropriate attribution.

Acknowledgements

This project was inspired by this GitHub Repository.

Contributing

Contributions are welcome! Feel free to fork this repository, make improvements, and submit a pull request.

Disclaimer

The software is provided "as is," without warranty of any kind. The authors and contributors shall not be liable for any claim, damages, or other liability arising from the use of the software.


About

Convert videos into colourful ASCII art for terminal display using Python and OpenCV.

License:MIT License


Languages

Language:Python 100.0%