Video to OLED Animation Converter (Pro Edition)

3. C++ Array Output (VideoFrame.h)

Create a new file/tab in the Arduino IDE named VideoFrame.h and paste this code.

4. Main Sketch (Main.ino)

Paste this code into your main sketch file (.ino). Don't forget to select your OLED type at the very top of the code.

#include <Wire.h>
#include <Adafruit_GFX.h>
#include "VideoFrame.h" 

#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64
#define OLED_RESET    -1

// ========================================================
// ⚙️ SELECT YOUR OLED TYPE HERE (Enable only one!)
// ========================================================
#define USE_SSD1306
//#define USE_SH1106
// ========================================================

// Auto-configuration based on selection above
#ifdef USE_SSD1306
  #include <Adafruit_SSD1306.h>
  Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET);
  #define SCREEN_COLOR WHITE  // SSD1306 uses "WHITE"

#elif defined(USE_SH1106)
  #include <Adafruit_SH110X.h>
  Adafruit_SH1106G display = Adafruit_SH1106G(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET);
  #define SCREEN_COLOR SH110X_WHITE // SH110X uses "SH110X_WHITE"
#endif

unsigned long previousMillis = 0;
int currentFrame = 0;

void setup() {
  Serial.begin(115200);

  // Auto-initialization based on chip selection
  #ifdef USE_SSD1306
    if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { 
      Serial.println(F("SSD1306 OLED connection failed."));
      for(;;); 
    }
  #elif defined(USE_SH1106)
    if(!display.begin(0x3C, true)) { // SH1106 has a different begin() format
      Serial.println(F("SH1106 OLED connection failed."));
      for(;;); 
    }
  #endif

  // I2C at 800 kHz for smooth video FPS
  Wire.setClock(800000); 

  display.clearDisplay();
  display.display();
}

void loop() {
  unsigned long currentMillis = millis();

  if (currentMillis - previousMillis >= FRAME_DELAY) {
    
    previousMillis = currentMillis;

    display.clearDisplay();
    
    // SCREEN_COLOR automatically adapts to the selected chip
    display.drawBitmap(0, 0, video_frames[currentFrame], SCREEN_WIDTH, SCREEN_HEIGHT, SCREEN_COLOR);
    display.display();

    currentFrame++;

    if (currentFrame >= TOTAL_FRAMES) {
      currentFrame = 0;
    }
  }
}

5. Live Simulator (Wokwi)

Paste your Main.ino code into the editor below, then click the Play button (▶) to see it running virtually!

[ ESP32 OLED VIDEO ANIMATION CONVERTER ]

1. Input & Settings

2. Live Preview (OLED 128x64)

3. C++ Array Output (VideoFrame.h)

4. Main Sketch (Main.ino)

5. Live Simulator (Wokwi)