PLAXT
Get Started

Jellyfin Setup

Connect your Jellyfin media server to sync watch history to your tracking services.

Prerequisites

  • A Jellyfin server (self-hosted)
  • A Jellyfin user account (admin access recommended)

Connecting Jellyfin

  1. Go to Connections in the Plaxt dashboard
  2. Click Connect Jellyfin
  3. Enter your Jellyfin server URL (e.g., http://192.168.1.100:8096)
  4. Enter your Jellyfin username and password
  5. Click Connect

Plaxt will authenticate with your server and list available users.

Real-time Scrobbling

Plaxt supports two methods for real-time scrobbling from Jellyfin:

Webhooks

Use the Jellyfin Webhook plugin for instant notifications. Plaxt can generate a webhook URL for you.

Setup:

  1. Install the Webhook plugin from Jellyfin’s plugin catalog and restart Jellyfin
  2. In Plaxt, go to your Jellyfin server settings and click Generate Webhook URL
  3. Copy the generated URL
  4. In Jellyfin, go to Dashboard → Plugins → Webhook
  5. Add a new webhook destination and paste your Plaxt webhook URL
  6. Enable playback events

WebSocket monitoring provides real-time updates without plugins.

Setup:

  1. Open your sync link settings in Plaxt
  2. Enable WebSocket Monitoring
  3. Plaxt automatically connects to your Jellyfin server

Note: Your Jellyfin server must be accessible from the internet for WebSocket monitoring to work.

Multi-User Support

Jellyfin supports multiple users:

  1. When connecting, Plaxt lists all available users
  2. Create separate sync links for each user
  3. Each sync link connects one Jellyfin user to one tracking account

Server URL Tips

Your server URL should be:

  • Local network: http://192.168.x.x:8096
  • With domain: https://jellyfin.yourdomain.com
  • Behind reverse proxy: Include the base URL if configured

Ensure the URL is accessible from the internet for real-time features.

Troubleshooting

Connection failed

  1. Verify your server URL is correct
  2. Check that your username and password are correct
  3. Ensure Jellyfin is running and accessible

WebSocket keeps disconnecting

  1. Check your server’s connection timeout settings
  2. Verify firewall rules allow WebSocket connections
  3. Try using webhooks as an alternative

Playback not detected

  1. Ensure the correct user is selected in your sync link
  2. Check if playback reporting is enabled in Jellyfin user settings
  3. Review the event log for errors

Best Practices

  • Use WebSocket for simplest setup, webhooks for reliability
  • Jellyfin is free and open-source—no subscription required
  • Consider using HTTPS for external access
Back to Docs