Skip to content
AtsuraeDownload

Development sign-in

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

FAQ

No. Most widgets are just JSON: a list of elements with tokens like {time}. JavaScript is optional, for values tokens don’t provide.

So anyone can make a widget with a text editor, without Xcode, compiling or learning a new language. JavaScript is the most widely known programming language, and it’s sandboxed, so shared widgets are safe.

Can a widget load data from the internet, like stock prices or my calendar?

Section titled “Can a widget load data from the internet, like stock prices or my calendar?”

Not yet. Scripts have no network access, which is what makes shared widgets safe to install. Atsurae provides weather itself. If there’s data you’d like, tell us.

No. Widgets redraw only when their content changes, which keeps them almost free to run. A clock with seconds updating once a second is as fast as it gets.

Can people click or interact with widgets?

Section titled “Can people click or interact with widgets?”

No. Widgets are click-through so they never get in the way of your desktop.

No; each text element is one line. Use one element per line.

Yes, put .ttf or .otf files in the package’s fonts/ folder. See Fonts.

Can a widget show different images depending on data?

Section titled “Can a widget show different images depending on data?”

Yes: one image element per picture, each with visibleWhen based on a script value. See Showing and hiding elements.

How do I show the time in another time zone?

Section titled “How do I show the time in another time zone?”

With a script and toLocaleTimeString({ timeZone }). See the World Clock.

{ "formatVersion": 2, "id": "hi", "name": "Hi", "elements": [{ "text": "Hi" }] }

Can I make a widget bigger than the screen, or put it off-screen?

Section titled “Can I make a widget bigger than the screen, or put it off-screen?”

Placements stay on screen; elements can extend beyond the edges, but they’ll be cut off.

In ~/Library/Application Support/Atsurae/Widgets. Widgets from the community are in its Community folder. Positions and settings are stored separately, by widget ID.

Not yet; each widget has one placement. To show two copies, duplicate it with a different id.

On the main display, on every Space.

No. The lock screen is drawn by macOS and shows its own clock. See Desktop only.

Barely. Three text widgets add about 5 MB of memory and no measurable CPU. See Performance and battery.

Why does a widget show “Song Title” in the Library but nothing on my desktop?

Section titled “Why does a widget show “Song Title” in the Library but nothing on my desktop?”

Previews fill in example values for missing data (nothing playing, no battery, no weather yet). The desktop shows only real values.

Location access is off and no city is set in Atsurae Settings ▸ Weather, or the weather hasn’t loaded yet. Customize Widgets shows the reason when a weather widget is selected.

Is it safe to install widgets from the community?

Section titled “Is it safe to install widgets from the community?”

Widget scripts can’t use the network, read files or access your Mac, and each run is limited to 0.25 seconds. See Safety.

Right-click its card in the Library and choose Move to Trash.

Do I need to buy Atsurae to share widgets?

Section titled “Do I need to buy Atsurae to share widgets?”

Uploading needs the full version. Browsing and downloading are free, including during the trial.

Not through Atsurae. Community widgets are free to download.

Usually within a day. Your upload shows In Review in the Uploads tab until a moderator approves it, or Rejected with their reason.

Report it from its page in Discover.