🔔 NotifySync

The modern notification center Jellyfin has been waiting for.
Le centre de notifications moderne que Jellyfin attendait.

---

🌐 Language / Langue
English | Français

---

English

NotifySync transforms the Jellyfin interface by adding a native notification bell, inspired by major streaming platforms. Your users see the latest additions — Movies, Series, Music — without ever leaving their current page, through a sleek glass-morphism dropdown that feels like it was always part of Jellyfin.

📖 Changelog & version history: see GitHub Releases for what's new in each version.

📑 Table of Contents

• 🚀 Quick Start
• ✨ Key Features
• 📦 Installation
• ⚙️ Configuration
• ❓ Troubleshooting
• 🎨 Recommended Theme
• 👥 Authors & Credits

🚀 Quick Start

1. Add the repository for your Jellyfin version, 10.11.x or 12.x — see Installation.
2. Install NotifySync from the Catalog → restart Jellyfin.
3. Install the File Transformation plugin to inject the bell automatically (see Enable the Bell).
4. In Dashboard → Plugins → NotifySync, check the libraries to monitor, Save, then click Regenerate history — nothing is announced until at least one library is checked.

That's it. The bell appears in the top-right header with your latest additions, and keeps up as new content arrives.

✨ Key Features

• Streaming-style bell — A sleek glass dropdown with the latest addition as a large hero spotlight. The red counter clears when you open the bell; each item keeps a NEW / UPD badge until you dismiss it or it's played.
• Real-time — Notifications arrive on their own, about half a minute after Jellyfin registers the content. No page refresh, ever.
• Organized by recency — The list is split into Today, This week, and Earlier sections, newest first.
• Smart grouping — Episodes grouped by series and labeled with the exact range that landed (Season 4 • Ep. 1-12, or Ep. 1, 8 for a partial batch); tracks grouped by album.
• Upgrade detection — Replace a media file and the notification comes back with a blue UPD badge telling you what changed: Quality, Codec, Audio, or a combination. Subtitle additions and metadata refreshes stay silent.
• Moves are not news — Reorganising your libraries stays out of the bell. Jellyfin sees a move as a deletion followed by an unrelated add, which used to announce every relocated title as brand new; NotifySync recognises it and stays quiet.
• Nothing half-drawn — A title only appears once Jellyfin has identified it. No cards named after their folder, no missing artwork, no episodes waiting to be grouped.
• Favorites filter — Favorite a series in Jellyfin and filter the bell down to just the content you care about.
• Filters & dismiss — Quick category pills, dismiss per item or per group, swipe-left on mobile. Clearing the list never marks anything as "Played".
• Collections — Monitored Jellyfin collections (BoxSets) notify you on new additions.
• Deletion history — Admins get a log of recently deleted media, with configurable retention.
• Synced across devices — Read and cleared states live on the server: phone and desktop always agree.
• Respects permissions — Every user only ever sees content from libraries they can access, with strict per-user isolation.
• Bilingual & responsive — French / English following your Jellyfin language, on desktop, tablet, and mobile.

📦 Installation

[!IMPORTANT] Prerequisites:

• Jellyfin 10.11.x or 12.x
• A web client — browser on desktop, tablet or phone, or the mobile app. TV apps render natively and cannot display the bell.

Steps

1. Open your Jellyfin dashboard > Plugins > Repositories.
2. Add the repository for your Jellyfin version — one build cannot target both:
   • Jellyfin 10.11.x

     https://raw.githubusercontent.com/peterdu1109/NotifySync/refs/heads/main/repository.json
     

   • Jellyfin 12.x

     https://raw.githubusercontent.com/peterdu1109/NotifySync/refs/heads/jellyfin-12/repository-12.json
     

3. Go to the Catalog and install NotifySync — the Jellyfin 12 channel lists it as NotifySync (Jellyfin 12).
4. Restart your Jellyfin server.

🔔 Enable the Bell

Method 1: File Transformation — recommended ✅

Automatic injection, no file to edit, and it survives Jellyfin updates.

1. In Dashboard → Plugins → Repositories, add:

   https://www.iamparadox.dev/jellyfin/plugins/manifest.json
   

2. Install File Transformation from the catalog.
3. Restart Jellyfin, then Ctrl+F5 in your browser.

Method 2: Manual Injection

[!WARNING] This method requires re-applying the patch after every Jellyfin update, because Jellyfin overwrites index.html. Method 1 is strongly preferred.

If you prefer not to install another plugin, manually add the script tag to your index.html:

Linux

