Terminal-Based Bad Apple ASCII Art Renderer in Kotlin

This Kotlin program extracts frames from the "bad_apple.mp4" video file and renders them as ASCII art in the terminal while playing the accompanying audio. It's inspired by the "Bad Apple!!" music video.

Review

Prerequisites

• Java 17
• Gradle
• FFmpeg

Installing FFmpeg

Windows

1. Download the FFmpeg executable from FFmpeg's official website.
2. Extract the FFmpeg files to a directory, for example C:\ffmpeg.
3. Add the C:\ffmpeg\bin directory to your system's PATH environment variable.
   • Right-click on This PC or Computer on your desktop or in File Explorer.
   • Select Properties.
   • Click on Advanced system settings.
   • Click on Environment Variables.
   • Under System variables, find the Path variable, select it, and click Edit.
   • In the Edit Environment Variable window, click New and add the path to the ffmpeg bin directory (e.g., C:\ffmpeg\bin).
   • Click OK to close all windows.
4. Open a new command prompt and type ffmpeg -version to verify that ffmpeg is correctly installed and accessible from the command line.

macOS

1. Install FFmpeg using Homebrew:

   brew install ffmpeg

2. Verify the installation:

   ffmpeg -version

Linux

1. Install FFmpeg using your distribution's package manager:
   • Debian/Ubuntu:

     sudo apt update
     sudo apt install ffmpeg

   • Fedora:

     sudo dnf install ffmpeg

   • Arch Linux:

     sudo pacman -S ffmpeg

2. Verify the installation:

   ffmpeg -version

Installation and Usage

1. Clone the Repository: Clone this repository to your local machine.

   git clone https://github.com/ShinniUwU/BadAppleKT.git

2. Navigate to the Directory: Change directory to the cloned repository.

   cd BadAppleKT

3. Compile and Run: Compile and run the Kotlin program using Gradle.

   ./gradlew run

Usage

Upon running the program, it will extract frames from the "bad_apple.mp4" video file and render them as ASCII art in the terminal. The audio will simultaneously play in sync with the ASCII animation.

Customization

• Frame Rate: Adjust the frameRate variable in the main() function to change the speed of the animation.
• ASCII Characters: Modify the asciiChars array in the convertToAscii() function to customize the ASCII representation.

Credits

This program is inspired by the "BadAppleK" repo.

License

This project is licensed under the GNU General Public License (GPL).

Author

Developed by Hana (ME :3).

Feel free to contribute, report issues, or suggest improvements!

---

So far, it's been tested only on Linux Kitty terminal. It needs to be made compatible with a full range of terminals. Please note that I won't be actively working on this repository. However, if someone wants to push updates, feel free to do so.