Documentation Index
Fetch the complete documentation index at: https://mintlify.com/yousifamanuel/clawd-mochi/llms.txt
Use this file to discover all available pages before exploring further.
Eye size and position
These constants near the top ofclawd_mochi.ino control the eye appearance:
| Constant | Effect |
|---|---|
EYE_W | Width of each eye rectangle in pixels |
EYE_H | Height of each eye rectangle in pixels |
EYE_GAP | Distance between the two eyes in pixels |
EYE_OX | Shifts the eye pair horizontally across the display |
EYE_OY | Shifts the eye pair vertically upward from center |
EYE_OY pixels from the vertical midpoint.
Logo animation duration
The boot animation plays once when the device powers on. Two values inanimLogoReveal() control its timing:
1500 to shorten how long the completed logo is shown. Lower the speedMs(8) argument to draw the logo strokes faster.
The logo animation always plays once at boot and cannot be skipped at runtime.
Colors
Colors are initialized ininitColours() using the display library’s tft.color565(r, g, b) function, which converts 8-bit RGB values to the 16-bit RGB565 format required by the ST7789 display:
| Constant | Used for |
|---|---|
C_ORANGE | Eye color, accent lines, header borders |
C_DARKBG | Background in the Claude Code and terminal views |
C_MUTED | Muted text in the WiFi info screen |
C_GREEN | Terminal cursor block and clawd:~$ prompt |
r, g, b values with your target color in 0–255 range.
The eye animation background (animBgColor) defaults to C_ORANGE but updates in real time when you use the Background color picker in the web controller.
Animation speed
ThespeedMs(ms) helper scales every animation delay based on the current speed setting:
animSpeed is set at runtime via the speed slider in the web controller — you do not need to edit any code to change speed while the device is running.
| Slider value | Speed | Effect on ms |
|---|---|---|
| 1 | Slow | Doubled (ms * 2) |
| 2 | Normal | Unchanged |
| 3 | Fast | Halved (ms / 2) |
Terminal constants
These constants control the layout of the interactive terminal in the Claude Code view:| Constant | Effect |
|---|---|
TERM_COLS | Maximum characters before wrapping to the next row |
TERM_ROWS | Number of rows visible before the display scrolls |
TERM_CHAR_W | Width of each character cell in pixels |
TERM_CHAR_H | Height of each character cell in pixels |
TERM_PAD_X | Left margin before text begins |
TERM_PAD_Y | Top margin below the clawd@mochi terminal header |
TERM_CHAR_W or TERM_CHAR_H, recalculate TERM_COLS and TERM_ROWS to fit within the 240×240 display.
Ideas for extensions
New animations
Add new expressions, transitions, or idle behaviors to keep the display lively.
New views
Build a weather display, clock, notification badges, or pixel art scenes as additional view modes.
Sound
Wire up a small buzzer to an unused GPIO pin and add sound effects to animations.
Sensors
Connect a touch sensor or button for physical interaction without needing the web controller.
OTA updates
Add over-the-air firmware updates so you can flash new code without a USB cable.
MQTT / Home Assistant
Connect Clawd Mochi to smart home platforms via MQTT for automations and remote control.
