Skip to content

ascii-video-converter is a Python-based tool that extracts frames from a video, converts them to ASCII art, and plays the ASCII video in the terminal. Users can control playback speed during the video playback. This project is compatible with Windows and uses ascii-magic, PIL, and cv2.

Notifications You must be signed in to change notification settings

harshkasat/ascii-video-converter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ASCII Video Converter

This Python project lets you convert video frames into ASCII art and display the resulting ASCII video in the terminal. It uses the ascii-magic library to convert images to ASCII and cv2 to extract frames from a video file. The video can be played back in the terminal using symbols and dots.

Gen AI Image

Repository Name

ascii-video-converter

Description

ascii-video-converter is a Python-based tool that extracts frames from a video, converts them to ASCII art, and plays the ASCII video in the terminal. Users can control playback speed during the video playback. This project is compatible with Windows and uses ascii-magic, PIL, and cv2.

Tutorial

I’ve created a video tutorial to demonstrate how this code works. Watch it below to see the project in action and follow along with the code:

Watch the tutorial on YouTube

You can also download the tutorial MP4 file directly from the repository:

Download Tutorial MP4

Features

  • Extract frames from any video file.
  • Convert video frames to ASCII art using customizable settings.
  • Display ASCII video in the terminal with playback controls.

Project Structure

  • main.py: The main script to run the project.
  • ConvertAscii: A class to convert images to ASCII.
  • Display: A class to handle ASCII video playback.
  • ExtractFrame: A class that extracts frames from a video.

Installation

  1. Clone the repository:

    git clone https://github.com/harshkasat/ascii-video-converter.git
    cd ascii-video-converter
  2. Install the required Python libraries:

    pip install -r requirements.txt
  3. Create the requirements.txt file with the following dependencies:

    pillow
    opencv-python
    ascii-magic
    

Usage

To use the tool, provide the path to a video file as a command-line argument:

python main.py path_to_video.mp4

Controls

  • +: Increase playback speed.
  • -: Decrease playback speed.
  • q: Quit playback.

About

ascii-video-converter is a Python-based tool that extracts frames from a video, converts them to ASCII art, and plays the ASCII video in the terminal. Users can control playback speed during the video playback. This project is compatible with Windows and uses ascii-magic, PIL, and cv2.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages