Skip to main content
Version: v1.6.49

Emby

Emby is a powerful multimedia management application suite designed for organizing, managing, and sharing digital media files. Through this plugin, AMMDS can integrate with Emby media server to implement metadata synchronization and media library management.

Plugin Configuration

Plugin Configuration

Basic Configuration

ParameterDescriptionDefault Value
Enable StatusControls whether to enable the Emby pluginDisabled
Service AddressEmby server network endpointhttp://127.0.0.1:8096
API KeyEmby server authentication token-
Username(Optional) Emby server login username-
Password(Optional) Emby server login password-
Bind UserSelect the Emby user account to bind-

Plugin Configuration

Configuration Notes

  • Service Address: Please use the server's actual network address. Avoid using localhost or 127.0.0.1, as this may cause connection failures in containerized deployments
  • API Key: Can be generated in the Emby management interface under "System" → "Advanced" → "API Keys"
  • Bind User: You must first enter the correct service address and API key and save before you can select a user from the dropdown list

Connection Verification

  • Network Connectivity: Ensure the AMMDS server can access the Emby service address
  • Authentication Information: API key must have sufficient permissions to perform required operations
  • Service Status: Ensure the Emby server is running and can properly respond to API requests

Features

  • Metadata Synchronization: Supports bidirectional metadata synchronization with Emby media libraries
  • User Binding: Can bind to specific Emby users for personalized configuration
  • Status Monitoring: Real-time monitoring of Emby server running status

Notes

Service Address Configuration

Do not use localhost or 127.0.0.1 as the service address, especially in containerized deployment environments, as this may cause connection failures.

API Key Permissions

It is recommended to create a dedicated API key for AMMDS with appropriate permission scope to ensure system security.