Using the Deck
Most of what you do on the Deck itself takes one gesture. Below are the gestures, the settings tray, and what the light strip and the screens are telling you.
Gestures
While your finger is on the screen, the Deck stops moving between scenes on its own. It carries on when you let go.
The Settings Tray
Swipe down from the top edge of the screen to open the settings tray. It slides over whatever scene is showing and closes on its own after 15 seconds without a touch.
From the tray you can:
- Change brightness and volume. Tap the minus and plus buttons. The change applies at once and stays after the tray closes.
- Turn night mode on or off. The button shows whether night mode is on and, when a schedule is set, until what time ("Until 07:00"). See Night mode.
- See the Deck's address. The tray shows the IP address, the hostname and a QR code that opens the web interface on your phone.
- Check the connection. The tray shows the Wi-Fi network the Deck is on and its signal strength.
- Restart the Deck. Touch and hold the restart button for 5 seconds, until the shrinking circle reaches the button. Let go early to cancel.
- Move the Deck to another Wi-Fi network. Touch and hold Reconfigure Wi-Fi for 5 seconds. The Deck starts its setup network again, and you finish the change from your phone as in the Quick Start. While the Deck is still connected, it is simpler to change the network in the web interface; see Wi-Fi Network.
Restart and Wi-Fi changes need the hold so that a stray tap can never trigger them. While you hold, the tray says "Keep holding, or release to cancel". During a software update the tray refuses to restart and says why.
Do not restart the Deck while a software update is installing. The tray blocks it, but the Reboot button in the web interface and the reset button do not.
The Light Strip
The Deck has a strip of 10 colored LEDs. It tells you what the Deck is doing without you having to look at the screen.
To turn the light strip off, open System Settings in the web interface, then the Sound & Light tab. You can set it separately for the day and for night mode.
The Reset Button
A press between 2 and 5 seconds does nothing. A factory reset keeps the installed software version. If the Deck no longer starts properly, hold the button while you plug it in to restore the original software.
Screens the Deck Shows on Its Own
Some screens take over the display for a moment:
- After it starts, the Deck shows its address and a QR code for 10 seconds, then your scenes. Tap the screen to close it sooner.
- During setup, it shows the setup network and a QR code. This screen stays until setup is done.
- During a software update, a progress bar covers the screen. You cannot use the Deck until the update finishes. Smaller updates show only a small card in the corner, and the widgets keep running.
- After a firmware update, the Deck says Update Finished for 5 seconds. After a widget or display software update, the corner card shows the result for 10 seconds. A failed firmware update shows Update Failed across the screen for 10 seconds. A failed widget or display software update shows Update Failed on the corner card for 10 seconds, and your scenes keep running.
- When an alarm rings, the alarm covers everything until you stop or snooze it.
- While a scene loads, the Deck shows its logo with the text "Loading sceneā¦" until the widgets draw their first picture.
Under the hood
The display runs a Wayland compositor. Each widget is a separate program, almost always WebAssembly, and the compositor arranges them into scenes, forwards touch events to the widget under your finger, and runs the scene transitions. Touch is single-finger for scene navigation; the touchscreen hardware is multi-touch.
The LED strip uses 10 APA102 addressable LEDs at 120 frames per second. Effects follow a fixed priority: device start, alarm, Wi-Fi state, software update, Wi-Fi scan, scene preview, then widget effects. Short flashes play over the current effect and then give it back.
Widgets can drive the strip too, through the SDK. A widget's effect shows only while its scene is on screen, unless the widget marks it as ambient; system signals always take priority. See For Developers.