github ZL154/AchievementBadges_for_Jellyfin v1.5.0
v1.5.0 - Rank system, toasts, recap, custom badges, challenges, webhooks + much more

latest releases: v2.4.0, v2.3.1, v2.3.0...
5 months ago

The massive v1.5.0 release

Rank system

Ten-tier ladder based on achievement score:
Rookie → Novice → Viewer → Regular → Enthusiast → Binger → Connoisseur → Maestro → Legend → Immortal

Shown with a progress bar on the standalone achievements page and the new home-screen widget.

Unlock toast notifications

Styled popups in the top-right whenever a badge unlocks. Polls every 30s automatically. Toggle in admin settings.

Hidden / secret badges

6 new secret badges shown as ??? until unlocked — Night Shift, Obsessed, Speedrunner, True Polyglot, Completionist Supreme, Never Misses.

Library completion

5 new badges (10/25/50/75/100%) that auto-scale to whatever libraries you have. Recomputed on demand via admin endpoint + live updates on every play.

Recap page

New Recap tab with weekly/monthly/yearly breakdowns: items, movies, episodes, active days, unlocks, top genres, directors, actors.

Home screen widget

Card injected above the home page sections showing your current rank, score, next rank target, and the 3 badges you're closest to unlocking. Toggle-able.

Item detail ribbon

Small achievement status ribbon injected on item detail pages showing your unlock count + score. Toggle-able.

Daily login streak

4 new loyalty badges (Regular Visitor, Monthly Regular, Dedicated, Here Every Day). Login is registered every time you open the achievements page.

Director / Actor affinity

6 new People badges tracking your favourites. Items are scanned for Directors and Actors via BaseItem.People and counted bounded to top 100 directors / top 200 actors.

Admin: Custom badges

Paste JSON in the plugin settings to define your own badges pointing at any existing metric.

Admin: Seasonal challenges

Time-limited goals with start/end dates. When the window closes, earned challenges stay in users' profiles permanently.

Admin: Webhook notifications

Post to Discord / Slack / any webhook URL on every unlock. Template placeholders: {user}, {badge}, {rarity}, {description}.

Admin: UI feature toggles

Disable toasts, home widget, or item ribbon individually.

Search + smart filters

Search box filters badges by title/category/rarity/description. Filter dropdown: all / unlocked / locked / close to unlock (>50%).

Category leaderboards

6 tabs: Score, Movies, Episodes, Hours, Best Streak, Series.

Shareable profile card

New endpoint at /Plugins/AchievementBadges/users/{id}/profile-card renders an HTML card with rank, score, stats, equipped badges. Screenshot to share.

How to test

  1. Update + restart Jellyfin.
  2. Re-run Scan watch history to populate new metrics (genres, directors, actors, library completion).
  3. Open the Achievements page — you should see rank progress bar, search box, recap tab, new leaderboard categories.
  4. Configure webhook in plugin settings (test with a Discord channel).
  5. Navigate to home page — widget should appear at the top.
  6. Open any movie's detail page — ribbon should appear above the primary content.
  7. Play something past 80% — unlock toasts should pop up for any newly earned badges.

Don't miss a new AchievementBadges_for_Jellyfin release

NewReleases is sending notifications on new releases.