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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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, drawn in the Mokxi editor

    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