https://github.com/02loveslollipop/badappleesp32codemaker

Bad Apple on ESP32 with composite video
https://github.com/02loveslollipop/badappleesp32codemaker

bad-apple esp32 esp32-arduino microcontroller python

Last synced: 8 days ago
JSON representation

Bad Apple on ESP32 with composite video

• Host: GitHub
• URL: https://github.com/02loveslollipop/badappleesp32codemaker
• Owner: 02loveslollipop
• Created: 2023-04-02T04:07:58.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2024-03-11T20:35:54.000Z (11 months ago)
• Last Synced: 2024-11-22T23:25:08.572Z (2 months ago)
• Topics: bad-apple, esp32, esp32-arduino, microcontroller, python
• Language: Python
• Homepage:
• Size: 923 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 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](https://www.anaconda.com/download) or [miniconda](https://docs.anaconda.com/free/miniconda/miniconda-install/) for managing the python environment

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

- [ffmpeg](https://ffmpeg.org/download.html) for video processing (optional)

- [Arduino IDE](https://www.arduino.cc/en/software) for ESP32 development

## Setup

1. download the repository:

```bash

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

```

2. go to the repository folder:

```bash

cd BadAppleESP32CodeMaker

```

3. (Windows) execute setup.ps1 script:

```powershell

.\setup.ps1

```

3. (Linux) execute setup.sh script:

```bash

./setup.sh

```

5. execute the utility:

```bash

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](https://github.com/02loveslollipop/BadAppleESP32CodeMaker/blob/master/esp32badApple/esp32badApple.ino)

3. upload the code to the ESP32

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