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 credentials for your Emby server, or an Emby Connect account

Connecting Emby

Plaxt supports two ways to connect your Emby server:

If you have an Emby Connect account:

  1. Go to Connections in the Plaxt dashboard
  2. Click Connect Emby
  3. Choose Emby Connect
  4. Enter your Emby Connect email and password
  5. Select the server you want to connect from the list
  6. Click Connect

Option 2: Direct Authentication

If you prefer to connect directly to your server:

  1. Go to Connections in the Plaxt dashboard
  2. Click Connect Emby
  3. Choose Direct Connection
  4. Enter your Emby server URL (e.g., http://192.168.1.100:8096)
  5. Enter your Emby username and password
  6. 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

Emby supports webhooks for instant playback notifications via the Emby webhook plugin.

Setup:

  1. Install a webhook plugin in Emby (e.g., from the plugin catalog)
  2. Create a sync link in Plaxt and copy the webhook URL provided
  3. In the Emby webhook plugin settings, add your Plaxt webhook URL
  4. 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 username and password are correct
  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
  • Use HTTPS if your server is exposed to the internet
  • Emby Connect is the easiest way to get started
Back to Docs