Arduino OLED Resources
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.
- Documentation: MicroPython framebuf
- SSD1306 driver: MicroPython SSD1306
- Features: pixel, line, rect, fill, text, and blit (bitmap) methods
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
- Arduino OLED name animation (SSD1306), type a name, export PROGMEM frames
- SSD1306 scrolling text vs name animation, startscrollleft vs assemble
- DIY OLED name badge, desk toy build + power tips
- OLED logo splash screen, PNG assemble boot intro
- How to make a beautiful OLED animation, AI pixel art prompts, lyric timelines, free import tool guide
- Upload an OLED animation from GitHub to ESP8266, download, wire and upload guide with troubleshooting
- Dussehra OLED animation, 300-frame Ravana Dahan loop + free GitHub download
- Batman x Sajan Sajan OLED animation, 768-frame 30 fps video + free GitHub download
- Sajan Sajan Teri Dulhan Tujhko Pukare Aaja OLED animation (Alka Yagnik, Aarzoo 1999), 338-frame loop + free GitHub download
- Navratri Garba and Dandiya OLED animation, 390-frame loop + free GitHub download
- Bad Apple OLED animation, 385-frame loop + free GitHub download
- Thangamaana Tamil song OLED animation, 200-frame loop + free GitHub download
- Nazarome Chupale OLED animation, 150-frame song loop + free GitHub download
- Khayalon Ki Duniya OLED animation, 124-frame song loop + free GitHub download
- Ganesha Day 7 OLED animation, 150-frame Ganpati loop + free GitHub download
- Kalayani Song OLED animation, 148-frame song loop + free GitHub download
- Complete Arduino OLED wiring guide (SSD1306), beginner-friendly introduction
- Blank OLED screen checklist, fix address, wiring, and display()
- How to create SSD1306 animations, frame-by-frame animation tutorial
- Robot eyes OLED animation, blink, look, emotion states
- OLED weather station with DHT22, temp, humidity bar, icons
- U8g2 vs Adafruit SSD1306, pick a library for animations
- OLED power & battery life, contrast, sleep, DISPLAYOFF
- Convert GIF to Arduino OLED animation, import existing animations
- Image to byte array converter, bitmap generation guide
- Wireless WiFi OLED preview, preview animations on ESP8266/ESP32 without USB
- WebSerial live OLED preview, real-time USB preview in browser
- ESP32 OLED animation guide, wiring, code, and WiFi preview for ESP32
- SH1106 vs SSD1306, choosing the right OLED controller
- Draw OLED shapes in Arduino, using GFX primitives instead of bitmaps
Official Library Documentation
- Adafruit Monochrome OLED Guide
- Adafruit GFX Library, graphics primitives used by Adafruit SSD1306
- U8g2 Reference Manual
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 →