Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/garlinhs/media-to-ascii

C++ program that converts media files such .mp4 into ASCII characters.
https://github.com/garlinhs/media-to-ascii

ascii-video c-plus-plus console-application linux media ncurses opencv terminal video

Last synced: 13 days ago
JSON representation

C++ program that converts media files such .mp4 into ASCII characters.

Host: GitHub
URL: https://github.com/garlinhs/media-to-ascii
Owner: garlinhs
License: gpl-3.0
Created: 2022-06-09T06:10:36.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2024-03-29T07:15:22.000Z (11 months ago)
Last Synced: 2024-12-15T02:25:03.252Z (2 months ago)
Topics: ascii-video, c-plus-plus, console-application, linux, media, ncurses, opencv, terminal, video
Language: C++
Homepage:
Size: 1.62 MB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# media to ASCII
[![License](https://shields.io/badge/License-GNU%20General%20Public%20License%20v3.0-green)](LICENSE)
[![nCurses](https://img.shields.io/badge/nCurses-6.4-red.svg)](https://en.wikipedia.org/wiki/Ncurses/)
[![OpenCV](https://img.shields.io/badge/OpenCV-4-green.svg)](https://opencv.org/)
[![Linux](https://img.shields.io/badge/Platform-Linux-blue.svg)](https://www.linux.org/)

## Introduction
C++ program that converts media files such .mp4 into ASCII characters.

## Getting started

## Dependencies

Before getting started with media-to-ascii, ensure that you have the following dependencies installed on your Linux system:

- **g++ compiler**

```Bash
sudo apt install g++
```

- **CMake**

```Bash
sudo apt install cmake
```

- **OpenCV 4**

```Bash
sudo apt install libopencv-dev python3-opencv
```

- **nCurses 6**

```Bash
sudo apt-get install libncurses5-dev libncursesw5-dev
```

### Installation
To use media-to-ascii, follow these steps
1. Clone the repository to your local machine:
```Bash
git clone https://www.github.com/garlinhs/media-to-ascii.git
```
2. Step into the repository:
```Bash
cd media-to-ascii
```

3. Compile the project with **make**:
```Bash
mkdir build
cd build
cmake ..
cmake --build .
```

4. Now you will see the executable **media_to_ascii** and you can execute the program

- Without the audio
```Bash
./media_to_ascii ../resource/sample.mp4
```

- With the audio
```Bash
./media_to_ascii -a ../resource/sample.mp3 ../resource/sample.mp4
```

## Contributing
Contributions are welcome from the community! Wheter it's bug fixes, feature enhancements, or new ideas, feel free to open an issue or submit a pull request.

## Author and Maintainer
- Garlinh Soler
- Email: [email protected]