Use your ears¶
The ears animate without a phone. The app's Control screen selects effects, power and brightness; Colours manages palettes and Settings → LED output owns output tuning. Changes are confirmed by the headset. Pending, applied and saved are separate states; give coalesced saves time before removing power.
Physical controls¶
| Single-button boards | Action |
|---|---|
| One click | LEDs off/on; resume from diagnostics |
| Two clicks | Temporary warm flashlight |
| Three clicks | Switch BLE/Wi-Fi |
| Four clicks | Enter LED diagnostics |
| Hold from 600 ms | Ramp brightness; release to stop |
| ESPurr v2 | Action |
|---|---|
| Button 1 one / two clicks | LEDs off/on / temporary flashlight |
| Button 1 four clicks | Enter LED diagnostics |
| Button 1 held five seconds | Switch BLE/Wi-Fi |
| Button 2 one / two clicks | Next / previous effect; dismiss flashlight first |
| Button 2 held from 600 ms | Ramp brightness |
During flashlight use, holds adjust its independent brightness. Successive holds alternate ramp direction. The v2 two-button current override is an experimental power-policy function; see the button contract before using it. It does not bypass qualification or faults.
Colours and brightness¶
Start at the default 20% brightness and tune on the real assembly. The estimated current limiter can reduce output below the requested level. Gamma and RGB trims affect output; they don't rewrite your saved palette colours. An independent background glow can remain visible when main brightness is zero. Global off clears both layers and the temporary flashlight.
Save named custom palettes on the phone, or select a stock palette. Overlays such as Raised tip and red/green gestures sit above the selected effect. See palettes, motion effects and overlays for exact behaviour.
Calibrate motion after mounting¶
Use the phone's mounting calibration. Capture a neutral head position, then a gentle right tilt of 10–60°. Hold each position still for at least two seconds; each capture has a five-second deadline. Keep the board mounted as it will be worn. Recalibrate after changing its orientation. Neutral-only recenter preserves the learned axes.
General activity can drive Motion twinkle without mounting calibration. Directional effects need a valid calibration; missing motion falls back to an idle appearance. The phone's local simulation illustrates settings and phone motion. It isn't a measurement of the headset's output or sensors.