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.
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.
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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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
Wiring, libraries and more ideas
Wiring guides
Library pages
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