Sessions Widget
JellyWatch provides an Android home screen widget that displays key server metrics at a glance.
Adding the Widget
- Long press on your home screen.
- Select Widgets.
- Find JellyWatch in the widget list.
- Drag it to your home screen.
Widget Information
The widget displays:
| Metric | Description |
|---|---|
| Active sessions | Number of currently playing streams |
| Total users | Number of user accounts |
| Devices | Connected device count |
| Libraries | Number of media libraries |
| Pending requests | Jellyseerr/Seerr pending request count |
Refreshing
- The widget updates automatically via a background worker (WorkManager).
- Tap the refresh button on the widget to force an immediate update.
- Tap anywhere else on the widget to open the JellyWatch app.
How It Works
- SessionsWidgetProvider handles widget lifecycle events (create, update, delete).
- SessionsWidgetWorker runs periodically in the background to:
- Fetch dashboard data from your active server
- Check premium feature access
- Update the widget UI with fresh data
Requirements
- At least one server must be configured and authenticated.
- Widget Access requires Premium.
The widget respects your active server selection — it always shows data from the currently selected server.
