Skip to content
AtsuraeDownload

Development sign-in

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

The built-in widgets

Atsurae’s own widgets are plain widget.json files, in the same format you use. Copy one into your widgets folder, give it a new id and name, and change it however you like.

They’re format version 1 (text only), which still works unchanged.

The weekday in big, widely spaced capitals.

widget-day.json
{
"formatVersion": 1,
"id": "day",
"name": "Day",
"summary": "The day of the week, large and widely spaced.",
"elements": [
{ "text": "{weekday|upper}", "font": { "family": "Michroma", "size": 0.05 }, "tracking": 0.42 }
]
}
widget-date.json
{
"formatVersion": 1,
"id": "date",
"name": "Date",
"summary": "Day, month and year, like 26 DEC 2024.",
"elements": [
{ "text": "{day} {monthShort|upper} {year}", "font": { "family": "Michroma", "size": 0.016 }, "tracking": 0.14 }
]
}

Uses the special use24Hour and showSeconds options, which change what {time} shows. See Dates and times.

widget-time.json
{
"formatVersion": 1,
"id": "time",
"name": "Time",
"summary": "The current time, framed by dashes.",
"options": [
{ "key": "use24Hour", "label": "24-hour time", "kind": "toggle", "defaultValue": "true" },
{ "key": "showSeconds", "label": "Show seconds", "kind": "toggle", "defaultValue": "false" }
],
"elements": [
{ "text": "-{time}-", "font": { "family": "Michroma", "size": 0.016 }, "tracking": 0.14 }
]
}

Both lines use hideWhenEmpty, so the widget disappears when nothing is playing.

widget-now-playing.json
{
"formatVersion": 1,
"id": "now-playing",
"name": "Now Playing",
"summary": "The song playing in Music or Spotify. Hidden when nothing is playing, or optionally also when paused.",
"options": [
{ "key": "showWhenPaused", "label": "Keep showing when paused", "kind": "toggle", "defaultValue": "false" }
],
"elements": [
{ "text": "{track|upper}", "font": { "family": "Michroma", "size": 0.016 }, "tracking": 0.16, "hideWhenEmpty": true, "visibleWhen": "showWhenPaused=false" },
{ "text": "{artist|upper}", "font": { "family": "Michroma", "size": 0.011 }, "tracking": 0.2, "opacity": 0.75, "offset": [0, 0.026], "hideWhenEmpty": true, "visibleWhen": "showWhenPaused=false" },
{ "text": "{lastTrack|upper}", "font": { "family": "Michroma", "size": 0.016 }, "tracking": 0.16, "hideWhenEmpty": true, "visibleWhen": "showWhenPaused=true" },
{ "text": "{lastArtist|upper}", "font": { "family": "Michroma", "size": 0.011 }, "tracking": 0.2, "opacity": 0.75, "offset": [0, 0.026], "hideWhenEmpty": true, "visibleWhen": "showWhenPaused=true" }
]
}

A choice option with visibleWhen switches between two elements. The special value auto picks battery on laptops and CPU and memory on desktops.

widget-system.json
{
"formatVersion": 1,
"id": "system",
"name": "Battery & System",
"summary": "Battery level, or CPU and memory use.",
"options": [
{ "key": "systemMode", "label": "Show", "kind": "choice", "defaultValue": "auto",
"choices": ["auto", "battery", "system"], "choiceLabels": ["Automatic", "Battery", "CPU & Memory"] }
],
"elements": [
{ "text": "BATTERY {battery}", "font": { "family": "Michroma", "size": 0.014 }, "tracking": 0.16, "visibleWhen": "systemMode=battery" },
{ "text": "CPU {cpu} · MEM {memory}", "font": { "family": "Michroma", "size": 0.014 }, "tracking": 0.16, "visibleWhen": "systemMode=system" }
]
}

The text option’s value is shown with the {text} token.

widget-custom-text.json
{
"formatVersion": 1,
"id": "custom-text",
"name": "Custom Text",
"summary": "A line of your own: a name, a quote, a reminder.",
"options": [
{ "key": "text", "label": "Text", "kind": "text", "defaultValue": "Stay curious" }
],
"elements": [
{ "text": "{text|upper}", "font": { "family": "Michroma", "size": 0.022 }, "tracking": 0.3 }
]
}