sudo sed -i 's|</body>|    <script src="/NotifySync/client.js"></script>\n</body>|' /usr/share/jellyfin/web/index.html

Docker

docker exec jellyfin sed -i 's|</body>|    <script src="/NotifySync/client.js"></script>\n</body>|' /jellyfin/jellyfin-web/index.html

Windows — open the web client's index.html in a text editor started as administrator:

C:\Program Files\Jellyfin\Server\jellyfin-web\index.html

and paste this line just before the closing </body>:

<script src="/NotifySync/client.js"></script>

⚙️ Configuration

Go to Dashboard > Plugins > NotifySync.

❓ Troubleshooting

🎨 Recommended Theme

NotifySync integrates beautifully with the ElegantFin Cinema Edition theme — a streaming-inspired CSS theme for Jellyfin with a full suite of cinematic modules.

Both projects work flawlessly together on PC (browser) and mobile (Jellyfin app + browser).

⭐ Install once, get a complete cinematic Jellyfin experience with real-time notifications.

⚠️ TV note: NotifySync currently doesn't render on TV apps (Samsung Tizen, Android TV, LG webOS). The notification bell is a web client feature and TV apps use native rendering.

👥 Authors & Credits

NotifySync is maintained by:

• ElieMFR — Original author & project lead
• Peterdu1109 — Co-maintainer

Thanks to @muisje and @Wernouxe for their feature requests and bug reports that shaped this plugin.

Contributions, bug reports, and feature requests are welcome on GitHub.

Released under the MIT License.

---

Français

NotifySync transforme l'interface Jellyfin en y ajoutant une cloche de notifications native, inspirée des grandes plateformes de streaming. Vos utilisateurs voient les derniers ajouts — Films, Séries, Musique — sans jamais quitter leur page, via un menu déroulant en verre dépoli qui s'intègre naturellement dans Jellyfin.

📖 Changelog & historique des versions : voir les Releases GitHub pour les nouveautés de chaque version.

📑 Sommaire

• 🚀 Démarrage Rapide
• ✨ Fonctionnalités
• 📦 Installation
• ⚙️ Configuration
• ❓ Dépannage
• 🎨 Thème recommandé
• 👥 Auteurs & Crédits

🚀 Démarrage Rapide

1. Ajoutez le dépôt correspondant à votre version de Jellyfin, 10.11.x ou 12.x — voir Installation.
2. Installez NotifySync depuis le Catalogue → redémarrez Jellyfin.
3. Installez le plugin File Transformation pour injecter la cloche automatiquement (voir Activer la Cloche).
4. Dans Tableau de bord → Extensions → NotifySync, cochez les bibliothèques à surveiller, Sauvegardez, puis cliquez sur Régénérer l'historique — rien n'est annoncé tant qu'aucune bibliothèque n'est cochée.

C'est tout. La cloche apparaît en haut à droite de l'interface avec vos derniers ajouts, et suit les nouveautés au fil de l'eau.

✨ Fonctionnalités

• Cloche style streaming — Un menu déroulant élégant en verre dépoli, avec le dernier ajout en grand en vedette. Le compteur rouge disparaît à l'ouverture ; chaque élément garde un badge NOUVEAU / MAJ jusqu'à ce que vous le retiriez ou qu'il soit marqué vu.
• Temps réel — Les notifications arrivent seules, une trentaine de secondes après que Jellyfin a enregistré le contenu. Aucun rafraîchissement, jamais.
• Organisé par fraîcheur — La liste est découpée en sections Aujourd'hui, Cette semaine et Plus ancien, du plus récent au plus ancien.
• Regroupement intelligent — Épisodes groupés par série avec la plage exacte qui est arrivée (Saison 4 • Ép. 1-12, ou Ép. 1, 8 pour un lot partiel) ; pistes groupées par album.
• Détection des mises à jour — Remplacez un fichier média et la notification revient avec un badge bleu MAJ qui indique ce qui a changé : Qualité, Codec, Audio, ou une combinaison. Les ajouts de sous-titres et rafraîchissements de métadonnées restent silencieux.
• Un déplacement n'est pas une nouveauté — Réorganiser vos bibliothèques ne remplit plus la cloche. Jellyfin voit un déplacement comme une suppression suivie d'un ajout sans rapport, ce qui annonçait chaque titre déplacé comme neuf ; NotifySync le reconnaît et se tait.
• Rien d'à moitié affiché — Un titre n'apparaît qu'une fois identifié par Jellyfin. Plus de carte portant le nom de son dossier, plus d'affiche manquante, plus d'épisodes en attente de regroupement.
• Filtre Favoris — Mettez une série en favori dans Jellyfin et filtrez la cloche sur les seuls contenus qui vous intéressent.
• Filtres & suppression — Pills de catégories, suppression à l'unité ou par groupe, swipe gauche sur mobile. Vider la liste ne marque jamais rien comme « Vu ».
• Collections — Les collections Jellyfin surveillées (BoxSets) vous notifient des nouveaux ajouts.
• Historique des suppressions — Les admins disposent d'un journal des médias récemment supprimés, avec rétention paramétrable.
• Synchronisé entre appareils — États lu / vidé stockés côté serveur : téléphone et bureau toujours d'accord.
• Respecte les permissions — Chaque utilisateur ne voit que le contenu des bibliothèques auxquelles il a accès, avec une isolation stricte par utilisateur.
• Bilingue & responsive — Français / Anglais selon la langue de votre Jellyfin, sur bureau, tablette et mobile.

