Skip to content

About

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

Topics

Resources

Stars

27 stars

Watchers

0 watching

Forks

Latest commit

 

History

474 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🔔 NotifySync

Version .NET Framework Jellyfin License GitHub stars Downloads Last release

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


🌐 Language / Langue
English | Français


English

NotifySync adds a notification bell to Jellyfin, like on streaming platforms. Your users see the latest movies, series and music added without leaving their page.

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

📑 Table of Contents

✨ Key Features

  • Streaming-style bell: the latest addition is shown large, the others in a list.
  • Badges and counter: the red counter clears when you open the bell. Each item keeps its NEW / UPD badge until you dismiss it or watch it.
  • Real-time: additions show up as soon as Jellyfin announces them, without reloading the page.
  • Sorted by date: Today, This week, Earlier.
  • Grouping: episodes that arrived together share one card (Season 4 • Ep. 1-12). Tracks are grouped by album.
  • Upgrades detected: a replaced file comes back with a blue UPD badge that says what changed (Quality, Codec or Audio). Subtitles and metadata trigger nothing.
  • Moves ignored: reorganising your libraries announces nothing new.
  • Nothing incomplete: a title waits, up to 5 minutes, until Jellyfin has identified it, with its artwork.
  • Filters: by category or by favorites.
  • Dismiss: an item or a group, or swipe left on mobile. Dismissing does not mark it as played.
  • Collections: monitored collections announce their new additions.
  • Deletion history: a log for admins.
  • Synced: what you read or dismiss on one device is read or dismissed on all of them.
  • Permissions respected: everyone only sees the libraries they can access.
  • Three languages: French, English or Brazilian Portuguese, following your Jellyfin language.
  • On every screen: desktop, tablet and mobile. On TV, when the app loads NotifySync's script (Samsung TVs installed with Apps2Samsung do), the remote drives it: arrows to browse, OK to open or dismiss, Back to close.

📦 Installation

Important

Requirements:

  • Jellyfin 12.x
  • Jellyfin 10.11.x (with NotifySync 5.8.4.0)
  • The File Transformation plugin, or a manual edit (see Without File Transformation)

Steps

  1. Open Dashboard → Plugins → Manage Repositories and add these two repositories:

    NotifySync (the same for 12.x and 10.11.x):

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

    File Transformation (adds the bell to Jellyfin and survives its updates):

    https://www.iamparadox.dev/jellyfin/plugins/manifest.json
    
  2. In Plugins, filter Available, install NotifySync and File Transformation.

  3. Restart Jellyfin, then Ctrl+F5 in your browser.

  4. In Dashboard → Plugins → NotifySync, check the libraries to monitor, click Save, then Regenerate history. The bell stays empty until a library is checked.

Without File Transformation

Skip File Transformation in steps 1 and 2: add and install NotifySync only. Before step 3, add the bell to Jellyfin's page yourself with the command for your system:

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 this file in a text editor started as administrator:

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

and paste this line just before </body>:

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

Warning

To redo after every Jellyfin update, which overwrites index.html.

⚙️ Configuration

Go to Dashboard → Plugins → NotifySync.

Setting Default Description
Quota per Category 10 Maximum number of cards shown per category (1 to 50).
Monitored Libraries (none) Check the libraries you want to appear in the bell.
Monitored Collections (none) Collections (BoxSets) to watch for new additions. Scanned every 15 minutes.
Category Mapping (empty) Rename or group your libraries in the bell (e.g. "My Movies" → "Movies"). The arrows set the order of the filters.
Manual Selection (IDs or Names) (empty) Library IDs or names for advanced setups (Channels, XFusion).
Enable deletion tracking enabled Keeps the deletion log. Needed to detect Sonarr/Radarr replacements (deleted, then re-imported within 7 days).
Retention (days) 30 How many days the deletion log is kept (7 to 365).
Regenerate history Full rescan, after changing libraries or categories.
Scan collections now Scans the monitored collections right away.

❓ Troubleshooting

