Widget pack format

Create a local .awidget.json definition without executable scripts.

Version 0.xPublicLast updated 2026-07-14

Basic format

Widget packs are JSON data. Templates may reference supported tokens, but they do not execute Lua or arbitrary shell commands.

{
  "id": "custom.status",
  "name": "Custom status",
  "kind": "Text",
  "template": "CPU {cpu.total}%",
  "defaultWidth": 320,
  "defaultHeight": 160
}

Local storage

Imported packs are copied into the current user's local AIMEE Wallpaper data folder. Review a pack before importing it and keep a backup of packs you author.