Bad Apple ESP32 Code Maker

A Python utility to convert a video into a C array for the ESP32.

Intro

This is a Python based utility to convert a video into a C array for the ESP32. The video is converted into a 1bit np array that is delta encoded and RLE compressed. The output is a C char array that can be used in the ESP32 code, to display the video on a composite video output.

Requirements

• anaconda or miniconda for managing the python environment

• a C compiler (gcc, clang, etc.) as Cython requires a C compiler to build the extension

• ffmpeg for video processing (optional)

• Arduino IDE for ESP32 development

Setup

1. download the repository:

git clone https://github.com/02loveslollipop/BadAppleESP32CodeMaker.git

2. go to the repository folder:

cd BadAppleESP32CodeMaker

3. (Windows) execute setup.ps1 script:

.\setup.ps1

3. (Linux) execute setup.sh script:

./setup.sh

5. execute the utility:

python main.py --help

ESP32 setup

afer the code (byteStream.h) is generated, you can use the following code to display the video on a composite video output:

1. add the byteStream.h file to the Arduino project folder
2. open eps32badApple.ino
3. upload the code to the ESP32

the composite video output is connected to the GPIO 25 pin of the ESP32