bot/docs/platforms/mac/icon.md at replay/upstream-sync

mirror of https://github.com/hanzoai/bot.git synced 2026-10-30 17:24:26 +00:00

Files

T

zooqueen 071e3f1082 rebrand: openclaw -> hanzo bot across entire codebase

Automated rebrand of all openclaw references to hanzo bot:
- Package: openclaw -> @hanzo/bot
- Binary: openclaw -> hanzo-bot
- Config: ~/.openclaw -> ~/.hanzo/bot
- Docker: ghcr.io/hanzoai/bot
- Env vars: OPENCLAW_* -> BOT_*
- Bundle IDs: ai.hanzo.bot.*
- Product name: Hanzo Bot

2026-03-19 13:52:32 -07:00

2.0 KiB

Raw Permalink Blame History

summary, read_when, title

summary

read_when

title

Menu bar icon states and animations for Hanzo Bot on macOS

Changing menu bar icon behavior

Menu Bar Icon

Author: steipete · Updated: 2025-12-06 · Scope: macOS app (apps/macos)

Idle: Normal icon animation (blink, occasional wiggle).
Paused: Status item uses appearsDisabled; no motion.
Voice trigger (big ears): Voice wake detector calls AppState.triggerVoiceEars(ttl: nil) when the wake word is heard, keeping earBoostActive=true while the utterance is captured. Ears scale up (1.9x), get circular ear holes for readability, then drop via stopVoiceEars() after 1s of silence. Only fired from the in-app voice pipeline.
Working (agent running): AppState.isWorking=true drives a “tail/leg scurry” micro-motion: faster leg wiggle and slight offset while work is in-flight. Currently toggled around WebChat agent runs; add the same toggle around other long tasks when you wire them.

Wiring points

Voice wake: runtime/tester call AppState.triggerVoiceEars(ttl: nil) on trigger and stopVoiceEars() after 1s of silence to match the capture window.
Agent activity: set AppStateStore.shared.setWorking(true/false) around work spans (already done in WebChat agent call). Keep spans short and reset in defer blocks to avoid stuck animations.

Shapes & sizes

Base icon drawn in CritterIconRenderer.makeIcon(blink:legWiggle:earWiggle:earScale:earHoles:).
Ear scale defaults to 1.0; voice boost sets earScale=1.9 and toggles earHoles=true without changing overall frame (18×18 pt template image rendered into a 36×36 px Retina backing store).
Scurry uses leg wiggle up to ~1.0 with a small horizontal jiggle; it’s additive to any existing idle wiggle.

Behavioral notes

No external CLI/broker toggle for ears/working; keep it internal to the app’s own signals to avoid accidental flapping.
Keep TTLs short (<10s) so the icon returns to baseline quickly if a job hangs.

2.0 KiB Raw Permalink Blame History Unescape Escape

Menu Bar Icon States

2.0 KiB

Raw Permalink Blame History