Scenes and Widgets
The Deck shows one scene at a time, and you decide which widgets each scene holds. You build scenes in the web interface, the settings pages the Deck serves to your browser.
Scenes in One Minute
There are two kinds of scene:
- A fullscreen scene holds one widget at Full size. Use it for widgets with a lot to show, such as the full weather forecast or the ISS globe.
- A combined scene holds several widgets on a grid of 4 by 2 cells. A Small widget takes 1 cell, a Medium one 2 cells side by side, a Large one a block of 4. A combined scene can hold up to 8 Small widgets, 2 Large ones, or any mix that fits.

Each widget keeps its own settings. You can have two clocks in different time zones, or the same price chart in two scenes over different periods.
Open Display Widgets
- Open the web interface. Its address is in the settings tray: swipe down from the top of the Deck's screen.
- In the menu, choose Display Widgets. It is also the page the web interface opens on.
You see your scenes in the order the Deck shows them. Each row has a switch to turn the scene on or off, a duration field in seconds, and buttons to edit, clone or delete it.
Add a Fullscreen Scene
- Choose Add New, then Full Screen.
- Pick a widget. Widgets are grouped by category, such as Clock, Weather, Finance and Space. Tap a category to narrow the list.
- Fill in the widget's settings. The Deck shows the widget as you type, so you see the result before you finish.
- Choose Done. To drop the new scene instead, close the dialog.
The picker lists only widgets that come in Full size. The Widget Catalog describes each widget and its settings.
Build a Combined Scene
- Choose Add New, then Combined Scene. The new scene is empty, and the Deck shows its empty grid.
- Pick a free cell. The Add New Widget picker opens and lists only widgets that fit there.
- Pick a widget. It goes into the cell at the smallest size that fits.
- In Configure Widget, choose its size (Small, Medium or Large) and fill in its settings, then choose Done.
- Repeat for the other cells. When the scene is complete, choose Done to go back to your scenes.
A combined scene saves every change at once; there is nothing to confirm at the end. Each cell offers Edit Widget, Move Widget and Remove Widget. Removing a widget leaves the rest of the scene as it is. Cells without a widget stay dark. Delete Scene removes the whole scene.
Edit, Clone and Reorder
- Edit a scene to change its widgets' settings. Changes show on the Deck as you make them, and the light strip glows white while you edit. Closing a widget's settings without Done puts that widget back as it was.
- Clone a scene to start a new one from a copy.
- Drag scenes into a new order. Swipes and automatic cycling follow this order.
- Switch a scene off to keep it saved while the Deck skips it.
- Delete a scene you no longer need.
Your scenes survive restarts and updates.
Screen Cycling
The Deck moves to the next scene on its own every 30 seconds. To change this, open the Widget cycling menu at the top of Display Widgets:
To give one scene more or less time, type a number of seconds into its duration field. Clear the field to use the default again. The field is locked while cycling or the scene is off.
Cycling pauses while your finger is on the screen. In night mode it stops, and the Deck goes back to the first scene that is switched on; you can still swipe. A swipe always slides, whatever transition you choose.
Limits
The Deck runs up to 56 widgets at a time, counting all scenes that are switched on, plus a switched-off scene while you edit it. Display Widgets shows the count as Running widgets. At the limit, Add New is disabled; switch off or delete a scene to make room.
Install a Widget From a File
Besides the widgets that come with the Deck, you can install a widget someone else has written. It comes as a .nar file.
- On Display Widgets, choose Install Widget.
- Read the notice.
- Drop the file on the dialog, or choose it.
- Choose Accept the Risk and Install.
The Deck checks the file and tells you whether the widget was installed. It then appears in the widget picker. The Deck refuses uploads while a software update is installing.
Braiins Forge, the maker of the Deck, does not review widgets installed from a file. A harmful widget could take over the Deck and reach other devices on your network. Install only widgets from people you trust.
Writing your own widget is covered in For Developers.
Under the hood
The widget picker and every settings form are built from each widget's manifest.json, so any installed widget, including one you upload, is configurable without a web interface update. Changing a setting reconfigures the running widget in place; changing its size restarts it.
While no widget in a scene has drawn yet, the Deck shows its logo with "Loading sceneā¦". An empty combined scene shows its grid instead, because there is nothing to load.