iobroker.emby 1.3.0 → 2.0.0

package/README.md

@@ -17,77 +17,104 @@
 </br>
 **Tests:** </br>
 [![Test and Release](https://github.com/iobroker-community-adapters/ioBroker.emby/actions/workflows/test-and-release.yml/badge.svg)](https://github.com/iobroker-community-adapters/ioBroker.emby/actions/workflows/test-and-release.yml)
-[![CodeQL](https://github.com/iobroker-community-adapters/ioBroker.emby/actions/workflows/codeql.yml/badge.svg)](https://github.com/iobroker-community-adapters/ioBroker.emby/actions/workflows/codeql.yml)
 
-<!--
-## Sentry
-**This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers.**
-For more details and for information how to disable the error reporting see [Sentry-Plugin Documentation](https://github.com/ioBroker/plugin-sentry#plugin-sentry)! Sentry reporting is used starting with js-controller 3.0.
--->
-
-## EMBY Adapter for ioBroker
+## Emby adapter for ioBroker
 
-This adapter will allow you to connect to your Emby Server and controle it.
+Connects ioBroker to an [Emby](https://emby.media) media server. The adapter receives the active client sessions via WebSocket (what is playing, playback state, user) and can control clients that support remote control (play/pause, mute, volume, messages, navigation).
 
 ## Credits
 
-This adapter would not have been possible without the great work of @thewhobox <iobroker@mikegerst.de>, who Wrote the initial versions of this adapter and doneted it to the iobroker-community-adapters organization.
+This adapter would not have been possible without the great work of @thewhobox <iobroker@mikegerst.de>, who wrote the initial versions of this adapter and donated it to the iobroker-community-adapters organization.
 
+## Requirements
 
-## Usage
+- Node.js >= 22.19.0
+- js-controller >= 6.0.11, admin >= 7.7.22
+- Emby Server (tested with 4.10) reachable from the ioBroker host
+- An Emby API key for controlling clients (Emby dashboard > Advanced > API Keys)
 
-Please follow the Steps to ensure the Adapter will work correctly and you can see all Devices.
+## Configuration
 
-1. Edit the Settings and enter the IP, ApiKey and maybe some DeviceIds you want to ignore.
+| Setting | Description |
+| ------------- | ------------- |
+| IP/Domain | Address of the Emby server **with port**, e.g. `192.168.0.100:8096` |
+| Connection requires SSL | Use `https`/`wss` (e.g. behind a reverse proxy) |
+| API Key | Key from the Emby dashboard. Stored encrypted. Without a key the adapter only receives data and cannot control clients. |
+| Session or device IDs to ignore | Comma separated list. Matches the session ID (object name below `emby.0`) or the Emby device ID. |
+| Delay for pause/idle | Time in ms before `media.state` changes from `playing` to `paused`/`idle`. Prevents flickering between two episodes. |
+| Poll interval for sessions | Seconds between REST queries of the sessions (default 60, 0 = off). Emby pushes only changes, the poll keeps `info.lastActivity` current and runs the cleanup. Requires the API key. |
+| Remove objects of clients deleted in Emby | Default on. When a client is removed in the Emby dashboard (Devices), its objects are deleted as soon as the server no longer reports its session. |
+| Remove objects of inactive clients after | Days without activity after which the objects of a client the server no longer reports are deleted (default 0 = off). Scripts and history settings on these objects are lost. |
 
-  ```IP **with** Port => 192.168.0.100:8096```
-  
-2. Save and restart the Adapter.
-
-3. To see the first Items you will have to open a Emby Client to recieve some Data.
-  
-  ```The Adapter will not get Data if **no** client is open.```
+The adapter creates a device for every session the server reports. The object ID is the Emby session ID, the object name is the device name shown in Emby (it can be changed in the Emby dashboard under Devices). Emby only reports a session while the client is connected, so open an Emby app or the web client once to see the first device.
 
+Note: Emby assigns a new session ID when a client reconnects. The adapter then removes the objects of the old session of the same client automatically, so only one device per client remains. Scripts that use the session ID in the object path have to be adjusted in that case. Devices of clients that are not seen again are kept with `info.online = false`; they are removed when the client is deleted in the Emby dashboard or after the configured number of inactive days (see Configuration), or can be deleted manually.
 
 ## Objects
 
-### Infos
+### Adapter
 
-| Command | Description | Info |
-| ------------- | ------------- | ------------- |
-| x.info.deviceName | Shows the Name of the Device |  |
-| x.info.userName | Shows the Name of User logged in on the device |  |
-| x.info.supportedCommands | List of supported commands |  |
+| Object | Description |
+| ------------- | ------------- |
+| info.connection | `true` while the WebSocket connection to the server is open |
+
+### Info
 
+| Object | Description | Info |
+| ------------- | ------------- | ------------- |
+| x.info.online | Session is currently reported by the server | `false` after the client was closed or switched off |
+| x.info.deviceName | Name of the device |  |
+| x.info.userName | Name of the user logged in on the device |  |
+| x.info.supportedCommands | Commands supported by the client (JSON array) |  |
+| x.info.lastActivity | Time of the last activity reported by the server | Timestamp (ms). Emby keeps sessions of closed clients for a while, so this shows whether a client is really in use |
 
 ### Media
 
-| Command | Description | Info |
+| Object | Description | Info |
 | ------------- | ------------- | ------------- |
-| x.media.description | Description of the shown File. |  |
-| x.media.isMuted | If Media is Muted. | Not all devices support this and will be False. |
-| x.media.state | State of Media. | playing, paused, idle |
-| x.media.title | The Title of the shown File. |  |
-| x.media.type | The Type of the shown File. | Episode, Movie, Audio, None, etc. |
-| x.media.seasonName | The Name of the Season  | Only if .media.type is Episode otherwise it will be empty. |
-| x.media.seriesName | The Name of the Serie | Only if .media.type is Episode otherwise it will be empty. |
-
+| x.media.state | State of the client | `playing`, `paused`, `idle` |
+| x.media.title | Title of the item |  |
+| x.media.originaltitle | Original title |  |
+| x.media.description | Description of the item |  |
+| x.media.type | Type of the item | `Episode`, `Movie`, `Audio`, `None`, … |
+| x.media.seriesName | Name of the series | Only for episodes, otherwise empty |
+| x.media.seasonName | Name of the season | Only for episodes, otherwise empty |
+| x.media.endtime | Expected end of playback | `HH:MM` |
+| x.media.rating | Community rating | `null` if unknown |
+| x.media.agerating | Official age rating |  |
+| x.media.year | Production year | `null` if unknown |
+| x.media.genres | Genres (comma separated) |  |
+| x.media.tags | Taglines (comma separated) |  |
+| x.media.backdropimage | Backdrop image tags (comma separated) |  |
+| x.media.ratio | Aspect ratio of the primary image | `null` if unknown |
+| x.media.isMuted | Client is muted | Not all clients report this |
+
+### Posters
+
+| Object | Description | Info |
+| ------------- | ------------- | ------------- |
+| x.posters.main | URL of the main poster (movie or series) |  |
+| x.posters.season | URL of the season poster | Only for episodes |
+| x.posters.episode | URL of the episode image | Only for episodes |
 
 ### Commands
 
-| Command | Description | Info |
-| ------------- | ------------- | ------------- |
-| x.command.dialog | Show a dialog on the selected Device. | For example: Header\|Some text (if no header given, ioBroker will be Header) |
-| x.command.goHome | Sends a command to the selected Device which will return to the Homescreen |  |
-| x.command.message | Show a message on the selected Device for 5 sec. |  |
-| x.command.play | Plays Media | Only if media is paused |
-| x.command.pause | Pauses Media | Only if media is playing |
-| x.command.toggleplay | Toggles Playstate | play/pause |
-| x.command.mute | Mutes the device |  |
-| x.command.unmute | Unmutes the device |  |
-| x.command.togglemute | Toggles mute of device |  |
-| x.command.volume | Sets the Volume of the selected Device. | Doesn't work on the most of devices since it doenst controle the TV Volume. |
+Only created for clients that support remote control, and only for commands the client reports.
 
+| Object | Description | Info |
+| ------------- | ------------- | ------------- |
+| x.command.play | Resume playback | Button |
+| x.command.pause | Pause playback | Button |
+| x.command.toggleplay | Toggle play/pause | Button |
+| x.command.mute | Mute | Button |
+| x.command.unmute | Unmute | Button |
+| x.command.togglemute | Toggle mute | Button |
+| x.command.goHome | Go to the home screen | Button |
+| x.command.goToSearch | Open the search | Button |
+| x.command.back | Navigate back | Button |
+| x.command.volume | Volume 0-100 | Also shows the current volume reported by the client. Many clients (e.g. TV apps) do not control the TV volume. |
+| x.command.message | Show a message for 5 seconds | Text |
+| x.command.dialog | Show a dialog that stays until it is closed | `Header\|Text`, without `\|` the header is "ioBroker" |
 
 ## Changelog
 
@@ -95,6 +122,31 @@ Please follow the Steps to ensure the Adapter will work correctly and you can se
     Placeholder for the next version (at the beginning of the line):
     ### **WORK IN PROGRESS**
 -->
+### 2.0.0 (2026-10-29)
+- (copilot) Adapter requires node.js >= 22.19.0 now
+- (Schimi1983) Connection is re-established after the server closes it (e.g. server restart), KeepAlive is sent, info.connection reflects the real state
+- (Schimi1983) Only "Sessions" messages are processed as sessions, invalid messages no longer cause errors
+- (Schimi1983) Fixed command.volume (always failed), command.unmute is created for clients reporting "Unmute"
+- (Schimi1983) Messages and dialogs with quotes or line breaks work now
+- (Schimi1983) Commands use https if SSL is enabled, API key is sent as header and no longer logged
+- (Schimi1983) API key is stored encrypted, an existing key is converted automatically (one restart)
+- (Schimi1983) New states info.online and info.lastActivity per session; sessions that disappear are reset to idle
+- (Schimi1983) Current sessions are read via REST right after connecting, the server pushes them only on the next change
+- (Schimi1983) Sessions are polled every 60 s (configurable) to keep info.lastActivity current
+- (Schimi1983) Optional cleanup: objects of clients deleted in Emby (default on) or inactive for a configurable number of days (default off) are removed
+- (Schimi1983) Object types of buttons fixed, empty numbers are written as null, states are only written on change
+- (Schimi1983) Dependencies "request" and "websocket" replaced by native fetch and WebSocket
+- (Schimi1983) API key is entered in a password field
+- (Schimi1983) The adapter no longer shows up as its own device, it connects with a device ID per instance
+- (Schimi1983) Objects of an old session are removed when the same client connects with a new session ID
+- (Schimi1983) Command states are created as soon as a client reports remote control support, not only on adapter start
+- (Schimi1983) Device names follow the display name set in the Emby dashboard; REST calls use the adapter's device ID so they do not appear as an extra client
+- (Schimi1983) README updated: configuration, all objects, broken CodeQL badge removed
+- (Schimi1983) Admin UI migrated to jsonConfig (based on #275), API key is entered in a password field, short-form i18n files
+- (GermanBluefox) Dependencies updated (@iobroker/adapter-core 3.4.3)
+- (GermanBluefox) Package content defined via "files" in package.json, tsconfig added for type checking
+- (GermanBluefox) The adapter was refactored to TypeScript
+
 ### 1.3.0 (2026-03-03)
 - (mcm1957) Adapter requires node.js >= 20 now
 - (copilot) Adapter requires admin >= 7.7.22 now
@@ -115,8 +167,7 @@ Please follow the Steps to ensure the Adapter will work correctly and you can se
 -   (thewhobox) An error causing multiple 'undefined' messages has been fixed. [#23]
 -   (mcm1957) Dependencies have been updated.
 
-### 1.0.3
-* Added more info for playing item
+[Older changelogs can be found there](CHANGELOG_OLD.md)
 
 ## License
 

package/admin/i18n/de.json

@@ -0,0 +1,17 @@
+{
+    "ApiKey": "API-Schlüssel",
+    "ApiKeyHelp": "Einen Schlüssel im Emby-Dashboard unter Erweitert > API-Schlüssel anlegen. Ohne Schlüssel können Clients nur überwacht, aber nicht gesteuert werden.",
+    "DeviceIds": "Zu ignorierende Session- oder Geräte-IDs (mit Komma getrennt)",
+    "hdrCleanup": "Aufräumen",
+    "hdrConnection": "Verbindung",
+    "hdrOptions": "Optionen",
+    "IP": "IP/Domain des Emby-Servers (mit Port)",
+    "isSSL": "Verbindung benötigt SSL",
+    "PollInterval": "Abfrageintervall für Sessions (s, 0 = aus)",
+    "PollIntervalDesc": "Emby meldet nur Änderungen. Die Abfrage hält die letzte Aktivität aktuell und wird für das Aufräumen benötigt.",
+    "RemoveDeletedDevices": "Objekte von Clients entfernen, die in Emby gelöscht wurden (Dashboard > Geräte)",
+    "RemoveInactiveDays": "Objekte inaktiver Clients entfernen nach (Tage, 0 = aus)",
+    "RemoveInactiveDaysDesc": "Nur Clients, die der Server nicht mehr meldet. Skripte und History-Einstellungen an diesen Objekten gehen verloren.",
+    "Timeout": "Verzögerung für Pause/Leerlauf (ms)",
+    "TimeoutDesc": "Nötig, wenn mehrere Folgen hintereinander gespielt werden."
+}

package/admin/i18n/en.json

@@ -0,0 +1,17 @@
+{
+    "ApiKey": "API Key",
+    "ApiKeyHelp": "Create a key in the Emby dashboard under Advanced > API Keys. Without a key clients can be monitored but not controlled.",
+    "DeviceIds": "Session or device IDs to ignore (comma separated)",
+    "hdrCleanup": "Cleanup",
+    "hdrConnection": "Connection",
+    "hdrOptions": "Options",
+    "IP": "IP/Domain of the Emby server (with port)",
+    "isSSL": "Connection requires SSL",
+    "PollInterval": "Poll interval for sessions (s, 0 = off)",
+    "PollIntervalDesc": "Emby only pushes changes. The poll keeps the last activity up to date and is needed for the cleanup.",
+    "RemoveDeletedDevices": "Remove objects of clients deleted in Emby (Dashboard > Devices)",
+    "RemoveInactiveDays": "Remove objects of inactive clients after (days, 0 = off)",
+    "RemoveInactiveDaysDesc": "Only clients the server no longer reports. Scripts and history settings on these objects are lost.",
+    "Timeout": "Delay for pause/idle (ms)",
+    "TimeoutDesc": "Necessary when you watch more episodes in one row."
+}

package/admin/i18n/es.json

@@ -0,0 +1,17 @@
+{
+    "ApiKey": "Clave API",
+    "ApiKeyHelp": "Cree una clave en el panel de Emby en Avanzado > Claves API. Sin clave, los clientes se pueden supervisar pero no controlar.",
+    "DeviceIds": "ID de sesión o de dispositivo a ignorar (separados por comas)",
+    "hdrCleanup": "Limpieza",
+    "hdrConnection": "Conexión",
+    "hdrOptions": "Opciones",
+    "IP": "IP/Dominio del servidor Emby (con puerto)",
+    "isSSL": "La conexión requiere SSL",
+    "PollInterval": "Intervalo de consulta de sesiones (s, 0 = desactivado)",
+    "PollIntervalDesc": "Emby solo envía cambios. La consulta mantiene actualizada la última actividad y es necesaria para la limpieza.",
+    "RemoveDeletedDevices": "Eliminar los objetos de clientes borrados en Emby (Panel > Dispositivos)",
+    "RemoveInactiveDays": "Eliminar los objetos de clientes inactivos después de (días, 0 = desactivado)",
+    "RemoveInactiveDaysDesc": "Solo clientes que el servidor ya no informa. Se pierden los scripts y la configuración del historial de estos objetos.",
+    "Timeout": "Retraso para pausa/inactividad (ms)",
+    "TimeoutDesc": "Necesario cuando miras más episodios seguidos."
+}

package/admin/i18n/fr.json

@@ -0,0 +1,17 @@
+{
+    "ApiKey": "clé API",
+    "ApiKeyHelp": "Créez une clé dans le tableau de bord Emby sous Avancé > Clés API. Sans clé, les clients peuvent être surveillés mais pas contrôlés.",
+    "DeviceIds": "ID de session ou d’appareil à ignorer (séparés par des virgules)",
+    "hdrCleanup": "Nettoyage",
+    "hdrConnection": "Connexion",
+    "hdrOptions": "Options",
+    "IP": "IP/Domaine du serveur Emby (avec port)",
+    "isSSL": "La connexion nécessite SSL",
+    "PollInterval": "Intervalle d’interrogation des sessions (s, 0 = désactivé)",
+    "PollIntervalDesc": "Emby n’envoie que les changements. L’interrogation maintient la dernière activité à jour et est nécessaire au nettoyage.",
+    "RemoveDeletedDevices": "Supprimer les objets des clients supprimés dans Emby (Tableau de bord > Appareils)",
+    "RemoveInactiveDays": "Supprimer les objets des clients inactifs après (jours, 0 = désactivé)",
+    "RemoveInactiveDaysDesc": "Uniquement les clients que le serveur ne signale plus. Les scripts et réglages d’historique de ces objets sont perdus.",
+    "Timeout": "Délai pour pause/inactivité (ms)",
+    "TimeoutDesc": "Nécessaire lorsque vous regardez plusieurs épisodes d’affilée."
+}

package/admin/i18n/it.json

@@ -0,0 +1,17 @@
+{
+    "ApiKey": "Chiave API",
+    "ApiKeyHelp": "Crea una chiave nella dashboard di Emby in Avanzate > Chiavi API. Senza chiave i client possono essere monitorati ma non controllati.",
+    "DeviceIds": "ID di sessione o dispositivo da ignorare (separati da virgola)",
+    "hdrCleanup": "Pulizia",
+    "hdrConnection": "Connessione",
+    "hdrOptions": "Opzioni",
+    "IP": "IP/Dominio del server Emby (con porta)",
+    "isSSL": "La connessione richiede SSL",
+    "PollInterval": "Intervallo di interrogazione delle sessioni (s, 0 = disattivato)",
+    "PollIntervalDesc": "Emby invia solo le modifiche. L’interrogazione mantiene aggiornata l’ultima attività ed è necessaria per la pulizia.",
+    "RemoveDeletedDevices": "Rimuovi gli oggetti dei client eliminati in Emby (Dashboard > Dispositivi)",
+    "RemoveInactiveDays": "Rimuovi gli oggetti dei client inattivi dopo (giorni, 0 = disattivato)",
+    "RemoveInactiveDaysDesc": "Solo i client che il server non segnala più. Script e impostazioni della cronologia di questi oggetti vanno persi.",
+    "Timeout": "Ritardo per pausa/inattività (ms)",
+    "TimeoutDesc": "Necessario quando guardi più episodi di seguito."
+}

package/admin/i18n/nl.json

@@ -0,0 +1,17 @@
+{
+    "ApiKey": "API sleutel",
+    "ApiKeyHelp": "Maak een sleutel aan in het Emby-dashboard onder Geavanceerd > API-sleutels. Zonder sleutel kunnen clients worden gevolgd maar niet bediend.",
+    "DeviceIds": "Te negeren sessie- of apparaat-ID’s (kommagescheiden)",
+    "hdrCleanup": "Opruimen",
+    "hdrConnection": "Verbinding",
+    "hdrOptions": "Opties",
+    "IP": "IP/domein van de Emby-server (met poort)",
+    "isSSL": "Verbinding vereist SSL",
+    "PollInterval": "Pollinginterval voor sessies (s, 0 = uit)",
+    "PollIntervalDesc": "Emby meldt alleen wijzigingen. De polling houdt de laatste activiteit actueel en is nodig voor het opruimen.",
+    "RemoveDeletedDevices": "Objecten verwijderen van clients die in Emby zijn verwijderd (Dashboard > Apparaten)",
+    "RemoveInactiveDays": "Objecten van inactieve clients verwijderen na (dagen, 0 = uit)",
+    "RemoveInactiveDaysDesc": "Alleen clients die de server niet meer meldt. Scripts en historie-instellingen van deze objecten gaan verloren.",
+    "Timeout": "Vertraging voor pauze/inactief (ms)",
+    "TimeoutDesc": "Noodzakelijk als je meerdere afleveringen achter elkaar bekijkt."
+}

package/admin/i18n/pl.json

@@ -0,0 +1,17 @@
+{
+    "ApiKey": "Klucz API",
+    "ApiKeyHelp": "Utwórz klucz w panelu Emby w sekcji Zaawansowane > Klucze API. Bez klucza klienty można monitorować, ale nie można nimi sterować.",
+    "DeviceIds": "Identyfikatory sesji lub urządzeń do pominięcia (oddzielone przecinkami)",
+    "hdrCleanup": "Porządkowanie",
+    "hdrConnection": "Połączenie",
+    "hdrOptions": "Opcje",
+    "IP": "IP/domena serwera Emby (z portem)",
+    "isSSL": "Połączenie wymaga protokołu SSL",
+    "PollInterval": "Interwał odpytywania sesji (s, 0 = wył.)",
+    "PollIntervalDesc": "Emby wysyła tylko zmiany. Odpytywanie aktualizuje ostatnią aktywność i jest potrzebne do porządkowania.",
+    "RemoveDeletedDevices": "Usuń obiekty klientów usuniętych w Emby (Panel > Urządzenia)",
+    "RemoveInactiveDays": "Usuń obiekty nieaktywnych klientów po (dni, 0 = wył.)",
+    "RemoveInactiveDaysDesc": "Tylko klienci, których serwer już nie zgłasza. Skrypty i ustawienia historii tych obiektów zostaną utracone.",
+    "Timeout": "Opóźnienie dla pauzy/bezczynności (ms)",
+    "TimeoutDesc": "Niezbędne, gdy oglądasz więcej odcinków w jednym rzędzie."
+}

package/admin/i18n/pt.json

@@ -0,0 +1,17 @@
+{
+    "ApiKey": "Chave API",
+    "ApiKeyHelp": "Crie uma chave no painel do Emby em Avançado > Chaves de API. Sem chave, os clientes podem ser monitorados, mas não controlados.",
+    "DeviceIds": "IDs de sessão ou de dispositivo a ignorar (separados por vírgula)",
+    "hdrCleanup": "Limpeza",
+    "hdrConnection": "Conexão",
+    "hdrOptions": "Opções",
+    "IP": "IP/Domínio do servidor Emby (com porta)",
+    "isSSL": "A conexão requer SSL",
+    "PollInterval": "Intervalo de consulta das sessões (s, 0 = desligado)",
+    "PollIntervalDesc": "O Emby só envia alterações. A consulta mantém a última atividade atualizada e é necessária para a limpeza.",
+    "RemoveDeletedDevices": "Remover os objetos de clientes excluídos no Emby (Painel > Dispositivos)",
+    "RemoveInactiveDays": "Remover os objetos de clientes inativos após (dias, 0 = desligado)",
+    "RemoveInactiveDaysDesc": "Apenas clientes que o servidor já não informa. Scripts e configurações de histórico desses objetos são perdidos.",
+    "Timeout": "Atraso para pausa/inatividade (ms)",
+    "TimeoutDesc": "Necessário quando você assiste mais episódios seguidos."
+}

package/admin/i18n/ru.json

@@ -0,0 +1,17 @@
+{
+    "ApiKey": "Ключ API",
+    "ApiKeyHelp": "Создайте ключ в панели Emby в разделе «Дополнительно > API-ключи». Без ключа клиенты можно отслеживать, но не управлять ими.",
+    "DeviceIds": "ID сеансов или устройств, которые нужно игнорировать (через запятую)",
+    "hdrCleanup": "Очистка",
+    "hdrConnection": "Подключение",
+    "hdrOptions": "Параметры",
+    "IP": "IP / Домен сервера Emby (с портом)",
+    "isSSL": "Для подключения требуется SSL",
+    "PollInterval": "Интервал опроса сеансов (с, 0 = выкл.)",
+    "PollIntervalDesc": "Emby сообщает только об изменениях. Опрос поддерживает актуальность последней активности и нужен для очистки.",
+    "RemoveDeletedDevices": "Удалять объекты клиентов, удалённых в Emby (Панель > Устройства)",
+    "RemoveInactiveDays": "Удалять объекты неактивных клиентов через (дней, 0 = выкл.)",
+    "RemoveInactiveDaysDesc": "Только клиенты, о которых сервер больше не сообщает. Скрипты и настройки истории этих объектов будут потеряны.",
+    "Timeout": "Задержка для паузы/простоя (мс)",
+    "TimeoutDesc": "Необходим при просмотре нескольких серий подряд."
+}

package/admin/i18n/uk.json

@@ -0,0 +1,17 @@
+{
+    "ApiKey": "Ключ API",
+    "ApiKeyHelp": "Створіть ключ на панелі Emby у розділі «Додатково > API-ключі». Без ключа клієнтів можна відстежувати, але не керувати ними.",
+    "DeviceIds": "ID сеансів або пристроїв, які потрібно ігнорувати (через кому)",
+    "hdrCleanup": "Очищення",
+    "hdrConnection": "Підключення",
+    "hdrOptions": "Параметри",
+    "IP": "IP/домен сервера Emby (з портом)",
+    "isSSL": "Для підключення потрібен SSL",
+    "PollInterval": "Інтервал опитування сеансів (с, 0 = вимк.)",
+    "PollIntervalDesc": "Emby повідомляє лише про зміни. Опитування підтримує актуальність останньої активності та потрібне для очищення.",
+    "RemoveDeletedDevices": "Видаляти об’єкти клієнтів, видалених в Emby (Панель > Пристрої)",
+    "RemoveInactiveDays": "Видаляти об’єкти неактивних клієнтів через (днів, 0 = вимк.)",
+    "RemoveInactiveDaysDesc": "Лише клієнти, про яких сервер більше не повідомляє. Скрипти та налаштування історії цих об’єктів буде втрачено.",
+    "Timeout": "Затримка для паузи/простою (мс)",
+    "TimeoutDesc": "Необхідно, коли ви переглядаєте кілька серій в одному рядку."
+}

package/admin/i18n/zh-cn.json

@@ -0,0 +1,17 @@
+{
+    "ApiKey": "API密钥",
+    "ApiKeyHelp": "在 Emby 控制台的“高级 > API 密钥”中创建密钥。没有密钥时只能监视客户端，无法控制。",
+    "DeviceIds": "要忽略的会话或设备 ID（逗号分隔）",
+    "hdrCleanup": "清理",
+    "hdrConnection": "连接",
+    "hdrOptions": "选项",
+    "IP": "Emby 服务器的 IP/域名（带端口）",
+    "isSSL": "连接需要 SSL",
+    "PollInterval": "会话轮询间隔（秒，0 = 关闭）",
+    "PollIntervalDesc": "Emby 只推送变化。轮询使最后活动时间保持最新，并且是清理所必需的。",
+    "RemoveDeletedDevices": "删除在 Emby 中已删除的客户端的对象（控制台 > 设备）",
+    "RemoveInactiveDays": "在以下天数后删除不活动客户端的对象（天，0 = 关闭）",
+    "RemoveInactiveDaysDesc": "仅限服务器不再报告的客户端。这些对象上的脚本和历史记录设置将丢失。",
+    "Timeout": "暂停/空闲延迟（毫秒）",
+    "TimeoutDesc": "当您连续观看更多剧集时，这是必要的。"
+}

package/admin/jsonConfig.json

@@ -0,0 +1,130 @@
+{
+    "i18n": true,
+    "type": "panel",
+    "items": {
+        "hdrConnection": {
+            "type": "header",
+            "text": "hdrConnection",
+            "size": 2,
+            "xs": 12,
+            "sm": 12,
+            "md": 12,
+            "lg": 12,
+            "xl": 12
+        },
+        "ip": {
+            "type": "text",
+            "label": "IP",
+            "placeholder": "192.168.0.100:8096",
+            "newLine": true,
+            "xs": 12,
+            "sm": 12,
+            "md": 6,
+            "lg": 6,
+            "xl": 6
+        },
+        "isSSL": {
+            "type": "checkbox",
+            "label": "isSSL",
+            "xs": 12,
+            "sm": 12,
+            "md": 6,
+            "lg": 6,
+            "xl": 6
+        },
+        "apikey": {
+            "type": "password",
+            "label": "ApiKey",
+            "help": "ApiKeyHelp",
+            "visible": true,
+            "newLine": true,
+            "xs": 12,
+            "sm": 12,
+            "md": 6,
+            "lg": 6,
+            "xl": 6
+        },
+        "hdrOptions": {
+            "type": "header",
+            "text": "hdrOptions",
+            "size": 2,
+            "newLine": true,
+            "xs": 12,
+            "sm": 12,
+            "md": 12,
+            "lg": 12,
+            "xl": 12
+        },
+        "deviceIds": {
+            "type": "text",
+            "label": "DeviceIds",
+            "newLine": true,
+            "xs": 12,
+            "sm": 12,
+            "md": 12,
+            "lg": 12,
+            "xl": 12
+        },
+        "timeout": {
+            "type": "number",
+            "label": "Timeout",
+            "help": "TimeoutDesc",
+            "min": 0,
+            "max": 60000,
+            "step": 100,
+            "newLine": true,
+            "xs": 12,
+            "sm": 12,
+            "md": 6,
+            "lg": 6,
+            "xl": 6
+        },
+        "pollInterval": {
+            "type": "number",
+            "label": "PollInterval",
+            "help": "PollIntervalDesc",
+            "min": 0,
+            "max": 3600,
+            "newLine": true,
+            "xs": 12,
+            "sm": 12,
+            "md": 6,
+            "lg": 6,
+            "xl": 6
+        },
+        "hdrCleanup": {
+            "type": "header",
+            "text": "hdrCleanup",
+            "size": 2,
+            "newLine": true,
+            "xs": 12,
+            "sm": 12,
+            "md": 12,
+            "lg": 12,
+            "xl": 12
+        },
+        "removeDeletedDevices": {
+            "type": "checkbox",
+            "label": "RemoveDeletedDevices",
+            "newLine": true,
+            "xs": 12,
+            "sm": 12,
+            "md": 12,
+            "lg": 12,
+            "xl": 12
+        },
+        "removeInactiveDays": {
+            "type": "number",
+            "label": "RemoveInactiveDays",
+            "help": "RemoveInactiveDaysDesc",
+            "min": 0,
+            "max": 3650,
+            "newLine": true,
+            "xs": 12,
+            "sm": 12,
+            "md": 6,
+            "lg": 6,
+            "xl": 6
+        }
+    }
+}

package/build/lib/types.js

@@ -0,0 +1,5 @@
+"use strict";
+// Payloads of the Emby server (WebSocket and REST). Only the fields the adapter reads are listed,
+// all of them optional: the data comes from the server and is checked at runtime.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":";AAAA,kGAAkG;AAClG,kFAAkF"}