Designing boards

Widget reference

All 26 widgets, what each is for, what it needs, and how it behaves when a feed is unavailable.

3 min readUniKiosk 0.0.1-rc2

Twenty-six widgets. Each sizes its content from its own box, so most of the craft is choosing the right one and giving it enough room.

Media

WidgetForNeeds
ImageOne picture, fitted or filledAn uploaded file
GalleryA folder on rotationAn uploaded folder or a synced network folder
VideoA clip, looped or onceH.264 MP4 recommended
PlaylistMixed media in orderItems, each with its own dwell
AudioBackground sound or a chimeAn audio file; off by default

Text

WidgetForNeeds
TextHeadline, body, priceTyping
TickerA crawling notice lineTyping, or a feed
AnnouncementA full-bleed interruptTyping
ShapeRules, blocks, dividersNothing

Not every board wants a ticker. A crawling line on a board that is otherwise still draws every eye in the room to the least important thing on it.

Time

WidgetForNeeds
ClockAnalogue or digitalNothing
World clocksSeveral cities in a stripTime zones
CountdownTime to a momentA target date and time
CalendarAn agenda or month viewAn ICS URL

The calendar widget renders several events, not just the next one — a day with four things on it should look like a day with four things on it.

Data

WidgetForNeeds
TableRows, aligned and paginatedCSV or JSON
ChartBar, line or donutFigures or a feed
GaugeOne number against a targetA figure or a feed
Live textA value pushed over the networkSomething on the LAN to push it
RSSHeadlinesA feed URL
WeatherConditions and forecastA place, and internet
Storage meterFree space and cache sizeNothing

Interaction and web

WidgetForNeeds
QR codeA link, menu or Wi-Fi handshakeA URL or payload
DirectoryNames, rooms and arrowsA list
ButtonsTouch targets that switch layoutsA touch screen
Search fieldKeyboard-driven lookupA data source
Web frameAny page, framedA URL, and internet
Custom HTMLYour own markupHTML and CSS

Behaviour when a feed fails

Every fetching widget holds its last good value rather than blanking. The full table is in how offline works.

Choosing between two that overlap

  • Table vs directory — table for figures and columns, directory for names and wayfinding arrows.
  • Gallery vs playlist — gallery for pictures on one interval, playlist for mixed media each with its own.
  • Web frame vs custom HTML — the frame when somebody else maintains the page, custom HTML when you do and want it to match the board.

Ready to try it?

One APK, no account, nothing to cancel.