How to Display an Image on Arduino OLED

• Arduino board — UNO, Nano, Mega, or any ESP32/ESP8266 variant
• SSD1306 0.96" OLED display — 128×64 pixel I2C version (the most common)
• 4 jumper wires (female-to-male for breadboard, or female-to-female direct)
• Arduino IDE installed (version 1.8.x or 2.x)
• An image you want to display (logo, icon, photo, anything)

Most SSD1306 OLEDs speak I2C and have just 4 pins: VCC, GND, SCL, and SDA. Connect them to your Arduino like this:

Open the Arduino IDE and go to Sketch → Include Library → Manage Libraries.... Search for and install these two libraries from Adafruit:

• Adafruit GFX Library — the graphics primitives (drawPixel, drawBitmap, drawLine, etc.)
• Adafruit SSD1306 — the SSD1306-specific driver

Or, if you prefer the lighter-weight u8g2 library:

• U8g2 by olikraus — supports SSD1306, SH1106, and dozens of other monochrome displays with a smaller memory footprint

This is where pixel.hjlabs.in comes in. Instead of manually computing every bit of every row, just drop your image into the converter and let the tool generate perfect PROGMEM code.

1. Open the Image2CPP Converter
2. Drag your image into the upload zone
3. Set canvas size to 128 × 64 (or match your OLED)
4. Set background to White (pixels that are ON will become black after dithering)
5. Pick a dithering mode — Atkinson for logos, Floyd-Steinberg for photos
6. Click Generate Code and copy the output

Here is a complete working sketch. Replace the epd_bitmap_myImage array with your own output from the converter:

#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

#define SCREEN_WIDTH  128
#define SCREEN_HEIGHT 64
#define OLED_RESET    -1
#define SCREEN_ADDR   0x3C  // or 0x3D

Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET);

// ===== Paste your image2cpp output below =====
const unsigned char epd_bitmap_myImage [] PROGMEM = {
  0x00, 0x00, 0x01, 0x80, 0x03, 0xc0, 0x07, 0xe0,
  // ... rest of your bytes ...
};

void setup() {
  Serial.begin(9600);
  if (!display.begin(SSD1306_SWITCHCAPVCC, SCREEN_ADDR)) {
    Serial.println("SSD1306 allocation failed");
    for(;;);
  }
  display.clearDisplay();
  display.drawBitmap(0, 0, epd_bitmap_myImage, 128, 64, SSD1306_WHITE);
  display.display();
}

void loop() {}

Click Upload in the Arduino IDE. In a few seconds, your image should appear on the OLED!

If you prefer the smaller, faster u8g2 library:

#include <U8g2lib.h>
#include <Wire.h>

U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, U8X8_PIN_NONE);

const unsigned char myImage [] PROGMEM = {
  // ... your bytes (remember to enable 'Swap bits' in image2cpp) ...
};

void setup() {
  u8g2.begin();
}

void loop() {
  u8g2.clearBuffer();
  u8g2.drawXBMP(0, 0, 128, 64, myImage);
  u8g2.sendBuffer();
  delay(1000);
}