2026-06-26, 01:24 AM
(This post was last modified: 2026-06-26, 02:14 PM by hfilippi. Edited 1 time in total.)
🍿jellyfin-whatsapp
![[Image: example.png?raw=true]](https://github.com/hfilippi/jellyfin-whatsapp/blob/main/img/example.png?raw=true)
A decoupled, lightweight notification engine built for Raspberry Pi to automatically aggregate newly added media from Jellyfin and send structured updates with official poster art to users via WhatsApp.
https://github.com/hfilippi/jellyfin-whatsapp
Would you like to automatically notify your friends and family whenever new content is added to your library?
This tool allows your Jellyfin users to receive updates about your latest additions via WhatsApp.
Surprise them with new releases, childhood movies you used to share, or those classics everyone wants to watch again. Everything is handled automatically, securely, and non-intrusively.
This is an open-source project under the MIT license, allowing anyone to improve it, contribute new features, or customize it to their needs.
Deploy in less than 5 minutes
![[Image: app_flow.png?raw=true]](https://github.com/hfilippi/jellyfin-whatsapp/blob/main/img/app_flow.png?raw=true)
🎯 Key Features
A decoupled, lightweight notification engine built for Raspberry Pi to automatically aggregate newly added media from Jellyfin and send structured updates with official poster art to users via WhatsApp.
https://github.com/hfilippi/jellyfin-whatsappWould you like to automatically notify your friends and family whenever new content is added to your library?
This tool allows your Jellyfin users to receive updates about your latest additions via WhatsApp.
Surprise them with new releases, childhood movies you used to share, or those classics everyone wants to watch again. Everything is handled automatically, securely, and non-intrusively.
This is an open-source project under the MIT license, allowing anyone to improve it, contribute new features, or customize it to their needs.
Deploy in less than 5 minutes- Docker Compose ready.
- Raspberry Pi compatible.
- Jellyfin webhook integration.
- WhatsApp notifications with posters and trailers.
- No database required.
🎯 Key Features
- Smart Message Aggregation: Instead of flooding users with single texts when a season of a TV show indexes, notifications are batched into a single unified broadcast based on a configurable interval window.
- Quiet Hours Shield: Automatically holds back notifications received during late-night hours. Pending media aggregates silently in memory and flushes immediately as a single summary once morning hours kick in.
- One-Click Unsubscribe Link: Every single notification message attaches a dynamically-built, native WhatsApp deep-link (
wa.me) passing a unique cancellation payload.
- Local-First Architecture: Eliminates complex database management. Subscriptions and runtime parameters are fully handled via lightweight, localized, system-synced JSON layers.
- Delivery Optimization & Smart Throttling: Multi-layered message pacing, batching, and rate-control mechanisms designed to improve notification delivery quality and reduce unnecessary message bursts across the Python and Node.js services.