Emby integration
Purpose
Emby is an experimental media-server module. PlexSub supports it as a provider of media identity, permissions, and activity.
It appears in PlexSub at:
- Admin:
/emby - Customer Portal: general status, downloads, playback history, and usage
Requirements
- An Emby URL reachable from PlexSub.
- A valid API key or token.
- Users and libraries configured in Emby.
Related variables: EMBY_URL, EMBY_API_KEY, and EMBY_TOKEN.
Recommended configuration
- Confirm Emby responds from the Docker host.
- Configure the URL and API key.
- Enable the module in Settings > Services.
- Run diagnostics.
- Review the Customer Portal with a test user.
Module status
Emby is experimental. Validate it before relying on it for real customers.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| Cannot connect | Incorrect or unreachable URL | Check the internal URL, DNS, and firewall. |
| Authentication error | Invalid API key/token | Generate a new key in Emby. |
| Incomplete data | Experimental functionality | Check logs and diagnostics before publishing. |