MysterBox
MysterBox is a small, pocketable color display with its own firmware, made for magicians. It shows secret information sent by MysterSmith: texts, drawings, images, playing cards, dice. It also reacts to touches, buttons and movement. When no app is connected, it can be a cute robot companion or a live display for Bluetooth dice.
The hardware
MysterBox runs on the Waveshare ESP32-S3-Touch-AMOLED-1.8 board (version V2):
- 1.8″ color AMOLED touch screen (368 × 448) – black pixels are really off, so a black screen looks like a switched-off device
- Bluetooth Low Energy, a motion sensor, a small speaker, a microSD card slot
- BOOT and PWR buttons, battery connector and charging over USB-C
You install the MysterBox firmware on the board yourself, from your browser (see below). A board that still runs its factory firmware (for example the Xiaozhi AI demo) works too, the installer simply replaces it.
Where to buy
Only buy this exact same model, WITH battery!
MysterBox runs only on the Waveshare ESP32-S3-Touch-AMOLED-1.8. Other sizes and similar-looking boards will not work. Choose the version with battery: without one, the box only works while it is plugged in.
Watch out for the ESP32-C6 version! The ESP32-C6-Touch-AMOLED-1.8 looks exactly the same (same case, same screen, same label design), but it has a different chip and cannot run MysterBox. The name on the label and in the listing must start with ESP32-S3. Many shops (AliExpress, Amazon) sell several variants on one page, so check the selected variant before you pay: ESP32-S3, with battery.
- Waveshare (official store)
- Amazon: UK · US · Italy
- AliExpress
- OpenELAB
- Hubtronics (India)
Is a microSD card needed?
No. Without a card, MysterBox stores the images and sounds sent by the app in its internal memory (about 3 MB). A microSD card (FAT32) gives much more space, and you need it to save screenshots: without a card, the box shows Insert SD card to save screenshots. MysterBox looks for the card when it starts, so insert it before switching the box on.
Coming soon: MysterBox Watch
Support for the Waveshare ESP32-S3-Touch-AMOLED-2.06 watch board is in the works. It will be installable from the same page.
Installing and updating the firmware
The firmware is installed and updated from your browser, over USB. No program to download, no driver needed.
⬇ Open the MysterBox firmware installer
- Use Google Chrome or Microsoft Edge on a computer (Windows, macOS or Linux). Phones and tablets can't do this.
- Connect the board with a USB-C data cable. Some cables only charge.
- Click Connect & install and choose the port called USB JTAG/serial debug unit.
- Choose Install MysterBox and wait about a minute. The box restarts by itself when it's done.
Erase or not?
- Updating MysterBox: leave Erase device unticked. Your settings and the files stored inside the box stay. The SD card is never touched.
- First install (the board still runs its factory firmware): tick Erase device. The first start then takes a few seconds longer while the internal memory is prepared.
The installer page also shows the release notes of every version. The version on your box is shown at the bottom of the mode menu (hold BOOT for one second) and on the start screen.
No port shows up in the list
- Try another cable and another USB port.
- Close other programs that may use the port, for example serial monitors or another browser tab with the installer.
- Use download mode: switch the box off (hold PWR until the screen goes dark), then keep BOOT pressed while you plug in the USB cable. The screen stays dark. Click Connect & install again. Afterwards press PWR or re-plug the cable to start the new firmware.
Buttons
| Button | What it does |
|---|---|
| PWR press | switches the box on |
| PWR hold for 2 seconds | switches the box off (“Bye-bye”) |
| BOOT hold for 1 second | opens the mode menu, from anywhere |
| BOOT short press | volume +10 % (on the dice screens: brightness +) |
| PWR short press | volume −10 % (on the dice screens: brightness −) |
| BOOT double press | robot ↔ Pitata Dice screen |
| PWR double press | robot ↔ BLE Dice screen |
| BOOT + PWR together | saves a screenshot to the SD card (with a camera sound) |
Short presses are also sent to MysterSmith, so they can trigger actions when the app is connected. On the robot and dice screens, a short press takes effect after a moment, because MysterBox waits to see whether a double press is coming.
Screenshots are saved as mb/shots/0001.bmp, mb/shots/0002.bmp... on the SD card. Without a card, no screenshot is taken and the box shows a short message instead.
The mode menu
Hold BOOT for one second, anywhere, to open the menu:
- Mr.Boxy – the robot face
- Pitata Dice – live display of the three Pitata dice
- BLE Dice – live display of up to five BLE dice
- Standby – the start screen, waiting for the app. When the app is connected, the screen stays black.
Tap a line to choose it. You can also step with BOOT (or swipe up / down) and choose with PWR. Holding BOOT again closes the menu and returns to where you were.
Mr.Boxy, the robot face
A pair of big white eyes with eyebrows. They blink, glance around, and react to the box:
- shake it – the eyes get confused and wander around the screen, with a puzzled sound
- stand it on its side – the eyes slide down; turn it upside down – the eyebrows flip; put it face down – the eyes close
- swipe to show an emotion with its own sound:
- up – excited (two pulsing yellow stars)
- down – sad
- left – angry (red eyes, growling)
- right – love (pulsing pink hearts, a whistle)
- tap – a playing card appears in the wide-open eyes for 5 seconds: the value in the left eye, the suit in the right eye. Each tap shows the next card (A, 2, 3... K) with the suits taking turns. MysterSmith can show any card there with the playing card to Mr.Boxy action, and the Mr.Boxy happy / excited / sad / love / angry / surprised actions show an emotion for 4 seconds, with its sound (firmware 0.10.5 or newer).
Bluetooth dice screens
MysterBox can read Bluetooth dice by itself, without the app and without pairing. It listens to the values the dice broadcast and draws them on the screen. The total of the dice is shown in white digits next to them.
- Pitata Dice (the set of three: red, blue and white) – red and blue on top, white on the bottom left, the total on the bottom right.
- BLE Dice (the white dice with black pips) – up to five dice, arranged by how many are found: with five dice, two rows of two and the fifth die next to the total. The dice take their places in the order they are first seen.
A die shows ? until it is seen for the first time, and fades out when it has been silent for a minute. The dice screens make no sounds, and the short button presses change the brightness here.
Note
The two dice types have separate screens, so they never mix. Open them from the mode menu, or with a double press of BOOT (Pitata) or PWR (BLE Dice) on the robot screen.
MysterBox with MysterSmith
MysterBox connects to MysterSmith over Bluetooth, as a display device. The app can:
- show texts (automatically sized to fill the screen), handwriting, drawings, images, playing cards, dice, ESP symbols, emojis and magic squares
- play sounds and set the volume and brightness
- switch the screen black, so the box looks switched off
- use taps, swipes, shakes, the position of the box (screen up / down, standing, upside down, on its side) and the buttons as triggers for actions
The robot face and the dice screens stay on when the app connects. The first thing the app shows (a text, an image, a black screen) replaces them.
In testing
MysterBox support in MysterSmith is being tested now. It will appear in Settings → MY DEVICES with its own settings panel in an upcoming version.
