The idea behind the project
I wanted to make it easier to give small DIY robots a little more personality.
Many hobby projects use small OLED displays to show information, but I wanted to use the display for something more expressive: animated eyes, emotions, and simple facial reactions.
That idea led me to build Dumirror_Robo, an open-source Arduino library for creating expressive robot faces on SSD1306 OLED displays.
I also wanted the library to be useful for people with different levels of experience, from beginners experimenting with their first Arduino project to makers building more advanced robots.
How Does It Work?
Watch Mochi come to life! Here's a real hardware demo of Dumirror_Robo running on an OLED display.
▶ Watch the full demo on YouTube
Dumirror_Robo uses a 128×64 SSD1306 OLED display to draw facial expressions and animations.
The library includes:
- 19 built-in facial expressions
- 10 frame-based animations
- Non-blocking animation playback
- Support for custom animations
- Text rendering
- Configurable I2C settings
- PROGMEM-based bitmap storage on supported platforms
- Selectable face profiles for smaller AVR boards It is designed for Arduino-compatible platforms. I have tested it on Arduino Uno, ESP32-S3, and ESP32-C3. The library uses Adafruit GFX and Adafruit SSD1306. Meet Mochi
Mochi is the little robot I built to experiment with the library.
Its body is handmade from cardboard rather than 3D-printed. I wanted to keep the hardware simple and focus on what could be achieved with a small OLED display and a microcontroller.
Mochi can display different expressions and react with animations, making the project feel a little more like an interactive robot.
Hardware used
The project can be explored with:
- Arduino Uno
- ESP32-S3
- ESP32-C3
- SSD1306 128×64 I2C OLED display The repository also includes wiring diagrams and example code to help you get started.
Try It Yourself
Getting started is simple. You only need an Arduino-compatible board and an SSD1306 128×64 OLED display.
1. Install the library
- Download Dumirror_Robo.
- Install it through Arduino IDE using Sketch → Include Library → Add .ZIP Library.
- Install the Adafruit GFX and Adafruit SSD1306 dependencies.
2. Run your first example
#include <Arduino.h>
#include <Dumirror_Robo.h>
DumirrorRobo robo(8, 9);
void setup() {
robo.begin();
robo.showFaceByName("normal");
}
void loop() {
}
That's it! Your OLED display should now show the robot's face.
You can explore more examples in the GitHub repository.
Why make it open source?
I made Dumirror_Robo open source because I want other makers to be able to use it, experiment with it, and build their own expressive robots.
You don't need an expensive display or complicated hardware to get started. A small OLED screen and a compatible microcontroller are enough to begin experimenting.
There is still room for improvement, and I would like to see what other people build with it.
Try it yourself
GitHub Repository
Documentation and Examples
If you build something with Dumirror_Robo, I'd love to see your project!
if you liked it give us a star ⭐ please





Top comments (2)
Done ⭐😍😂
😁😁