Saltar al contenido principal

Integración domótica Kodi, gratuita y de código abierto

Integración Kodi para Gladys Assistant

Siga y controle Kodi: lo que se reproduce, volumen, botones, escenas al empezar una película.

Ver en GitHubTodas las integraciones

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.3 o posterior (la versión 1.0 de la integración sigue disponible para Gladys 5.1 y 5.2).
  • 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 (kodi por 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.
  • 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​

  1. Instale la integración desde la tienda de Gladys y abra su pestaña Configuración.
  2. 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, o 192.168.1.40:8081 si el servidor web de Kodi no usa el puerto 8080.
  3. Si Kodi pide una contraseña, rellene el Usuario (vacío equivale a kodi) y la Contraseña del espacio, y guarde.
  4. Probar la conexión: una línea por Kodi, con su nombre, su versión y lo que está haciendo.
  5. 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.

Reproductor de música de Gladys 5.3​

Desde Gladys 5.3, la caja Música del panel es un verdadero reproductor: elija su Kodi y muestra lo que suena (carátula, título, artista, álbum; para un episodio: el episodio, la serie y la temporada; para una película: su título), una barra de progreso que se arrastra para avanzar, reproducir / pausa, anterior / siguiente, aleatorio, repetir, el volumen y el silencio.

  • Panel Música: la lupa de la caja recorre la biblioteca musical de Kodi (Artistas, Álbumes, Listas de reproducción, Favoritos, Archivos de sus fuentes) y busca en ella; un toque inicia una canción, un álbum, un artista o una lista, ahora mismo, después de la canción actual o al final de la lista. El mismo selector sirve a la acción de escena de Gladys Reproducir música en un altavoz (a las 7, iniciar la lista «Mañana» en el salón).
  • Cola: el icono de lista muestra la lista de reproducción de Kodi (la de música, o la de vídeo mientras suena un vídeo), con el elemento actual resaltado; un toque salta a él. Kodi conserva su lista tras una parada: Reproducir la vuelve a iniciar desde el principio.
  • «Ahora mismo» sustituye la lista de reproducción de música de Kodi y la inicia; «a continuación» y «al final» la amplían sin interrumpir nada.
  • Las carátulas las reduce el propio Kodi (300 px para el reproductor, 64 px para las listas) y las sirve la integración: el navegador nunca contacta con Kodi.
  • La función de texto «En reproducción» (Artista – Canción, «Nada en reproducción») se mantiene para sus escenas; la caja Música usa la nueva función «Título».

Kodi añadido antes de la versión 1.1: abra la pestaña Descubrir y pulse Actualizar en el dispositivo Kodi para recibir las nuevas funciones. Los botones Reproducir, Pausa, Anterior, Siguiente, el volumen y el silencio conservan su identificador: sus escenas y paneles siguen funcionando. Hasta esa actualización, el silencio sigue siendo un botón que alterna; después se ajusta (1 silencia, 0 activa el sonido): una escena que «pulsaba» Silencio ahora silencia en lugar de alternar.

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ónTipoContenido
ReproduccióntextoReproduciendo, En pausa, Detenido, Apagado o inaccesible
En reproduccióntextoPelícula (2024), Serie S01E02 – Título, Artista – Canción...
Tipo de mediotextoPelícula, Episodio, Música, Canal de TV, Vídeo, Ninguno
ProgresoporcentajePosición en el medio, 0 para una emisión en directo
Tiempo restanteminutosHasta el final del medio, 0 para una emisión en directo
Volumencontrol 0–100El volumen de Kodi, sigue al mando a distancia
Reproducir, PausabotonesReanudar, pausar
DetenerbotónDetiene la reproducción
Anterior, SiguientebotonesElemento anterior o siguiente de la lista de reproducción
SilenciointerruptorSilencia o activa el sonido
Estado de reproducciónreproductorEn pausa, reproduciendo, detenido; controlable
Título, Artista, ÁlbumreproductorLo que suena, para la caja Música (vacío al detenerse)
CarátulareproductorLa carátula de la biblioteca, servida por la integración
Duración, PosiciónreproductorEn segundos; escribir la posición avanza hasta ella
Aleatorio, RepetirreproductorModos de la lista de reproducción de Kodi; controlables

«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​

Para la música, la caja Música de Gladys (más arriba) es la primera opción. 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​

DisparadorCuándo
Reproducción iniciadaKodi inicia un medio cuando no se reproducía nada, o el siguiente de una lista
Reproducción en pausaKodi se pone en pausa
Reproducción reanudadaKodi reanuda tras una pausa
Reproducción detenidaLa 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ónQué hace
Controlar la reproducciónReproducir, pausa, reproducir/pausa, detener, siguiente, anterior
Ajustar el volumenVolumen de 0 a 100
Silenciar o activar el sonidoSilenciar, activar o alternar
Mostrar una notificación en KodiUn mensaje con título en la esquina de la pantalla
Reproducir un medioUn archivo, una carpeta o un flujo, por su ruta o URL tal como Kodi la conoce
Actualizar la bibliotecaKodi busca nuevos medios en sus fuentes de vídeo o de música
Leer el estado de KodiEstado, 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>:8080 en 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: Kodi solo sirve las carátulas de su biblioteca; un archivo abierto desde una carpeta no tiene. La integración pide a Kodi una versión de 300 px (comprobado en Kodi 21); no se muestra una imagen servida por encima de 300 KB.
  • La caja Música no muestra título ni carátula: ¿Kodi añadido antes de la versión 1.1? Pulse Actualizar en la pestaña Descubrir.
  • «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: la integración pide la versión de 300 px (comprobado en Kodi 21.2), que Kodi conserva además en su caché de miniaturas.
  • La búsqueda del panel Música es la de Kodi: sin distinguir mayúsculas, pero sí acentos («cafe» no encuentra «Café»). Abarca la música (artistas, álbumes, canciones, listas), no los vídeos ni las radios de la TV en directo.
  • Aleatorio y repetir solo existen durante una reproducción (Kodi los vincula al reproductor).
  • 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ámetroTipoObligatorioDescripción
Conecte su KodisectionNoEn 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 KodistringNoDirección IP del equipo que ejecuta Kodi. Añada :puerto si su servidor web no usa el 8080.
UsuariostringNoDel servidor web de Kodi. Vacío: kodi.
ContraseñasecretNoDéjelo vacío si Kodi no la pide.
Kodi 2 (opcional)sectionNoOtro Kodi, configurado de la misma manera.
Dirección de Kodi 2stringNo
Usuario 2stringNo
Contraseña 2secretNo
Kodi 3 (opcional)sectionNoOtro Kodi, configurado de la misma manera.
Dirección de Kodi 3stringNo
Usuario 3stringNo
Contraseña 3secretNo
OpcionessectionNoIdioma de los nombres y textos que crea la integración (los nombres de las funciones se fijan al añadir el dispositivo).
IdiomaselectNo

Cómo instalar Kodi en Gladys​

  1. En Gladys, abre Integraciones: Kodi aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-kodi:1.1.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-kodi.

Kodi requiere Gladys >=5.3.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.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en