OLED Animation Maker OLED Maker
Libraries, hardware, wiring and tutorials

Arduino OLED Resources

Complete guide to libraries, hardware, tutorials, and tools

This page collects the resources I'd point you to for working with Arduino OLED displays, including the popular SSD1306 and SH1106 controllers. Maybe you're wiring your first display. Maybe you're building advanced animations. Either way, you'll find links, documentation, and guides here.

Arduino OLED Libraries

The right library saves you a lot of grief. Here are the popular, well-maintained options:

Adafruit SSD1306

The Adafruit SSD1306 library is beginner-friendly and feature-rich. It supports I²C and SPI communication, multiple display sizes (128×64, 128×32, 96×16, 72×40), and lots of graphics primitives through Adafruit GFX.

  • GitHub: Adafruit_SSD1306
  • Installation: Arduino Library Manager → search "Adafruit SSD1306"
  • Documentation: Adafruit OLED Guide
  • Features: drawPixel, drawLine, drawRect, drawCircle, drawBitmap, text rendering
  • Compatible boards: Arduino Uno, Nano, Mega, ESP32, ESP8266, Raspberry Pi Pico (with Arduino core)

U8g2

U8g2 is a monochrome graphics library that supports over 200 display types, including SSD1306, SH1106, and many others. It's tuned for memory-constrained boards, and you get plenty of fonts.

  • GitHub: U8g2
  • Installation: Arduino Library Manager → search "U8g2"
  • Documentation: U8g2 Wiki
  • Features: 100+ fonts, Unicode support, full buffer and page buffer modes, low memory footprint
  • Display support: SSD1306, SH1106, SSD1309, SH1107, and 200+ more

MicroPython framebuf

For MicroPython users (Raspberry Pi Pico, ESP32, ESP8266), the built-in framebuf module combined with SSD1306 or SH1106 drivers gives you pixel-level control and basic drawing functions.

Recommended OLED Hardware

Most Arduino OLED projects use small monochrome displays in the 0.96" to 1.3" range. Here's what I'd look for:

Display Types

  • 0.96" 128×64 SSD1306 (I²C): The most popular beginner display. You'll find it everywhere, in blue or white pixels, and it's typically at address 0x3C
  • 1.3" 128×64 SH1106 (I²C): Slightly larger pixels, and you'll need a 2-pixel X offset in code
  • 0.91" 128×32 SSD1306 (I²C): A compact option when you only need a status display
  • 0.42" 72×40 SSD1306/SSD1315 (I²C): A tiny wearable/badge display, and it's common on mini OLED modules
  • Yellow-Blue 128×64 SSD1306: Top 16 rows yellow, bottom 48 blue. It's ideal for headers and content

I²C vs SPI

Most hobbyist displays use I²C (2 data pins: SDA and SCL) because it's simple to wire and you can put several devices on the same bus. SPI displays are faster and better for high frame rate animations but require more pins (MOSI, SCK, CS, DC, RST).

Protocol Wiring Speed Best For
I²C 4 pins (VCC, GND, SDA, SCL) Standard (100-400 kHz) Beginners, multi-device projects
SPI 7 pins (VCC, GND, MOSI, SCK, CS, DC, RST) Fast (up to 10 MHz+) High frame rate animations

Where to Buy

You can pick up Arduino OLED displays from these places:

  • Adafruit: Good-quality modules with excellent documentation
  • SparkFun: Reliable boards, and they've got hookup guides
  • AliExpress / Banggood: Budget-friendly options (check the reviews first, quality varies)
  • Amazon: Fast shipping, and you'll find a lot of sellers
  • Local electronics stores: You'll be supporting local makers

Wiring Guides

Wiring has to be right, or you'll get a blank screen. Here are the standard I²C wiring configurations for popular boards:

Arduino Uno / Nano

  • VCC → 5V (some displays need 3.3V, check datasheet)
  • GND → GND
  • SDA → A4
  • SCL → A5

ESP8266 (NodeMCU, Wemos D1 Mini)

  • VCC → 3.3V
  • GND → GND
  • SDA → D2 (GPIO4)
  • SCL → D1 (GPIO5)

ESP32 DevKit

  • VCC → 3.3V
  • GND → GND
  • SDA → GPIO21
  • SCL → GPIO22

ESP32-C3 Mini, C3 DevKit, S2, S3, and C6 Mini

  • VCC → 3.3V
  • GND → GND
  • SDA → GPIO8
  • SCL → GPIO9