📦 Installation

[!IMPORTANT] Pré-requis :

• Jellyfin 10.11.x ou 12.x
• Un client web — navigateur sur ordinateur, tablette ou téléphone, ou l'application mobile. Les applications TV ont un rendu natif et ne peuvent pas afficher la cloche.

Étapes

1. Tableau de bord Jellyfin > Extensions > Dépôts.
2. Ajoutez le dépôt correspondant à votre version de Jellyfin — un même binaire ne peut pas viser les deux :
   • Jellyfin 10.11.x

     https://raw.githubusercontent.com/peterdu1109/NotifySync/refs/heads/main/repository.json
     

   • Jellyfin 12.x

     https://raw.githubusercontent.com/peterdu1109/NotifySync/refs/heads/jellyfin-12/repository-12.json
     

3. Allez dans le Catalogue et installez NotifySync — sur le canal Jellyfin 12 il s'appelle NotifySync (Jellyfin 12).
4. Redémarrez votre serveur Jellyfin.

🔔 Activer la Cloche

Méthode 1 : File Transformation — recommandée ✅

Injection automatique, aucun fichier à modifier, et ça survit aux mises à jour de Jellyfin.

1. Dans Tableau de bord → Extensions → Dépôts, ajoutez :

   https://www.iamparadox.dev/jellyfin/plugins/manifest.json
   

2. Installez File Transformation depuis le catalogue.
3. Redémarrez Jellyfin, puis Ctrl+F5 dans votre navigateur.

Méthode 2 : Injection Manuelle

[!WARNING] Cette méthode nécessite de ré-appliquer le patch après chaque mise à jour Jellyfin, car Jellyfin écrase index.html. La Méthode 1 est fortement recommandée.

Si vous préférez ne pas installer d'extension tierce :

Linux

sudo sed -i 's|</body>|    <script src="/NotifySync/client.js"></script>\n</body>|' /usr/share/jellyfin/web/index.html

Docker

docker exec jellyfin sed -i 's|</body>|    <script src="/NotifySync/client.js"></script>\n</body>|' /jellyfin/jellyfin-web/index.html

Windows — ouvrez le index.html du client web dans un éditeur lancé en administrateur :

C:\Program Files\Jellyfin\Server\jellyfin-web\index.html

et collez cette ligne juste avant la balise </body> :

<script src="/NotifySync/client.js"></script>

⚙️ Configuration

Allez dans Tableau de bord > Extensions > NotifySync.

❓ Dépannage

🎨 Thème recommandé

NotifySync s'intègre parfaitement avec le thème ElegantFin Cinema Edition — un thème CSS inspiré des plateformes de streaming pour Jellyfin avec une suite complète de modules cinématographiques.

Les deux projets fonctionnent ensemble sur PC (navigateur) et mobile (app Jellyfin + navigateur).

⭐ Installation unique, expérience Jellyfin cinéma complète avec notifications temps réel.

⚠️ Note TV : NotifySync ne s'affiche actuellement pas sur les apps TV (Samsung Tizen, Android TV, LG webOS). La cloche est une fonctionnalité du client web et les apps TV utilisent un rendu natif.

👥 Auteurs & Crédits

NotifySync est maintenu par :

• ElieMFR — Auteur original & lead du projet
• Peterdu1109 — Co-mainteneur

Merci à @muisje et @Wernouxe pour leurs demandes de fonctionnalités et rapports de bugs qui ont façonné ce plugin.

Contributions, rapports de bugs et demandes de fonctionnalités sont les bienvenus sur GitHub.

Distribué sous Licence MIT.