Video to ASCII

Convert any bicolor video (Black or White) and tricolor video (Black, White or Grey) into an ascii version. The program focuses on forms rather than color derivatives.

Example of rendering :

• Bicolor - Bad Apple!
• Tricolor - Rainy Boots

Table of Contents

1. Requirement
2. Building
3. Accuracies
4. Characters

Requirement

The libraries used within the project:

• SDL
• SFML
• OpenCV
• GTK

Arch Linux

1. C and C++ compiler:

   sudo pacman -S gcc

2. Libraries:

   sudo pacman -S sdl2 sdl2_image sdl2_ttf sfml opencv gtk3

Ubuntu

1. C compiler:

   sudo apt update
   sudo apt install gcc

2. C++ compiler:

   sudo apt update
   sudo apt install g++

3. Libraries:

   sudo apt update
   sudo apt install libsdl2-dev libsdl2-image-dev libsdl2-ttf-dev libsfml-dev libopencv-dev libgtk-3-dev

Fedora

1. C compiler:

   sudo dnf install gcc

2. C++ compiler:

   sudo dnf install gcc-c++

3. Libraries:

   sudo dnf install SDL2-devel SDL2_image-devel SDL2_ttf-devel SFML-devel opencv-devel gtk3-devel

Building

1. Clone the repository:

   git clone https://github.com/NichiHachi/video-to-ASCII.git

2. Navigate to the project directory:

   cd video-to-ASCII

3. Build the project using the makefile:

   make

4. Run the main file:

   ./bin/main

Accuracies

Here are the different accuracies based on the 480p video of Bad Apple!! :

• Low

• Medium

• High

The higher the resolution, the better the accuracy but the longer time of render !

Characters

You can add, remove or modify any character in the img/characters-low and img/characters-normal folder. The only requirements are that they must all be the same size and the character must be in the name, for example "#.jpg".