Skip to content
AtsuraeDownload

Development sign-in

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

Sharing in the community

The Atsurae community shares two kinds of things:

  • Widgets, on their own. Anyone can find them in Discover ▸ Widgets and add them with Get Widget.
  • Wallpapers: a video or picture background together with the widgets placed on it. People get the whole setup with Set as Wallpaper, then change it however they like.
  • Fix every error. Widgets with errors can’t be uploaded. Fix warnings too; they usually mean something is broken.
  • Pick a distinctive id. It can’t change later without breaking people’s placements. Something like yourname-world-clock avoids clashes.
  • Write a good name and summary. They’re the first thing people see.
  • Check licenses. Only include fonts and images you’re allowed to share, and include their license files.
  • Run through the test checklist.
  1. You need the full version of Atsurae to upload (anyone can browse and download, including during the trial).
  2. In your Library, right-click your widget’s card and choose Upload to Community…
  3. Check the title and add tags (comma-separated).
  4. Click Upload.

Atsurae then:

  • checks the widget again
  • draws its preview picture with the same renderer as the desktop, using example values for missing data
  • zips the package (up to 10 MB zipped)
  • uploads it and sends it for review

In Atsurae, every wallpaper in your Library has its own widget layout: switching wallpapers switches widgets. To share a wallpaper with the widgets you placed on it:

  1. Set the wallpaper, and arrange its widgets in Customize Widgets.
  2. In your Library, right-click the wallpaper and choose Upload to Community… The sheet shows what’s included, like Background + 3 widgets.
  3. Check the title and tags, and click Upload.

Atsurae compresses the video, copies every widget that’s turned on in that wallpaper’s layout (including built-in and community widgets) into one .atsuraewallpaper package with their positions, sizes, colors and options, and draws a preview with the widgets on it. Widgets with errors have to be fixed or turned off first. The package format is documented if you’re curious.

On the website you can upload a background on its own (on your account page); wallpapers with widgets are shared from the app.

When someone sets your wallpaper, Atsurae installs its widgets under From Wallpapers in their Library and uses your layout for that wallpaper. It’s theirs from then on: they can move, resize, recolor or turn off any widget, add others, and even edit the widgets’ files.

Every upload is checked by an Atsurae moderator before it appears in Discover. Until then it shows In Review in your Uploads tab.

  • Approved: it goes live in Discover, and your Uploads tab shows its download count.
  • Rejected: the card says Rejected, with the moderator’s reason. The files are removed. Fix what the note says and upload it again.

Moderators look at what your widget draws, its widget.json and its script, so keep your code readable. For wallpapers, they also see the background and every widget inside the package.

When someone clicks Get Widget, Atsurae downloads your package, checks it, puts it in their widgets folder under Community, and turns it on. It appears in their Library under From the Community, where they can place, resize and recolor it like any other widget.

Shared widgets run on other people’s Macs, so Atsurae keeps them contained:

  • Scripts run in a sandbox with no network, no files and no access to the Mac (see the sandbox).
  • Each script run is limited to 0.25 seconds; a widget that misbehaves is stopped, not the app.
  • Images and fonts load only from inside the package.
  • Widgets show on the desktop only, never on the lock screen.

People can report a widget from its page in Discover. Widgets with several reports are hidden until a moderator reviews them. A moderator can also hide or remove a widget that breaks the rules; you’ll see their reason on its card in Uploads.

Accounts that keep breaking the rules can be banned from sharing. A banned account can still use Atsurae and everything it downloaded, but can’t upload or report, and its uploads are hidden.

To publish a new version, upload it again. It’s reviewed like any upload and appears as a new listing; delete the old one in Uploads once the new one is live. Keep the same id, so people who reinstall keep their placement and settings.

Delete it in the Uploads tab. It disappears from Discover. People who already got it keep their copy.

The full rules are in the Community Guidelines. In short:

  • Make it your own work, or work you’re allowed to share.
  • No offensive, misleading or spammy widgets.
  • Don’t try to get around the sandbox or the time limit.
  • Keep names honest: describe what the widget shows.