A feed you don't control emits codes — a WMO weather code, a device state, an alarm
level — and the label should read as words, not 61. valueMap, iconMap, and
colorMap say what each value looks like, declaratively:
Keys match the stringified value, so 0, "0", true, and "rain" all work
from the same map. true/false also match yes/no/on/off/1/0, and a
number matches whether it arrives as 61 or 61.00. Key lookup falls back to a
case-insensitive match.
"default" is the catch-all for any value with no entry.
No match and no "default" ⇒ the label degrades gracefully: the raw value for
valueMap, the control's own icon/tint for iconMap/colorMap. It never
blanks out.
A valueMap hit is the text as written — formatValue is not applied on top.
The maps apply to the synced value; before the first sync the static text
placeholder still shows.
The same three fields work on Background, where valueMap maps to an image URL.
Format Values
Value
Output
Example
"decimal"
"72" or "3.5"
Rounds to integer
"decimal:N"
"3.14"
Fixed N decimal places (e.g., "decimal:2")
"percent"
"80%"
Integer percentage
"time"
"3:45"
Minutes:seconds from total seconds
"duration"
"1h 23m"
Human-readable duration from seconds
"bytes"
"1.2 GB"
Auto-scaled byte units
"bps"
"54 Mbps"
Auto-scaled bits-per-second
"suffix:X"
"72°F"
Append custom suffix (e.g., "suffix:°F")
"relative"
"4 days ago", "in 2 hours"
A date shown as time-since / time-until — see Relative dates
"relative:day"
"Today", "Yesterday", "4 days ago"
Whole local calendar days
"date"
"Sep 26, 2026"
A date shown as the date itself (locale medium style); no date → placeholder
"date:time"
"Sep 26, 2026 at 2:03 PM"
The date and the time
"none"
(hidden)
No value display
Look formats
In the editor's Look card, Text offers four Format chips, declared in this doc's
lookFormats frontmatter: Plain (no formatValue), Number ("decimal"),
Last time ("relative:day") and Date ("date"). A chip only writes
formatValue; everything else stays as authored.
"Last time" is a Text format, not a separate control: the Add sheet offers one
Text choice, and showing a remembered time on a Text (Wire › a time value)
picks the Last time format for it, so the Look card shows that chip selected.
Relative dates
formatValue: "relative" and "relative:day" turn a label bound to a date into a
time-since readout that advances on its own — "Fern: last watered 4 days ago"
becomes "5 days ago" tomorrow with no server, poll or data event.
Accepted values: an ISO-8601 instant ("2026-09-22T08:15:00Z", fractional
seconds and offsets allowed — the {{now}} encoding), a date-only string
("2026-09-22", read as that day in the device's local calendar), or an epoch
number (seconds; milliseconds when larger than 10^11).
relative picks the largest sensible unit: "Now" (under a minute), "5 minutes
ago", "In 2 hours", "4 days ago".
relative:day counts whole local calendar days: "Today", "Yesterday",
"Tomorrow", "4 days ago", "In 2 days". Something done at 23:30 reads "Yesterday"
at 00:30, whatever the UTC date says.
No date yet (absent, null, empty, unparseable, or epoch 0) shows
placeholder — "Never" by default, localized. It is never blank, "0" or a
1970 date.
Before the first sync, a static text holding a date is formatted the same way.
Text is localized (e.g. German "Vor 4 Tagen", "Gestern").
The label refreshes itself once a minute with its own timer; nothing is written
back to the control's value. Widget slots bound to the same control show the
same text, refreshed whenever the widget reloads its timeline.
style: "terminal" (and, as a shortcut, mono/large-mono + scrollable) renders the
text as a real terminal instead of a plain mono label — purpose-built for piping a captured
shell/tmux pane to the phone:
ANSI styling — colour (16 / 256 / truecolor), bold, dim, italic, underline, and
reverse are parsed from the escape codes and rendered. Plain text (no escapes) renders
normally.
Pane-matched scaling — the font auto-scales so the source's column width exactly fills
the view, so box-drawing and ASCII line up like the real pane. If a server prepends a
CSI 8;rows;cols t size report, that column count is used; otherwise the widest line is.
Dark backdrop — drawn on its own dark background (independent of the app theme) so
ANSI colours have the contrast they were designed for.
Pinch to zoom — pinch to scale the text past the fitted size; double-tap snaps back
to fit. Content wider/taller than the view scrolls both ways.
Sizing — set controlHeight for the on-screen height; fontSize caps the fitted font
before zoom. Keeps the latest line in view and auto-scrolls on update.
Feed it like any synced label (a .string value); see the
tmux-bridge server for a complete example.
Behavior
When synced, the text field serves as a placeholder until the first sync value arrives
Text updates animate with a smooth numeric content transition
Labels have no action — they are display-only
valueMap/iconMap/colorMap translate the synced value on the way to the screen —
see Value maps