Troubleshooting#

The setup network appears only while the Deck shows the setup screen with a QR code. If the Deck shows your scenes instead, it is already set up. To set it up again on a new network, swipe down from the top edge and touch and hold Reconfigure Wi-Fi.

If the Deck shows nothing at all, check the power.

The password was probably wrong, or the network is out of range.

• If you were setting up the Deck from your phone, it goes back to its setup network on its own. Join it again from your phone and enter the password once more.
• If you changed Wi-Fi in the web interface, the Deck stays on its old network. Open the web interface at the old address and try again.

Your browser was talking to the Deck on the old network. Look at the Deck's screen: after it joins the new network it shows its new address and a QR code. Open that address.

If the change failed, the Deck stays on the old network, so a wrong password never leaves it unreachable.

Unplug the Deck, wait a few seconds and plug it back in. When the Deck can fix the problem itself, it says it is restarting and does it on its own.

Swipe down from the top edge to open the settings tray. It shows the address and a QR code you can scan. The Deck also shows its address for 10 seconds every time it starts.

• If night mode is on with Screen Auto-Off, the screen turns off after a period without touch. Touch the screen to wake it.
• Check that the USB-C cable is firmly plugged into the Deck and the power adapter.
• Look at the small LED next to the Deck's USB-C port. If it stays red, the cable or adapter does not supply enough power and the Deck does not start. Use a USB-C to USB-C cable and a stronger adapter; a USB-A to USB-C cable is a common cause.
• Try a different USB-C cable and power adapter.

A widget in the scene has not drawn its first picture yet. If this lasts, restart the Deck from the settings tray. If one scene always hangs, remove its widgets one by one in the web interface to find the cause.

Either the cell has no widget, or the widget there cannot run. Open the scene in the web interface and check the widget's settings.

Automatic cycling pauses in night mode, and while your finger is on the screen. Also check that Enable Screen Cycling is on in the Widget cycling menu on Display Widgets, and that more than one scene is switched on.

See the table of light signals.

Most widgets fetch their data from the internet. Check that the Deck is online, then check the widget's settings. A misspelled ticker symbol shows "Symbol … not found" in the Financial Ticker and "Not found" in the Financial Ticker List, and a misspelled city "Location not found". A widget keeps showing the last data it had when a refresh fails, so a gap is usually brief.

The token in the connected account cannot read your pool data. Create a new token with Read-only access in Braiins Pool, then edit the account and paste it. See Connected Accounts.

The Deck runs at most 56 widgets at a time, counting all scenes that are switched on. Switch off or delete a scene you no longer need.

Check that the address opens the image in a browser on the same network, and that the file is a PNG, JPEG or another supported format. Images other than JPEG must be smaller than about 4 megapixels, so a full-size PNG from a phone camera does not show: make it smaller or save it as JPEG. If it says "Set an image URL", the address is empty. See the Image widget.

The Deck shows Update Failed for 10 seconds: across the screen for a firmware update, or on the corner card for a widget or display software update. Then it goes back to normal on the software it had. It tries again at its next check, every two hours. You can also start the update by hand: in System Settings, open Upgrades and choose Check for a new version.

A software update is installing. Leave the Deck plugged in. When it finishes, the Deck restarts and shows Update Finished. If the power goes off while widgets or the display software are updating, the Deck starts on the previous version.