Skip to content
AWTRIX Flows
Submit flow
Clawd - a Tamagotchi for your AWTRIX shown on an AWTRIX display
Fig. 1 Clawd - a Tamagotchi for your AWTRIX, as Blueforcer runs it.

Clawd - a Tamagotchi for your AWTRIX

Virtual pet crab - feed, play, clean and raise it

Specifications
System AWTRIX NG Scripts
Firmware AWTRIX NG
Topic Miscellaneous
Built by Blueforcer
File wg0GspJj3sl7.ax · 11.1 KB
Icons
Published 7 Aug 2026 · updated 7 Aug 2026
Downloads 14

Clawd: a Tamagotchi for your AWTRIX

A fully-fledged virtual pet living on your 32x8 matrix. Clawd is a little orange
crab that hatches from an egg, grows through four life stages in real time, and depends
on you to keep it fed, happy, clean and rested. The simulation keeps running while other
apps are on screen, and it even catches up on time the device spent powered off.

Requirements & install

  • AWTRIX NG. The script is ~23 KB, so raise the script size limit to 32768 once before installing (WebUI System settings, or:)
    curl -X PUT http://<device>/api/v1/system -H 'Content-Type: application/json' -d '{"scriptMaxBytes": 32768}'
  • ESP32 S3 recommended. It can run on a standard ESP32, but it gets very, very tight with other scripts. Try to install it right after a AWTRIX reboot.
  • Time sync (NTP) recommended. Without it there is no day/night scenery, no auto-sleep and no offline catch-up; the pet then only lives while the device is on.
  • No icons, no network, no API keys: everything is drawn with primitives and runs entirely on the device. Progress is saved on the device and survives reboots.

What you see on screen

The left two thirds are Clawd's world, the right side shows its condition.

  • Four stat bars (right side, top to bottom):
    🟠 Hunger · 🟡 Happiness · 🔵 Energy · 🟢 Cleanliness.
    A full bar is 100 %. Below 25 % a bar blinks as a warning, and it keeps showing
    at least one pixel down to the very last percent.
  • Ground line (bottom): green by day, dark blue at night.
  • Sky: a small sun and a drifting cloud by day, moon and twinkling stars at night.
    Day and night follow the real clock (20:00 to 06:00 shows the night scenery).
  • Poop piles stack up next to the crab (up to 3). They drag cleanliness and
    happiness down until you clean up.
  • Blinking green dot in the top-left corner: Clawd is sick.
  • Blue "z" floating next to the crab: sleeping.
  • Red heart above the pet: positive feedback (for example warming the egg).
  • Red X over the pet: action refused (asleep, dead, too tired, or nothing to cure).
  • Green cross flash: healed by medicine.
  • Bright flashing of the whole sprite: hatching or evolving right now.
  • Egg stage: the egg wobbles, and the orange bar along the ground is the
    incubation progress.
  • Tombstone with a floating ghost: Clawd has died (see Death & restart).

Life stages

Stage Reached at (total age) Look
Egg start wobbling egg, ~30 min to hatch
Baby after hatching tiny crab, stubby claws
Child 12 h bigger, proper claws
Teen 36 h double claws
Adult 72 h full-grown, three possible forms

Age counts in real time, sleeping included, and (dampened) even while the device is
off. Which adult you get depends on your care score (see below):
thriving with brighter colors, bigger claws and a golden crown · normal ·
😠 grumpy with darker colors, red eyes and a permanent frown.

Egg tip: pressing the middle button warms the egg. Each press cuts 1 minute off
the incubation (up to half of it), and a little heart confirms it.

