Jellyfin Scrobbling: Sync Your Watch History Automatically
External Integrations

Jellyfin Scrobbling: Sync Your Watch History Automatically

I am thrilled to announce that Jellyfin Scrobbling has officially arrived at Series Reminder! If you self-host your media using Jellyfin, you can now automatically sync your watch history in real time directly to your Series Reminder account with no manual tracking required.

Jellyfin Scrobbling is an exclusive Premium feature currently in active beta testing. It is available to all members with an active Premium subscription.

If you do not have a subscription and you are willing to be a beta tester, please contact me directly and I will enable beta access on your account!

What the Jellyfin Plugin Does

The Jellyfin plugin provides custom functionality for your Jellyfin server that allows it to easily integrate with Series Reminder. Setup requires minimal configuration, and you can get up and running in under 10 minutes. Here is what it handles out of the box:

  • Automatic Playback Scrobbling: When you stream an episode on any device (Roku, Apple TV, Android TV, phone, or web browser) and watch at least 70% of the runtime (or reach the credits), your Jellyfin server instantly notifies Series Reminder to mark the episode watched.
  • Manual Checkmark Syncing: Clicking the checkmark in the Jellyfin UI to mark an individual episode as watched syncs immediately to your Series Reminder account.
  • Full Season & Series Syncing: Mark an entire season or complete series as watched with a single click.

    Tip: If you already watched a show before installing the plugin and want to sync your history to Series Reminder, simply uncheck and re-check the season or series checkmark in Jellyfin!
  • Automatic Watchlist Expansion: When an episode scrobbles for a series not currently in your favorites, Series Reminder automatically adds it to your watchlist with default "Season Premiere" alerts enabled. (Supporters get unlimited favorites, so your list grows automatically).
  • Multi-User Isolation: If your family or roommates share your Jellyfin server, each user profile can map their own separate Series Reminder Scrobble Key. Everyone who watches a show on their profile updates their own individual tracking history independently.

Step-by-Step Installation Guide

Setup takes less than 10 minutes directly inside your Jellyfin Server Dashboard:

Step 1: Add the Series Reminder Repository

  1. Log into your Jellyfin server as an administrator.
  2. Open the menu in the top right and navigate to Dashboard > Plugins.
  3. Click on the Repositories tab at the top.
  4. Click the + (Add) button in the top right.
  5. Enter the repository details:
    • Repository Name: Series Reminder
    • Repository URL: https://seriesreminder.com/jellyfin/manifest.json
  6. Click Save.

Step 2: Install the Plugin & Restart Jellyfin

  1. Click on the Catalog tab next to Repositories.
  2. Click the All filter at the top so all available plugins are displayed.
  3. Type Series Reminder into the search box, or scroll down to locate the Series Reminder card (featuring our logo).
  4. Click on the Series Reminder card and click the Install button.
  5. Once installation completes, navigate back to your main Dashboard and click Restart (or restart your Docker container / service). Jellyfin requires a restart to load new plugins into memory.

Step 3: Connect Your Personal Scrobble Key

  1. Visit your Jellyfin Integration Page on Series Reminder and click Copy Scrobble Key.
  2. In your Jellyfin Dashboard, go to Plugins, click on the Series Reminder card under your installed plugins, and select Settings.
  3. Select your Jellyfin user profile from the dropdown.
  4. Paste your personal Scrobble Key into the input box. (Leave the Base URL as the default https://seriesreminder.com).
  5. Click Save Settings for Selected User.

That is it! Stream any episode past the 70% mark or toggle a watched checkmark, and your Series Reminder dashboard will update in real time.

How Plugin Updates Work

Automatic Updates (Default)

Jellyfin includes a built-in background task called Update Plugins that runs automatically every 24 hours. Whenever I publish an update to the repository manifest, your Jellyfin server will automatically download the new package and prompt you to restart the server to apply it.

Checking for Updates Manually

If you want to pull a newly released version immediately without waiting for the daily background scan:

  1. Go to Dashboard > Scheduled Tasks in your Jellyfin sidebar.
  2. Find the task named Update Plugins and click the Play (▶) button.
  3. Alternatively, go to Dashboard > Plugins > Repositories, click the three dots on the Series Reminder repository, and click Refresh.
  4. If an update is available, click Update and restart your Jellyfin server.

Frequently Asked Questions

Does it track movies or home videos?

No. Series Reminder is designed specifically for episodic television. Movies, music videos, and personal home recordings streamed on your server are automatically ignored.

What if multiple people share my server?

In your Jellyfin dashboard under Series Reminder, simply select each user from the dropdown and paste their individual Series Reminder Scrobble Key. Each profile tracks independently to its own account.

How does episode matching work?

Our plugin extracts external TVDB metadata IDs directly from your Jellyfin server. If an episode or show is brand new, Series Reminder automatically queries TheTVDB to load the show metadata into our system seamlessly.

Have questions, feature suggestions, or feedback during the beta? Please contact me directly! I'd love to hear how the plugin is working on your setup!