PLAXT
Get Started

Jellyfin Setup

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

Prerequisites

  • A Jellyfin server (self-hosted)
  • Admin access to your Jellyfin server
  • An API key from Jellyfin

Getting Your API Key

  1. Open your Jellyfin server’s web interface
  2. Go to Dashboard → API Keys
  3. Click the + button to create a new key
  4. Enter an app name (e.g., “Plaxt”)
  5. Copy the generated API key

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. Paste your API key
  5. Click Connect

Plaxt will verify the connection 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.

Setup:

  1. Install the Webhook plugin from Jellyfin’s plugin catalog
  2. Restart Jellyfin
  3. Go to Dashboard → Plugins → Webhook
  4. Add a new webhook destination
  5. 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 API key has admin privileges
  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
  • Keep your API key private and regenerate if exposed
  • Consider using HTTPS for external access
Back to Docs Edit on GitHub