-
Notifications
You must be signed in to change notification settings - Fork 5
Usage
Everything is driven by screen gestures + the rotary knob.
| Gesture | Action |
|---|---|
| Swipe ← / → | Cycle the base screens (carousel) |
| Swipe up | Open the control tiles |
| Swipe down | Open the Settings list |
| Long-press (hold) | Start/stop the assistant (Alexa) - works on any screen (toggle in Settings → Voice Assistant → Hold to talk) |
| Tap | Context action (start timer, press a tile, confirm, ...) |
| Turn knob | Volume (with a brief volume bar on the ring) |
Saying the wake word "Alexa" also starts the assistant hands-free.
When the screen has dimmed off (idle / night), any tap or knob turn just wakes it - that first input only turns the backlight back on and is not acted on.
On power-up the device shows a short boot splash: "HELLO!" types out with a spinning arc on the screen and the LED ring animating, for about 5 seconds, then it cross-fades to the clock. Touch is ignored until the splash hands off. (This also marks the firmware as good - see the OTA rollback note in Troubleshooting.)
Swiping left/right loops through the screens you compiled in, in your screen_order. The
default order is:
- Clock - the home screen / watchface (time, date, battery, weather + room temp/humidity).
- Player - album art, title/artist, prev / play-pause / next, progress bar. Auto-switches to/from the clock when playback starts/stops.
- Timer - ring + big countdown (see below).
- Cool Cars - a lane-racer game.
- Space Wars - a vertical shooter.
- Snake 360 - a knob-steered snake across the whole round screen; eat fruit to grow, avoid the ring, your tail and the skulls. Keeps a top-10.
- Weather - today + a 7-day radial dial; turn the knob to scroll days. The centre shows the selected day's name, condition and high/low temps. Toggle °C/°F in Settings → Widgets → Weather.
-
Thermostat - a dial for a
climate.*entity: turn the knob to set the target temperature (sent to HA ~0.6 s after you stop), tap toggles it on/off. The centre shows the target, the current temperature and humidity, and the accent colour follows the action (orange heating / blue cooling / teal idle / grey off). - Demo - a small commented example screen: tap flips the background black↔white. Its border and LED-ring toggles live in Settings → Widgets → Demo.
Each screen is optional - drop or reorder them in guition-va.yaml (see
Configuration). In the two games the knob steers; entering/leaving a
game resets it.
- On the Timer screen: turn the knob to set minutes, tap ▶ to start. While running you get pause and stop buttons and a depleting ring.
- By voice: "Alexa, set a timer for 10 minutes" - Home Assistant counts down and the puck shows the same screen.
- When it reaches zero: alarm - sound + an ALARM screen + red ring flash. Tap to dismiss.
- A small red badge on the home screen shows the remaining minutes while a timer runs.
- The timer/alarm features work even if the timer screen is dropped from the carousel.
Four configurable tiles, each toggling any Home Assistant entity (light / switch / fan /
input_boolean / ...). Each tile has its own icon and label, and its colour reflects the
live on/off state. Set the entity, icon and name per tile in guition-va.yaml - see
Configuration.
A scrollable list: Display · Home screen · Widgets · LED Ring · Voice Assistant · System. Turn the knob to scroll, tap to enter, swipe-right / hold to go back.
- Display - Brightness, Night mode, Night from, Night to, Screen auto-off (idle timeout).
- Home screen - Show weather, Show climate (room temp/humidity), and Watchface (see below).
-
Widgets - per-screen options, one group per screen (only the screens you compiled in appear):
- Demo - Border on/off, Demo LED on/off.
- Cool Cars / Space Wars - Reset high scores (with confirmation), per game.
- Weather - Fahrenheit (°C/°F).
- LED Ring - toggle which reactions the LED ring shows: Assistant, Timer, Alarm, Volume (all persistent).
- Voice Assistant - Wake word on/off, Beep on wake on/off, Hold to talk on/off (inline toggles).
- System - Info (IP/version), Battery (voltage/%), Restart, Factory reset.
Inside a sub-menu: knob scrolls, tap toggles/enters the selected item, the switch on the right shows its state. In Widgets, tap a screen's group to open its own options; swipe-right / hold steps back one level.
The home screen's look is a watchface, chosen in Settings → Home screen → Watchface. Tapping it opens a live, full-screen picker: turn the knob to flip between faces (you see the real face, not a thumbnail), tap to keep, swipe-right / hold to cancel. The choice is remembered across reboots.
- Classic - the default; clock, date, battery, weather + room temp/humidity.
- Neon - big two-tone digits with neon rim rings (optional).
- Demo - a minimal clock, included as a heavily-commented template to copy.
Which faces appear depends on what you enabled - Classic is always there; Neon and Demo are optional files. See Configuration to enable them or build your own.
The ring is a normal Home Assistant light (on/off, color, brightness, Rainbow / Pulse effects) and reacts to device state by priority:
alarm > assistant > volume > timer > HA state
| State | Ring |
|---|---|
| Assistant listening | cyan comet circling |
| Assistant thinking | fast purple spinner |
| Assistant speaking | flowing teal-green wave |
| Volume (knob turn) | green→red level bar for ~2 s |
| Timer running | red countdown ring (red from the start, shrinks; dim when paused) |
| Alarm | pulsing red |
| otherwise | whatever you set in Home Assistant |
When a reaction starts, the ring snapshots your HA color/brightness and restores it afterwards. Turn any reaction off in Settings → LED Ring.