Integración domótica Kodi, gratuita y de código abierto
Siga y controle Kodi: lo que se reproduce, volumen, botones, escenas al empezar una película.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Siga y controle Kodi, el centro multimedia libre (LibreELEC, OSMC, CoreELEC, Kodi en un PC, en un dispositivo Android TV o en una NVIDIA Shield), desde Gladys: lo que se reproduce, su progreso, el volumen, los botones de reproducción y escenas que reaccionan cuando una película empieza, se pausa o se detiene.
Todo se queda en su red local: la integración habla directamente con Kodi, a través de su interfaz JSON-RPC.
Probada con Kodi 20 y 21 en Docker, todavía no en LibreELEC, OSMC, CoreELEC ni en un dispositivo Android: sus comentarios son bienvenidos en el foro de Gladys.
Requisitos
- Gladys Assistant 5.1 o posterior.
- Kodi 19 o posterior (probado con 20 y 21), en la misma red local que Gladys.
- En Kodi, Ajustes → Servicios → Control:
- Permitir el control remoto vía HTTP: activado. Anote el puerto (8080 por defecto), el
usuario (
kodipor defecto) y la contraseña, si ha puesto una. - Permitir el control remoto desde aplicaciones de otros sistemas: activado. Abre el puerto 9090, por el que Kodi avisa a Gladys en tiempo real de lo que ocurre. Sin él, la integración funciona igualmente pero lee Kodi cada 10 segundos.
- Permitir el control remoto vía HTTP: activado. Anote el puerto (8080 por defecto), el
usuario (
- Para que se encuentre automáticamente: Ajustes → Servicios → General → Anunciar servicios a otros sistemas activado (el valor por defecto).
- Dé una dirección IP fija al equipo que ejecuta Kodi (reserva DHCP en su router).
Configuración
- Instale la integración desde la tienda de Gladys y abra su pestaña Configuración.
- Pulse Buscar Kodi en la red: cada Kodi encontrado ocupa un espacio libre (tres como
máximo). Recargue la página para ver sus direcciones. O introduzca usted mismo la dirección,
por ejemplo
192.168.1.40, o192.168.1.40:8081si el servidor web de Kodi no usa el puerto 8080. - Si Kodi pide una contraseña, rellene el Usuario (vacío equivale a
kodi) y la Contraseña del espacio, y guarde. - Probar la conexión: una línea por Kodi, con su nombre, su versión y lo que está haciendo.
- En la pestaña Descubrimiento, añada cada Kodi a Gladys.
La opción Idioma elige el idioma de los nombres de las funciones y de los textos que crea la integración (francés por defecto). Los nombres de las funciones se fijan al añadir el dispositivo.
En su primer arranque sin ninguna dirección, la integración busca una vez por sí misma en la red. Un escaneo desde la pestaña Descubrimiento vuelve a buscar.
El dispositivo Kodi
Un dispositivo por Kodi, con el nombre que Kodi se da a sí mismo (Ajustes → Servicios → General → Nombre del dispositivo). El número del espacio es su identidad: un Kodi que cambia de dirección conserva su dispositivo y su historial.
| Función | Tipo | Contenido |
|---|---|---|
| Reproducción | texto | Reproduciendo, En pausa, Detenido, Apagado o inaccesible |
| En reproducción | texto | Película (2024), Serie S01E02 – Título, Artista – Canción... |
| Tipo de medio | texto | Película, Episodio, Música, Canal de TV, Vídeo, Ninguno |
| Progreso | porcentaje | Posición en el medio, 0 para una emisión en directo |
| Tiempo restante | minutos | Hasta el final del medio, 0 para una emisión en directo |
| Volumen | control 0–100 | El volumen de Kodi, sigue al mando a distancia |
| Reproducir, Pausa | botones | Reanudar, pausar |
| Detener | botón | Detiene la reproducción |
| Anterior, Siguiente | botones | Elemento anterior o siguiente de la lista de reproducción |
| Silencio | botón | Silencia o activa el sonido |
«Vídeo» es lo que Kodi reproduce fuera de su biblioteca: un archivo abierto desde una carpeta, un flujo, un complemento. Las películas y episodios de la biblioteca son «Película» y «Episodio».
Kodi avisa de sus cambios en tiempo real (puerto 9090); durante la reproducción, el progreso se lee cada 10 segundos. Con el puerto 9090 cerrado, todo se lee cada 10 segundos por HTTP.
Widget del panel
El widget Kodi (elija el Kodi en sus ajustes) muestra la carátula de lo que se reproduce (cuando viene de la biblioteca), el título, el tipo de medio, el estado, la posición, la hora de fin y el volumen. Sus botones dependen del medio: reproducir/pausa, después detener (vídeo) o siguiente (música), y bajar / subir el volumen de 5 en 5 %.
Sin carátula, un indicador de progreso ocupa su lugar una vez añadido el dispositivo a Gladys.
Disparadores de escena
| Disparador | Cuándo |
|---|---|
| Reproducción iniciada | Kodi inicia un medio cuando no se reproducía nada, o el siguiente de una lista |
| Reproducción en pausa | Kodi se pone en pausa |
| Reproducción reanudada | Kodi reanuda tras una pausa |
| Reproducción detenida | La reproducción se detiene o llega a su fin, y no sigue nada |
Cada disparador puede limitarse a un Kodi y a ciertos tipos de medio (película, episodio, música, canal de TV, otro vídeo). Variables para los pasos siguientes: Título, Tipo de medio, Nombre del Kodi y, en una parada, Llegó al final.
Entre dos episodios de una lista de reproducción, Kodi se detiene y vuelve a empezar en una décima de segundo: la integración espera 1,5 segundos antes de indicar «detenida», de modo que el episodio siguiente es una «reproducción iniciada» y las luces no parpadean.
Los disparadores siguen lo que Kodi hace de verdad, sea cual sea el origen: el mando, el widget o una acción de escena. No se dispara nada por lo que ya se reproducía al arrancar la integración, ni cuando Kodi se apaga.
Acciones de escena
| Acción | Qué hace |
|---|---|
| Controlar la reproducción | Reproducir, pausa, reproducir/pausa, detener, siguiente, anterior |
| Ajustar el volumen | Volumen de 0 a 100 |
| Silenciar o activar el sonido | Silenciar, activar o alternar |
| Mostrar una notificación en Kodi | Un mensaje con título en la esquina de la pantalla |
| Reproducir un medio | Un archivo, una carpeta o un flujo, por su ruta o URL tal como Kodi la conoce |
| Actualizar la biblioteca | Kodi busca nuevos medios en sus fuentes de vídeo o de música |
| Leer el estado de Kodi | Estado, título, tipo de medio, progreso, minutos restantes, volumen |
«Controlar la reproducción» devuelve Aplicado: falso cuando no se reproducía nada, sin que
falle la escena. «Leer el estado de Kodi» da a los pasos siguientes lo que necesitan para una
condición «continuar solo si»: estado (off, stopped, playing, paused), tipo de medio
(movie, episode, music, tv, video)...
Ejemplos de escenas
- Noche de cine: disparador «Reproducción iniciada» en el Kodi del salón, tipos de medio Película y Otro vídeo → atenuar las luces del salón al 10 %. Disparador «Reproducción en pausa» → luces al 50 %. Disparador «Reproducción reanudada» → de nuevo al 10 %. Disparador «Reproducción detenida» → luces al 100 %.
- Timbre: cuando llaman → «Mostrar una notificación en Kodi» («Alguien en la puerta») y «Controlar la reproducción: pausa».
- Hora de dormir: a las 23:30 → «Leer el estado de Kodi», continuar solo si el estado es
stopped→ apagar el enchufe del televisor. - Nuevas descargas: cuando su gestor de descargas avisa de que ha terminado → «Actualizar la biblioteca» (vídeos).
No inicie una reproducción desde una escena disparada por «Reproducción iniciada»: se volvería a iniciar sin fin.
Solución de problemas
- «sin respuesta (apagado o control remoto desactivado)»: Kodi está apagado, o «Permitir el
control remoto vía HTTP» está desactivado, o la dirección o el puerto son incorrectos. Abra
http://<dirección>:8080en un navegador: debe aparecer la interfaz web de Kodi (o su petición de inicio de sesión). - «usuario o contraseña rechazados»: compruebe el usuario y la contraseña de Ajustes →
Servicios → Control. Un usuario vacío equivale a
kodi. - «contraseña rechazada por el servidor web, sin carátulas»: todo funciona por el puerto 9090, pero las carátulas pasan por el servidor web: corrija la contraseña.
- «Probar la conexión» indica «sin seguimiento en directo»: active «Permitir el control remoto desde aplicaciones de otros sistemas». El puerto 9090 de Kodi no se puede cambiar desde sus menús.
- No se encuentra nada en la red: active «Anunciar servicios a otros sistemas», o introduzca la dirección. La búsqueda requiere que Gladys esté en la misma red que Kodi (Docker en modo de red host, la instalación habitual).
- No hay carátula en el widget: Kodi solo sirve las carátulas de su biblioteca; un archivo abierto desde una carpeta no tiene. Tampoco se muestra una imagen de más de 300 KB.
- «Actualizar la biblioteca» no hace nada: Kodi solo recorre las fuentes cuyo tipo de contenido está definido (Vídeos → Archivos → la fuente → Establecer contenido).
Límites
- Tres Kodi como máximo.
- El puerto WebSocket es el 9090 (el de Kodi por defecto, solo modificable en
advancedsettings.xml). - Sin encendido ni apagado: Kodi no se despierta a través de su interfaz. Un Kodi apagado muestra «Apagado o inaccesible» y no dispara nada.
- Las imágenes (presentaciones) se ignoran; cuando suena música detrás de un vídeo, gana el vídeo.
- La carátula se muestra cuando Kodi la sirve en menos de 300 KB (Kodi guarda los pósteres en caché a 720 px).
- Sin relación con la Kodi Foundation (XBMC Foundation), propietaria de la marca Kodi.
Parámetros de configuración
Estos son los parámetros que Kodi te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conecte su Kodi | section | No | En Kodi, abra Ajustes, Servicios, Control y active «Permitir el control remoto vía HTTP» y «Permitir el control remoto desde aplicaciones de otros sistemas». Después pulse «Buscar Kodi en la red» más abajo, o introduzca su dirección. Hasta tres Kodi. |
| Dirección de Kodi | string | No | Dirección IP del equipo que ejecuta Kodi. Añada :puerto si su servidor web no usa el 8080. |
| Usuario | string | No | Del servidor web de Kodi. Vacío: kodi. |
| Contraseña | secret | No | Déjelo vacío si Kodi no la pide. |
| Kodi 2 (opcional) | section | No | Otro Kodi, configurado de la misma manera. |
| Dirección de Kodi 2 | string | No | |
| Usuario 2 | string | No | |
| Contraseña 2 | secret | No | |
| Kodi 3 (opcional) | section | No | Otro Kodi, configurado de la misma manera. |
| Dirección de Kodi 3 | string | No | |
| Usuario 3 | string | No | |
| Contraseña 3 | secret | No | |
| Opciones | section | No | Idioma de los nombres y textos que crea la integración (los nombres de las funciones se fijan al añadir el dispositivo). |
| Idioma | select | No |
Cómo instalar Kodi en Gladys
- En Gladys, abre Integraciones: Kodi aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-kodi:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-kodi.
Kodi requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Kodi es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación