Source: https://mokxi.com/ideas/ssd1306-projects
Updated: 2026-11-17

Projects / Project ideas
Project ideas by part

# OLED display projects

34 Mokxi projects use an SSD1306 OLED display (2 beginner, 13 intermediate and 19 advanced). They run on Arduino Uno, ESP32 and Raspberry Pi Pico boards. Here are 24, from “SSD1306 OLED on an ESP32 with MicroPython” to “Fight stick on a Pico”. Each card says what the project does, the board and parts it needs and its level, and Open in the simulator runs it in your browser in one click, with no account.

First project

## How to pick your first one

- Start with “CircuitPython OLED text on a Pico”, a beginner project that needs an OLED display.
- Arduino Uno runs 19 of them, ESP32 6 and Raspberry Pi Pico 5. Start on the board you have, or on an Arduino Uno if you are buying one.
- The parts used most here are the arcade button (10 projects), the piezo speaker (9) and the push button (5). With those on hand, most of this list is open to you.
- Before you build one on a real bench, read the SSD1306 OLED display wiring guide for your board below. It gives every pin and the voltage notes.

Projects

## 24 projects of 34

### SSD1306 OLED on an ESP32 with MicroPython

MicroPython on an ESP32 DevKit: machine.I2C on D22 and D21 and micropython-lib’s ssd1306.py draw text and a counter on an SSD1306 OLED.

Board

ESP32 DevKit V1

Parts

SSD1306 OLED display

Level

Beginner

Open in the simulator

### CircuitPython OLED text on a Pico

CircuitPython on a Raspberry Pi Pico: displayio and Adafruit’s display_text draw a title and a counter on an SSD1306 OLED over I2C.

Board

Raspberry Pi Pico

Parts

SSD1306 OLED display

Level

Beginner

Open in the simulator

### Stream deck on a Pro Micro

Six keys with their labels drawn on an SSD1306 OLED, a second page on the sixth key, and a Ctrl+Shift+F-key hotkey for each press through Keyboard.h.

Board

SparkFun Pro Micro

Parts

SSD1306 OLED display, arcade button

Level

Intermediate

Open in the simulator

### OLED dice

A die tumbling on a 128x64 OLED, thrown by holding an arcade button and slowing to a stop when you let go.

Board

ESP32-C3-DevKitM-1

Parts

SSD1306 OLED display, arcade button

Level

Intermediate

Open in the simulator

### SSD1306 OLED on a Pi with smbus2

A Raspberry Pi 4 draws text on an SSD1306 OLED over I2C bus 1 with smbus2: an uptime counter each second, and how long each frame takes at 100 kHz.

Board

Raspberry Pi 4 Model B

Parts

SSD1306 OLED display

Level

Intermediate

Open in the simulator

### MicroPython BME280 weather on an OLED

MicroPython on a Raspberry Pi Pico: machine.I2C reads a BME280 and shows temperature, pressure and humidity on an SSD1306 OLED with ssd1306.py.

Board

Raspberry Pi Pico

Parts

SSD1306 OLED display, BME280 weather sensor

Level

Intermediate

Open in the simulator

### Indoor and outdoor thermometer on two OLEDs

Two BME280s and two SSD1306 OLEDs share their addresses, so a TCA9548A puts each pair on its own channel: each screen shows its own weather.

Board

Arduino Uno R3

Parts

I2C multiplexer, BME280 weather sensor, SSD1306 OLED display

Level

Intermediate

Open in the simulator

### Heartbeat monitor

A Pulse Sensor on a fingertip, PulseSensor Playground finding the beats, and an OLED drawing the wave scrolling by with the heart rate over it.

Board

Arduino Uno R3

Parts

Pulse sensor, SSD1306 OLED display

Level

Intermediate

Open in the simulator

### Binary clock

An ESP32-C3 writes the hours, minutes and seconds as three rows of binary lamps on a 128x64 OLED.

Board

ESP32-C3-DevKitM-1

Parts

SSD1306 OLED display

Level

Intermediate

Open in the simulator

### Flappy Bird on an OLED

Flappy Bird on an OLED with an Arduino: one button to flap through the pipes, gravity in whole numbers, sound on a piezo and the best score in EEPROM.

Board

Arduino Uno R3

Parts

Arcade button, piezo speaker, SSD1306 OLED display

Level

Intermediate

Open in the simulator

### GPS speedometer with a trip odometer

A NEO-6M and NeoGPS show speed, heading and satellites on an OLED, and a trip and total distance saved in EEPROM survive a reset.

Board

Arduino Uno R3

Parts

GPS module, push button, SSD1306 OLED display

Level

Intermediate

Open in the simulator

### OLED on an ESP32-C3

A 128x64 SSD1306 OLED on an ESP32-C3 over bit-banged I2C: titles, shapes, a bouncing ball and a counter.

Board

ESP32-C3-DevKitM-1

Parts

SSD1306 OLED display

Level

Intermediate

Open in the simulator

### Pocket pet

A Tamagotchi-style pet on a 128x64 OLED: hatch it, feed it, play two mini-games, clean up, and it remembers you after a reset.

Board

Arduino Uno R3

Parts

SSD1306 OLED display, push button, piezo speaker

Level

Advanced

Open in the simulator

### Leverless controller on a Pico

A full leverless build on GP2040-CE’s Pico pins: SOCD and D-pad or stick modes on button combos, turbo.

Board

Raspberry Pi Pico

Parts

SSD1306 OLED display, arcade button, LED arcade button

Level

Advanced

Open in the simulator

### Mixbox-style controller on a Pico

W A S D directions for the left hand and eight lit buttons for the right, on GP2040-CE’s Pico pins, with SOCD modes, turbo and an OLED input display.

Board

Raspberry Pi Pico

Parts

SSD1306 OLED display, arcade button, LED arcade button

Level

Advanced

Open in the simulator

### Space Invaders on an OLED

Space Invaders on an OLED with an Arduino: invaders that march faster as you shoot them, three buttons to move and fire, bombs.

Board

Arduino Uno R3

Parts

Arcade button, piezo speaker, SSD1306 OLED display

Level

Advanced

Open in the simulator

### Word game

Guess the five-letter word in six tries on an OLED, picking letters with a rotary knob.

Board

Arduino Uno R3

Parts

KY-040 rotary encoder, SSD1306 OLED display

Level

Advanced

Open in the simulator

### OLED pong on an ESP32-C3

Thumb-stick pong on an ESP32-C3 and an OLED: a twelve-bit ADC moves the paddle and the score is drawn in digits.

Board

ESP32-C3-DevKitM-1

Parts

SSD1306 OLED display, joystick

Level

Advanced

Open in the simulator

### Balance bot

A two-wheel robot that balances itself: its MPU6050 through a complementary filter, a PID with three knobs for live Kp, Ki and Kd.

Board

Arduino Uno R3

Parts

Self-balancing robot, potentiometer, SSD1306 OLED display

Level

Advanced

Open in the simulator

### Audio spectrum analyzer

An INMP441 I2S microphone on an ESP32, a 256-point FFT, and sixteen dancing bars with peak-hold dots on an OLED.

Board

ESP32 DevKit V1

Parts

I2S microphone, SSD1306 OLED display

Level

Advanced

Open in the simulator

### Macro pad for streamers and coders

A Pro Micro that plugs in as a keyboard: twelve keys of shortcuts, a volume knob, three layers with a lamp each and an OLED.

Board

SparkFun Pro Micro

Parts

4x3 telephone keypad, KY-040 rotary encoder, SSD1306 OLED display, LED, resistor

Level

Advanced

Open in the simulator

### Breakout game on an OLED

Breakout game on an OLED with a knob for the paddle: 32 bricks, three lives, a faster ball for every wall you clear, and sound on a piezo.

Board

Arduino Mega 2560 R3

Parts

SSD1306 OLED display, arcade button, piezo speaker, potentiometer

Level

Advanced

Open in the simulator

### Seismograph

An MPU6050 with gravity filtered out and a SW-420 vibration switch.

Board

Arduino Uno R3

Parts

MPU6050 accelerometer and gyro, vibration sensor, SSD1306 OLED display

Level

Advanced

Open in the simulator

### Fight stick on a Pico

A Sanwa-style lever and eight lit buttons on GP2040-CE’s Pico pins, with SOCD and stick modes on button combos.

Board

Raspberry Pi Pico

Parts

SSD1306 OLED display, arcade joystick lever, LED arcade button, arcade button

Level

Advanced

Open in the simulator

Keep going

## Wiring, libraries and more ideas

The SSD1306 OLED display part page Every project ideas list

### Wiring guides

- SSD1306 OLED to Arduino Uno
- SSD1306 OLED to Raspberry Pi Pico
- SSD1306 OLED to ESP32
- SSD1306 OLED to Arduino Mega
- SSD1306 OLED to Arduino Nano

### Library pages

- Adafruit GFX library
- Adafruit SSD1306 library
- SSD1306Ascii library
- OLED_I2C library
- QRCode library
- U8g2 library

### More project ideas

- Arduino Uno project ideas
- ESP32 project ideas
- Raspberry Pi Pico project ideas
- Pro Micro and Leonardo project ideas
- Projects with an arcade button
- Projects with a piezo speaker
- Projects with a push button
- Projects with a lit arcade button
- Projects with a joystick
- Projects with a potentiometer
- Projects with a rotary encoder