How care works

  • FEED restores 40 % hunger. Hunger drains from full to empty in about 4 h while
    awake (slower asleep). Feeding an already almost-full crab (over 90 %) is
    overfeeding and costs happiness; feeding a genuinely hungry crab (under 70 %) earns
    care points. 45 to 90 minutes after every meal, a poop appears.
  • Happiness drains in about 5.5 h, faster while sick or with 2+ poops around, and
    not at all during sleep. Playing restores it.
  • Energy drains in about 7 h awake and recovers during sleep (empty to full in
    roughly 2.5 h of sleep). Playing costs 8 % and needs at least 15 %, otherwise Clawd
    is too tired.
  • CLEAN sweeps all poop away and resets cleanliness to 100 %. Cleanliness also
    decays slowly on its own, and much faster per visible poop.
  • Sickness can strike whenever any need is below 20 % or 2+ poops are lying
    around. It is a small chance every 10 seconds, so bad conditions catch up with you
    within minutes rather than instantly. MED cures it; taking medicine costs a
    little happiness. MED without sickness does nothing.
  • Hidden health (HP): while hunger is at 0, cleanliness is at 0 or Clawd is sick,
    health drains. All three together kill in about an hour, starvation alone in about
    2.5 h. With everything fine, health slowly recovers. The current HP value is visible
    in STATS.
  • Care score: +10 for every genuinely helpful action (feeding when hungry,
    cleaning up poop, curing sickness, a good minigame), and −25 every time a need
    bottoms out at 0 or Clawd falls sick. The score decides the adult form.

Sleep

Clawd sleeps automatically from 22:00 to 08:00 (requires a synced clock). You can
override it any time with SLEEP/WAKE; the override lasts until the next
automatic switch point and survives reboots. While sleeping: energy regenerates,
hunger drains at half speed, happiness doesn't drain, no poop, no sickness. Feeding,
playing and cleaning are refused ("let me sleep").

Controls

Left/right switch apps as usual. Everything else is the middle button:

  • Press once and the action menu opens. Every further press moves to the next item:
Item Effect
EXIT closes the menu (first item on purpose, so accidental opens are harmless)
FEED +40 % hunger
PLAY starts the Star Catch minigame
CLEAN removes all poop, cleanliness back to 100 %
MED cures sickness
SLEEP / WAKE manual sleep toggle (label follows the current state)
STATS scrolls name, age, generation, care score and HP once across the screen
  • The highlighted item shows an orange bar filling along the bottom row (2 s).
    Let it fill and the action executes. Press before it fills to move on.
  • The menu never times out into a surprise: if you walk away, whatever is selected
    executes once, and since a fresh menu always starts on EXIT, doing nothing simply
    closes it.
  • Timing tip: leave at least a third of a second between presses. Two presses
    within ~0.3 s are the firmware's own display on/off double-click. If that happens,
    or a notification overlays the game, Clawd closes the menu safely; it never
    executes an action you couldn't see.

Star Catch (the minigame)

A yellow star sweeps back and forth along the top row. Press the middle button when
the star is between the two orange posts on the left, right above the crab. Three
rounds, each one faster; waiting longer than 6 s counts as a miss. Every catch is
+10 % happiness, all three add a +5 % bonus (and hearts). The dots in the top-right
corner count your hits. Playing costs 8 % energy.

Death & restart

If health reaches zero, the scene changes to a tombstone with Clawd's ghost floating
beside it. Starting over is deliberately a two-step confirm: the first press shows
NEW EGG? dimmed (it disappears again after 6 s if you do nothing), a second press
starts a 3-second confirm bar, a third press cancels. Once confirmed, a new egg of the
next generation appears. The generation counter is kept forever and shown in STATS.

While you're away

  • The simulation runs at full speed as long as the device is on, whatever app is
    showing.
  • If the device was powered off, Clawd catches up once the clock re-syncs: up to
    12 h of missed time at a gentle 30 % rate. It naps while the power is out, so nobody
    starves overnight in a drawer.
  • Notifications (optional, off by default): when a need drops below 15 % or Clawd
    falls sick, it interrupts the rotation with " needs you!", at most once per
    30 minutes, even across reboots.

Settings (gear icon on the app)

  • Pet name: shown in stats and notifications
  • Sound: little RTTTL jingles for hatching, meals, evolution, sickness, the
    minigame and death. Off by default.
  • Notifications: the "needs you" alerts described above. Off by default.

More flows for AWTRIX NG Scripts or Miscellaneous

Something wrong with this flow? Report it.