Issue Solution
Bell doesn't appear Check that File Transformation is installed. Restart Jellyfin, then Ctrl+F5.
No bell and 401 Unauthorized errors in the browser console Your server runs Jellyfin 12 with the old 5.x version. Update NotifySync to 6.x from Plugins, restart Jellyfin, then Ctrl+F5.
Bell gone after a Jellyfin update Without File Transformation, each update overwrites the edit. Redo it, or install File Transformation.
Content or music missing, wrong counter Check the library in Monitored Libraries, then click Regenerate history.
Replaced file shows NEW instead of UPD Turn on Enable deletion tracking. It is needed when a file is deleted, then re-imported.
A renamed file shows a false UPD badge A plain rename triggers nothing. If a badge shows up anyway, dismiss it: it won't come back.
A moved series still shows as NEW Turn on Enable deletion tracking. Detection only works if the folder keeps its name.
Unauthorized content visible The plugin follows Jellyfin permissions. Check the user's restrictions.
No bell on the admin pages Normal: the bell only shows on the user pages.
"Please wait 30 seconds" Regenerate history and Scan collections now each run once every 30 seconds at most. Wait, then click again.
Incompatible Use the repository from Installation. Jellyfin 12.x needs NotifySync 6.x.

🎨 Recommended Theme

NotifySync goes well with ElegantFin Cinema Edition, a streaming-inspired Jellyfin theme. Both work together on PC, mobile and TV.

💬 Support

Open an issue on GitHub with your Jellyfin version, your NotifySync version, the app or browser you use, and the server log if you can. Contributions and feature ideas are welcome there too.

👥 Authors & Credits

NotifySync is maintained by:

🙏 Contributors

@muisje @Wernouxe @hstark16 @Shillooh

Released under the MIT License.


Français

NotifySync ajoute à Jellyfin une cloche de notifications, comme sur les plateformes de streaming. Vos utilisateurs voient les derniers films, séries et musiques ajoutés sans quitter leur page.

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

📑 Sommaire

✨ Fonctionnalités

  • Cloche style streaming : le dernier ajout est affiché en grand, les autres en liste.
  • Badges et compteur : le compteur rouge s'efface à l'ouverture de la cloche. Chaque élément garde son badge NOUVEAU / MAJ jusqu'à ce que vous le retiriez ou le regardiez.
  • Temps réel : les ajouts apparaissent dès que Jellyfin les annonce, sans recharger la page.
  • Classé par date : Aujourd'hui, Cette semaine, Plus ancien.
  • Regroupement : les épisodes arrivés ensemble forment une seule carte (Saison 4 • Ép. 1-12). Les pistes sont groupées par album.
  • Mises à jour détectées : un fichier remplacé revient avec un badge bleu MAJ qui précise ce qui a changé (Qualité, Codec ou Audio). Les sous-titres et les métadonnées ne déclenchent rien.
  • Déplacements ignorés : réorganiser vos bibliothèques n'annonce rien de nouveau.
  • Rien d'incomplet : un titre attend, jusqu'à 5 minutes, que Jellyfin l'ait identifié, avec son affiche.
  • Filtres : par catégorie ou par favoris.
  • Retrait : un élément ou un groupe, ou en glissant vers la gauche sur mobile. Retirer ne marque pas comme vu.
  • Collections : les collections surveillées signalent leurs nouveaux ajouts.
  • Historique des suppressions : un journal réservé aux admins.
  • Synchronisé : ce que vous lisez ou retirez sur un appareil l'est sur tous les autres.
  • Permissions respectées : chacun ne voit que les bibliothèques auxquelles il a accès.
  • Trois langues : français, anglais ou portugais du Brésil, selon la langue de Jellyfin.
  • Sur tous les écrans : ordinateur, tablette et mobile. Sur TV, si l'appli charge le script de NotifySync (c'est le cas des TV Samsung installées avec Apps2Samsung), la télécommande la pilote : flèches pour parcourir, OK pour ouvrir ou retirer, Retour pour fermer.

📦 Installation

Important

Prérequis :

  • Jellyfin 12.x
  • Jellyfin 10.11.x (avec NotifySync 5.8.4.0)
  • L'extension File Transformation, ou une modification manuelle (voir Sans File Transformation)

Étapes

  1. Ouvrez Tableau de bord → Extensions → Gérer les dépôts et ajoutez ces deux dépôts :

    NotifySync (le même pour 12.x et 10.11.x) :

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

    File Transformation (ajoute la cloche à Jellyfin et résiste à ses mises à jour) :

    https://www.iamparadox.dev/jellyfin/plugins/manifest.json
    
  2. Dans Extensions, filtre Disponible, installez NotifySync et File Transformation.

  3. Redémarrez Jellyfin, puis Ctrl+F5 dans votre navigateur.

  4. Dans Tableau de bord → Extensions → NotifySync, cochez les bibliothèques à surveiller, cliquez sur Sauvegarder puis Régénérer l'historique. La cloche reste vide tant qu'aucune bibliothèque n'est cochée.

