Skip to content
AtsuraeDownload

Development sign-in

Only on a local server with DEV_AUTH. Enter any account name.

Tokens

Tokens are written {name}, {name:argument} or {name|modifier} in an element’s text, a progress value, or visibleWhen. See Text and tokens.

Examples below are for Monday 2 November 2026 at 14:05:09, English, 24-hour time.

Token Example Notes
{weekday} Monday
{weekdayShort} Mon
{day} 2
{dayPadded} 02
{month} 11 two digits
{monthName} November
{monthShort} Nov without a trailing period
{year} 2026
{date} 2026-11-02
{date:pattern} {date:EEE d MMM} → Mon 2 Nov any Unicode date pattern
Token 24-hour 12-hour Notes
{time} 14:05 2:05 PM adds seconds with the showSeconds option
{hour} 14 2
{minute} 05 05
{second} 09 09 updates every second
{ampm} (empty) PM

12-hour time applies when the widget has an option use24Hour set to "false". See Dates and times.

Numbers from 0 to 1, for progress values or with |percent.

Token Example
{day.progress} 0.5869
{week.progress} depends on the first day of the week in your region
{month.progress} 0.0529
{year.progress} 0.8372
Token Example Empty when
{battery} 82% no battery
{battery.level} 0.82 no battery
{batteryState} Charging / On Battery no battery
Token Example Notes
{cpu} 12% all cores; empty for the first few seconds
{cpu.level} 0.12
{memory} 8.1 GB memory used, as in Activity Monitor
{memory.level} 0.51 used ÷ installed
{memory.total} 16 GB installed memory

Refreshed every 5 seconds.

Token Example Empty when
{track} the song’s title nothing playing in Music or Spotify, or paused
{artist} the artist same
{lastTrack} the most recent song’s title, even while paused nothing has played, or Music or Spotify stopped or quit
{lastArtist} the most recent song’s artist same
Token Example Notes
{weather.temperature} 21° in your region’s unit
{weather.feelsLike} 20°
{weather.high} 24° today
{weather.low} 15° today
{weather.condition} Partly Cloudy
{weather.humidity} 62%
{weather.location} Cupertino the city

Empty until the weather loads, and when no location is available. See Weather.

Token Shows
{text} the value of the option with key text
{anyKey} the value of any option you declare, by its key
Token Shows
{script.name} the value your script’s update returned as name

Empty until the script first runs, and if it stops with an error. Requires a script in widget.json. See JavaScript.

Modifier Effect Example
upper uppercase `{weekday
lower lowercase `{monthName
percent 0–1 number as a whole percentage `{year.progress
round round a number to a whole number `{script.temp

Unknown tokens and modifiers produce a warning and an empty value (or the unchanged value, for modifiers).

The Library and Customize Widgets show example values when real ones are missing, so you can see your whole layout:

Token Preview value
{battery} / {battery.level} 82% / 0.82
{cpu} / {cpu.level} 12% / 0.12
{memory} / {memory.level} 8.1 GB / 0.5
{track} / {artist} / {lastTrack} / {lastArtist} Song Title / Artist
{weather.*} 21°, Partly Cloudy, 24°, 15°, 20°, 62%, Cupertino

The desktop never shows example values.