Custom Interface
Personalize ESP32 display devices with fonts, emoji, backgrounds, and wake words.
Overview
Some ESP32 devices include a display for text, emotion emoji, backgrounds, and conversation status. Custom interface settings let you create a visual package and send it to the device.
You can use this feature to:
- Choose fonts that match the assistant's language.
- Change the emoji/emotion set shown on the display.
- Set light/dark background colors or images.
- Configure a wake word when the chip and firmware support it.
When Should I Customize It?
| Need | Recommendation |
|---|---|
| The assistant uses Vietnamese or another accented language | Choose a font with full language support. |
| The device is used in a store, showroom, or office | Match colors, emoji, and fonts to the brand. |
| The device has a small display | Use readable fonts, modest emoji sizes, and simple backgrounds. |
| The device needs a custom wake word | Check whether the chip and firmware support custom wake words. |
Customization Flow
Step 1: Select the device
Choose the correct board, chip, and display size. If the resolution is wrong, backgrounds or emoji may look stretched or misaligned.
Step 2: Choose fonts
Pick a font that includes the characters needed by the assistant's primary language. For Vietnamese, use a font with full Vietnamese accent support.
Step 3: Choose emoji and backgrounds
Select an emotion set and light/dark backgrounds. Simple backgrounds usually make text and status easier to read.
Step 4: Export the interface package
Review the preview and export the interface package as assets.bin.
Step 5: Send it to the device
Open Devices in the dashboard, choose the ESP32 device, and upload assets.bin. The device downloads the package and applies it after the update finishes.
Content Guidelines
| Item | Guidance |
|---|---|
| Fonts | Choose fonts that cover the assistant's main language. Very large fonts can make the package heavier. |
| Emoji | Use an emoji set sized for the display. Animated images look richer but may require more memory. |
| Backgrounds | Avoid busy images because they can make text hard to read. |
| Wake word | Custom wake words depend on chip and firmware support. |
Supported Devices
Custom interface packages only apply to ESP32 devices with a display and firmware support. Headless devices, web chat, and watch clients do not use this feature.
If the device does not apply the new interface, check the board, display size, and firmware version. Then restart the device and upload the package again.