Sans File Transformation

Aux étapes 1 et 2, n'ajoutez et n'installez que NotifySync. Avant l'étape 3, ajoutez vous-même la cloche à la page de Jellyfin avec la commande de votre système :

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 ce fichier dans un éditeur lancé en administrateur :

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

et collez cette ligne juste avant </body> :

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

Warning

À refaire après chaque mise à jour de Jellyfin, qui écrase index.html.

⚙️ Configuration

Allez dans Tableau de bord → Extensions → NotifySync.

Paramètre Défaut Description
Quota par catégorie 10 Nombre maximum de cartes affichées par catégorie (1 à 50).
Bibliothèques surveillées (aucune) Cochez les bibliothèques que vous souhaitez voir apparaître dans la cloche.
Collections surveillées (aucune) Collections (BoxSets) à surveiller pour les nouveaux ajouts. Scannées toutes les 15 minutes.
Mappage des catégories (vide) Renommez ou regroupez vos bibliothèques dans la cloche (ex. "Mes Films" → "Films"). Les flèches fixent l'ordre des filtres.
Sélection manuelle (IDs ou noms) (vide) IDs ou noms de bibliothèques pour les configurations avancées (Channels, XFusion).
Activer le suivi des suppressions activé Tient le journal des suppressions. Nécessaire pour détecter les remplacements Sonarr/Radarr (suppression puis réimport sous 7 jours).
Rétention (jours) 30 Nombre de jours de conservation du journal des suppressions (7 à 365).
Régénérer l'historique Scan complet, après un changement de bibliothèques ou de catégories.
Scanner les collections Scanne tout de suite les collections surveillées.

❓ Dépannage

Problème Solution
La cloche n'apparaît pas Vérifiez que File Transformation est installé. Redémarrez Jellyfin, puis Ctrl+F5.
Pas de cloche et des erreurs 401 Unauthorized dans la console du navigateur Votre serveur est en Jellyfin 12 avec l'ancienne version 5.x. Mettez NotifySync à jour en 6.x depuis Extensions, redémarrez Jellyfin, puis Ctrl+F5.
La cloche a disparu après une mise à jour de Jellyfin Sans File Transformation, chaque mise à jour écrase la modification. Refaites-la, ou installez File Transformation.
Contenu ou musique manquant, compteur faux Cochez la bibliothèque dans Bibliothèques surveillées, puis cliquez sur Régénérer l'historique.
Un fichier remplacé apparaît en NOUVEAU au lieu de MAJ Cochez Activer le suivi des suppressions. Il est nécessaire quand un fichier est supprimé puis réimporté.
Un fichier renommé affiche un faux badge MAJ Un simple renommage ne déclenche rien. Si un badge apparaît quand même, retirez-le : il ne reviendra pas.
Une série déplacée apparaît en NOUVEAU Cochez Activer le suivi des suppressions. La détection ne marche que si le dossier garde son nom.
Contenu non autorisé visible Le plugin suit les droits Jellyfin. Vérifiez les restrictions de l'utilisateur.
Pas de cloche sur les pages d'administration C'est normal : la cloche n'apparaît que sur les pages des utilisateurs.
« Patientez 30 secondes » Régénérer l'historique et Scanner les collections se lancent chacun au plus une fois toutes les 30 secondes. Attendez, puis cliquez de nouveau.
Incompatible Utilisez le dépôt de l'Installation. Jellyfin 12.x demande NotifySync 6.x.

🎨 Thème recommandé

NotifySync va bien avec ElegantFin Cinema Edition, un thème Jellyfin inspiré des plateformes de streaming. Les deux fonctionnent ensemble sur PC, mobile et TV.

💬 Support

Ouvrez une issue sur GitHub en indiquant votre version de Jellyfin, celle de NotifySync, l'appli ou le navigateur utilisé, et le journal du serveur si possible. Les contributions et idées de fonctionnalités y sont aussi les bienvenues.

👥 Auteurs & Crédits

NotifySync est maintenu par :

🙏 Contributeurs

@muisje @Wernouxe @hstark16 @Shillooh

Distribué sous Licence MIT.

About

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

Topics

Resources

Stars

27 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages