Features
Aivi turns anything that can make an HTTP request into a Live Activity or a persistent widget on your Apple devices. Here is the full picture, with links to the details.
Live Activities everywhere
Section titled “Live Activities everywhere”- Lock screen and Dynamic Island. Glanceable, always-current updates on your iPhone.
- Apple Watch, iPad, CarPlay, and Mac. The same activity propagates across your Apple devices (macOS mirroring is not available in the EU).
- One call drives everything. A single request updates every surface and every subscriber at once. See the API reference.
Live Activity templates
Section titled “Live Activity templates”- Progress. Simple or segmented progress bars, with split or layered display, hatched tracks, and header/footer slots.
- Monitor. One or two columns of labeled, live, color-coded values, with a primary column for compact surfaces.
Widgets
Section titled “Widgets”- Persistent and always on screen. Widgets live on the Home Screen, the Lock Screen, StandBy, and the Apple Watch, and show the latest known state, with no ongoing activity required.
- Ten widget templates. Status, Progress, Gauge, Battery, Budget, Trend, Countdown, List, Prices, and Energy, each rendering at every size from small to extra large.
- Self-updating content. Countdowns, progress bars with an end date, and price timelines keep themselves current on-device between pushes.
- Honest staleness. Opt a widget into a freshness threshold and it shows “as of 14:32” instead of presenting old data as current.
- The Aivi Board. A configurable grid widget that shows several of your widgets together as tiles, in the style of Apple’s Batteries widget.
- Same API. One
PATCHupdates the widget on every device that displays it, and Home Assistant and Shortcuts examples get you started.
Customization
Section titled “Customization”These building blocks are shared by Live Activity and widget templates alike:
- Icons. Any SF Symbol, with monochrome, hierarchical, palette, or multicolor rendering and flat or gradient fills.
- Colors. A palette of named colors for values, text, and bars.
- Tap actions. Open an app or a webpage when the activity or widget is tapped.
- Live time formatters.
time_untilandtime_sincerender as on-device countdown and elapsed timers.
Behavior and efficiency
Section titled “Behavior and efficiency”- Battery-friendly. Activity pushes go out only when the content actually changes, and widget pushes only to devices that currently display the widget: no polling or background drain.
- Auto-updating timers. Countdown and elapsed timers tick on-device with no extra API calls, in activities and widgets alike.
- Configurable dismissal delay. Choose how long a finished activity lingers before it disappears, from immediate up to 4 hours (10 minutes by default), per activity.
- Activity priority. Set an activity’s prominence so the most important ones stay visible on crowded surfaces.
- Long-running activities. Opt an activity into running indefinitely; Aivi keeps it alive past the system’s multi-hour limit by refreshing it automatically.
Sharing
Section titled “Sharing”- Shared activities. Share one activity with up to five people. A single update reaches everyone’s devices, and subscribers pay nothing.
- Shared widgets. Widgets share the same way: send an invite link and up to five subscribers see every content update on their own Home and Lock Screens. Revoke a subscriber, or unsubscribe yourself, at any time.
In the app
Section titled “In the app”- Activity history. See the most recent state changes for an activity, handy for confirming an automation fired.
- Widget gallery. Create widgets from a template gallery with live previews, with placement help for getting them onto the Home Screen and the Lock Screen.
- In-app changelog. See what’s new, with a badge when there are unread entries.
- API token management. View, copy, and rotate your token from the Settings tab.
Home Assistant
Section titled “Home Assistant”- One-click blueprints. Import a ready-made blueprint with no HACS, custom components, or code.
- Guided setup. Map your sensors to fields and go.
- Per-template blueprints for Progress, Monitor, and timers on the activity side, plus one for each of the ten widget templates, with inputs for tap actions and icon customization.
- Widget blueprints. One
import per widget template keeps a widget in sync with your sensors; the
same
rest_commandpattern covers anything custom.
The API
Section titled “The API”- A tiny API. One
PATCHper activity or widget, with a token, plus an OpenAPI spec you can import into Postman or Insomnia. - Activity states.
ONGOINGandIDLEcontrol the full activity lifecycle. Widgets have no lifecycle: they are always on and simply show the latest content you sent.
Looking for inspiration? The use cases show these features in real scenarios, with full payloads.