ESP32-C6 DevKit (the Espressif board, not the Super Mini) uses GPIO6 (SDA) and GPIO7 (SCL).

Seeed XIAO ESP32

  • XIAO ESP32-C3: SDA D4 (GPIO6), SCL D5 (GPIO7), power from 3.3V
  • XIAO ESP32-S3 and S3 Sense: SDA D4 (GPIO5), SCL D5 (GPIO6)
  • XIAO ESP32-C6: SDA D4 (GPIO22), SCL D5 (GPIO23)
  • XIAO RP2040: SDA D4 (GP6), SCL D5 (GP7), MicroPython export

Raspberry Pi Pico (MicroPython)

  • VCC → 3.3V (pin 36)
  • GND → GND (pin 38)
  • SDA → GP0 (I2C0 SDA)
  • SCL → GP1 (I2C0 SCL)

For complete wiring diagrams with photos, check our Arduino OLED tutorial.

Troubleshooting Common Issues

Display shows nothing / blank screen

  • Check power: Make sure you've connected VCC to the correct voltage (3.3V or 5V)
  • Verify I²C address: Most displays use 0x3C, but some use 0x3D. Run an I²C scanner sketch and you'll see which one yours is
  • Check wiring: Your SDA and SCL must go to the correct pins
  • Add display.display(): The Adafruit library needs you to call display.display() before the screen updates

Animation is slow or choppy

  • Reduce frame count: Big animations take time to upload to the display, so you'll notice it
  • Increase I²C speed: Add Wire.setClock(400000); for fast mode (400 kHz), and you'll feel the difference
  • Use partial updates: Don't call display.clearDisplay() every frame, just redraw the areas that changed
  • Switch to SPI: SPI displays are 10× faster than I²C for animation-heavy projects

SH1106 displays show shifted graphics

SH1106 controllers have a 2-pixel column offset. Our OLED Animation Maker adds this offset for you when you select SH1106 as the display type. If you're using other tools, add 2 to all X coordinates in drawBitmap calls.

Multiple OLED displays don't work

  • Change I²C address: Solder the address jumper on the back of the display and you'll switch from 0x3C to 0x3D
  • Use an I²C multiplexer: With the TCA9548A you can run up to 8 I²C devices with the same address
  • Use our dual screen mode: Our tool generates code for two SSD1306 displays with different addresses

Learning Resources and Tutorials

These step-by-step guides will help you get the hang of Arduino OLED displays:

Example sketches on GitHub

Five small, tested sketches you can upload as they are. You get robot eyes, a loading spinner, weather icons, two OLEDs on one I2C bus, and a PROGMEM frame player in the same format this editor exports. MIT licensed. AshishY794/oled-animation-examples

Our Tutorials

Official Library Documentation

Community Resources

  • Arduino Forum: Arduino Community, where you can ask questions and share your projects
  • Reddit: r/arduino, an active maker community you can join
  • Adafruit Learning System: Adafruit Learn, with hundreds of free tutorials you can read

Tools and Utilities

These free tools help you work with Arduino OLED displays:

  • OLED Display Animation Maker (our tool), create animations, import GIFs, generate Arduino code
  • Assemble Studio: type text, import an image, or draw, then export the assemble animation (Adafruit / U8g2 / MicroPython)
  • I²C Scanner: Arduino sketch to detect I²C device addresses, Arduino Playground
  • Font converter: Generate custom fonts for Adafruit GFX, truetype2gfx

Project Ideas

Need an idea for your next Arduino OLED project? Try one of these:

  • Text, image, or drawing: Build a particle assemble splash with Assemble Studio instead of plain scrolling text
  • Weather station: Display temperature, humidity, and forecast icons from an API
  • Smart clock: Show time, date, and animated transitions
  • IoT dashboard: Real-time sensor data visualization
  • Game console: Retro pixel games (Pong, Snake, Tetris) on SSD1306
  • Music visualizer: Animated spectrum analyzer synced to audio
  • Robot face: Animated eyes and expressions for robotics projects
  • Status indicator: System health, network status, or build server dashboard
  • Smart home controller: Control lights, view camera feeds, or display notifications

Stay Updated

Follow our OLED Arduino blog for new tutorials, tips, and project showcases. You can also find me on Instagram @oled_animator or write to me through the contact page.

Start creating OLED animations

Use our free online tool to design animations, import GIFs, and export Arduino code in minutes. Or open Assemble Studio to assemble text, an image, or a drawing.

Open OLED Animation Maker →