PLAXT
Get Started

Emby Setup

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

Prerequisites

  • An Emby server (self-hosted or Emby Premiere)
  • Admin access to your Emby server
  • An API key from Emby

Getting Your API Key

  1. Open your Emby server’s web interface
  2. Go to Settings → API Keys
  3. Click New API Key
  4. Enter a name (e.g., “Plaxt”)
  5. Copy the generated API key

Connecting Emby

  1. Go to Connections in the Plaxt dashboard
  2. Click Connect Emby
  3. Enter your Emby 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 Emby:

Webhooks

Webhooks provide instant notifications when playback events occur.

Setup:

  1. Open your sync link settings in Plaxt
  2. Copy the webhook URL
  3. In Emby, go to Settings → Webhooks (requires Emby Premiere or a webhook plugin)
  4. Add a new webhook with your Plaxt URL
  5. Enable playback events (play, pause, stop)

WebSocket monitoring provides real-time updates without requiring webhooks.

Setup:

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

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

Multi-User Support

Emby supports multiple users natively:

  1. When connecting Emby, select which users to enable
  2. Create separate sync links for each user you want to track
  3. Each sync link connects one Emby user to one tracking account

Server URL Tips

Your server URL should be:

  • Local network: http://192.168.x.x:8096
  • With domain: https://emby.yourdomain.com
  • With reverse proxy: Include the full path if needed

Make sure the URL is accessible from the internet if you want real-time scrobbling.

Troubleshooting

Connection failed

  1. Verify your server URL is correct and accessible
  2. Check that your API key is valid
  3. Ensure Emby is running and not firewalled

WebSocket disconnecting

  1. Check if your server has connection limits
  2. Verify your network allows WebSocket connections
  3. Try reconnecting from the Plaxt dashboard

Events not syncing

  1. Check the event log in your sync link
  2. Verify the correct user is selected
  3. Ensure playback notifications are enabled in Emby

Best Practices

  • Use WebSocket monitoring for most reliable real-time sync
  • Keep your API key secure—regenerate if compromised
  • Use HTTPS if your server is exposed to the internet
Back to Docs Edit on GitHub