Overview
JellyWatch delivers real-time local push notifications directly from the app using a background foreground service. No external backend or Firebase relay is involved for session events — the app polls your server every 5 seconds and triggers notifications on your device.
Enabling Notifications
- Go to Settings → Notifications.
- Toggle Enable notifications on.
- Grant the Android notification permission when prompted.
- The SessionMonitorService starts automatically and runs as a foreground service.
Note: Notifications are a Premium feature.
Notification Events (Admin Mode Only)
| Event | Default |
|---|---|
| Play Start | off |
| Play Stop | off |
| Pause | on |
| Resume | on |
| New Device | on |
| Server Down | off |
Notification Events (All Users)
| Event | Default |
|---|---|
| New Content | off |
| Jellyseerr Requests | on |
| Seerr Requests | on |
| App Promo (FCM) | on |
User Exclusion per Event
For session events (Play Start, Play Stop, Pause, Resume, New Device), you can exclude specific Jellyfin users from triggering notifications. Tap the Exclude Users button that appears under each enabled event toggle to select which users to ignore.
Notification Channels (Android 8+)
| Channel ID | Name | Importance | Used for |
|---|---|---|---|
session_monitor_channel | Session Monitor | Default (silent) | Persistent foreground service notification |
new_session_channel | New Sessions | High or Default | Play/Stop/Pause/Resume/Device events |
new_content_channel | New Content | Default | New media added to library |
jellyseerr_requests_channel | Jellyseerr Requests | Default | Jellyseerr requests |
seerr_requests_channel | Seerr Requests | Default | Seerr requests |
Customize each channel individually in Android Settings → Apps → JellyWatch → Notifications.
Notification Preferences
| Preference | Description |
|---|---|
| Group notifications | Bundle multiple session alerts into a single grouped notification |
| Popup (Heads-up) | Show notifications as heads-up banners; forces new_session_channel to IMPORTANCE_HIGH |
| Priority | Low, Normal, or High — controls NotificationCompat priority when popup mode is off |
Server Down Notifications
When Server Down is enabled, you can configure the check interval:
| Interval | Description |
|---|---|
| 2 minutes | Most responsive |
| 5 minutes | Default |
| 10 minutes | Battery-friendly |
