New Content Notifications

New Content Monitoring

JellyWatch monitors your Jellyfin server for newly added media items and sends a local notification when new content is detected.

How It Works

1. NewContentNotificationManager runs a background polling coroutine.
2. On first activation, it silently fetches up to 100 recent items and stores their IDs as the baseline - no notification is sent on first run.
3. On each subsequent check, it fetches the latest 100 recent items and compares against the stored baseline.
4. If new item IDs are found, a notification is sent and the baseline is updated to the current set.
5. A 1-minute cooldown (NOTIFICATION_COOLDOWN_MS = 60000) prevents notification spam between consecutive checks.

Notification Content

The notification adapts based on how many new items were found:

• Single item - title is the item name; body describes the type (movie/episode/series).
• Multiple items - title shows the count (e.g. "3 new items"); body lists movies, episodes, and shows found.
• Image - the poster of the first new item is loaded and shown as a BigPicture notification. Falls back to a BigText list if the image cannot be loaded.
• Episode grouping - episodes are grouped by series name with season info (e.g. "Breaking Bad: 3 episodes (S4)").
• 100-item cap - if 100+ new items are detected, a + suffix is appended to indicate there may be more.

Supported Media Types

Notification Channel

New content notifications use the Android channel new_content_channel (New Content, IMPORTANCE_DEFAULT). It supports badge, vibration, and a custom notification sound.

Configuration

1. Make sure notifications are unlocked (Admin Features or the free trial) and the main Notifications switch is on, then enable New Content Notifications in Settings → Notifications → New Content Added.
2. Set the check interval - how often the app polls for new content:

Resetting the Baseline

The seen content IDs are stored in SharedPreferences under the key seen_content_ids. Calling clearSeenContent() on NewContentNotificationManager wipes the baseline. The next check will re-initialize silently without sending a notification.

New content notifications are available to admins and to non-admin users of the deprecated user interface. They need notifications to be unlocked with Admin Features (or the free trial). To watch new content, open it in JellyWatch Player.