Format versions
Every widget declares the format it’s written in with formatVersion. Atsurae reads every format up to the newest it knows, and refuses newer ones with a message asking to update Atsurae.
Old formats keep working: a format 1 widget is a valid format 2 widget.
Format 2
Section titled “Format 2”The current format.
- Element types:
typecan beimage,shapeorprogress, alongside text (the default).- Images:
src,size,tint,cornerRadius - Shapes:
shape,size,fill,stroke,strokeWidth,cornerRadius - Progress:
style,value,size,lineWidth,track
- Images:
- Packages:
.atsuraewidgetfolders withwidget.json, a script,images/andfonts/. - Scripts:
scriptwithfileandupdateEvery;{script.*}tokens. - Tokens:
lastTrack,lastArtist,battery.level,cpu.level,memory.level,memory.total,day.progress,week.progress,month.progress,year.progress, andweather.*. - Modifiers:
percentandround, alongsideupperandlower. visibleWhenalso accepts a token ("{track}").- Colors accept
#RRGGBBAA. - Fields:
author,version,$schema. textis optional for non-text elements, andfontis optional for text (system font, size 0.02).
Format 1
Section titled “Format 1”The first format, used by the built-in widgets.
- Text elements with tokens,
font(family,weight,size),tracking,color,opacity,shadow,offset,alignment,visibleWhen(option=value) andhideWhenEmpty. - Options:
toggle,textandchoice. - Tokens: dates and times,
date:pattern,battery,batteryState,cpu,memory,track,artist,text; modifiersupperandlower.
