Skip to content
pablocpasPublic

About

Cliente libre de RTVE Play para Android y Android TV

Topics

Resources

Stars

13 stars

Watchers

0 watching

Forks

Repository files navigation

OpenRTVE

OpenRTVE

Cliente libre de RTVE Play para Android, Android TV y cualquier navegador (iPhone, iPad, Mac, Windows, Linux…). Consulta y reproduce el catálogo público de vídeo de RTVE (televisión, directos y archivo) a través de sus interfaces HTTP, con una interfaz propia: Jetpack Compose en Android y Svelte en la web. La radio y los pódcasts quedan fuera a propósito: como en la app oficial, son cosa de RTVE Audio.

Dónde usarlo

Dispositivo Cómo
Android y Android TV App nativa: el APK de Releases
iPhone, iPad, ordenador y cualquier otro Web: openrtve.pages.dev, instalable como app (más abajo)

OpenRTVE no está afiliado a RTVE ni respaldado por ella. RTVE Play es una marca de la Corporación de Radio y Televisión Española.

Qué hace

  • Inicio, Buscar y Explorar: barra inferior Material 3 en el móvil y panel de navegación lateral en la TV. Explorar agrupa el menú de RTVE (temáticas, canales, canales temáticos e infantil) sin repetir canales, y los canales temáticos se ven y se reproducen como directos.

  • Portadas (principal y temáticas) con la presentación que dicta cada fila: carrusel destacado, pósters, cuadradas o apaisadas.

  • Fichas organizadas según los tipos de la API de RTVE, sin deducir nada del título:

    • una serie o programa muestra temporadas y capítulos paginados en el orden de RTVE Play, sus extras (fragmentos y avances) y similares; el botón grande reproduce, continúa o pasa al siguiente capítulo según el historial;
    • un contenedor (un ciclo de cine, una colección de documentales) es un catálogo: cada película o documental abre su propia ficha;
    • un vídeo o película lleva sinopsis y ficha técnica (reparto, dirección, idioma, disponibilidad) y el enlace a su programa o colección ("Más en Cine de siempre"). Debajo, solo lo que no está en la cabecera: los capítulos de su temporada si es un episodio, o similares si es una película o un documental.

    En el móvil, las colecciones van en pestañas Material 3; en la TV, la ficha sigue la página de detalles de Google TV, con una fila por sección.

  • Buscador con los filtros rápidos de la app oficial y resultados por bloque, paginados; categorías leídas de la configuración remota de RTVE.

  • Directos con logo del canal, "● Directo" y progreso de la emisión; los programados muestran su horario. Seguir viendo local, sin cuenta: tocar continúa; desde su menú se abre la ficha, se empieza desde el principio o se quita (con deshacer).

  • Mi lista, también local y sin cuenta: "+" junto a Reproducir en cada ficha, pestaña propia con lo guardado y "Quitar de Mi lista" con deshacer. En la TV, una pulsación larga de OK sobre cualquier tarjeta abre su menú (Mi lista y Ver ficha).

  • Reproductor Media3 apaisado a pantalla completa, con panel de ajustes (calidad, velocidad, audio, subtítulos), miniaturas al arrastrar, siguiente episodio con reproducción automática, ajuste de imagen, imagen en imagen, bloqueo, gestos (doble toque para saltar, deslizar para brillo y volumen), indicador de directo con ventana DVR y MediaSession.

  • DASH y HLS, con Widevine para el contenido protegido.

  • Enlaces de RTVE: play.rtve.es/pr|v|d/{id} y las URL web de rtve.es/play/videos/... abren la ficha o el directo; también desde "Compartir → OpenRTVE" en cualquier app.

  • Ajustes: imagen en imagen, calidad máxima, reproducción automática, subtítulos por defecto, borrado de caché y actualizaciones.

  • Se actualiza sola: al abrirla, avisa si hay una versión nueva en Releases y, con "Actualizar", la descarga, comprueba su SHA-256 y la instala encima (Android pide confirmación). Ver Actualizaciones.

  • Rápida y ligera: catálogo en caché con revalidación por ETag (la portada aparece al instante con la última copia); imágenes en las mismas variantes que pide la web oficial de RTVE, que su servicio ya tiene hechas y sirve al momento en vez de redimensionarlas al vuelo; caché de imágenes ajustada a la cuota que Android da a la app; un solo cliente HTTP/2 para catálogo, imágenes y vídeo, y Baseline Profile para un arranque en frío rápido. Allowlist estricta de hosts para la API y las imágenes.

Todo se deduce de los feeds públicos de RTVE: no hay listas compiladas de canales, categorías ni filtros.

Capturas

Móvil

Inicio Explorar Buscar
Inicio en móvil Explorar en móvil Resultados de búsqueda en móvil
Ficha de película Ficha de programa
Ficha de película en móvil Ficha de programa en móvil

Reproductor en móvil, en horizontal
Reproductor en horizontal

Android TV

Catálogo Fichas y reproducción
Inicio en Android TV
Inicio
Ficha de programa en Android TV
Ficha de programa
Explorar en Android TV
Explorar
Ficha de película en Android TV
Ficha de película
Buscar en Android TV
Buscar
Reproductor en Android TV
Reproductor

Web (móvil y escritorio)

Móvil: Inicio Móvil: ficha Móvil: Mi lista
Inicio de la web en el móvil Ficha de programa en la web, en el móvil Mi lista en la web, en el móvil
Escritorio: Inicio Escritorio: ficha
Inicio de la web en el escritorio Ficha de programa en la web, en el escritorio

Instalar en Android

Descarga el APK de la sección Releases e instálalo en el móvil o en la TV (en Android TV, por ejemplo con Downloader o adb install). La app detecta si está en una TV y abre la interfaz de TV aunque el launcher lance la de móvil.

Actualizaciones

Desde la 0.7.1, la app consulta la última versión publicada en GitHub al abrirla (como mucho cada 6 horas) y, si hay una nueva, ofrece actualizar: descarga el APK de Releases, comprueba su tamaño y su SHA-256 y lo instala con el instalador del sistema, que pide confirmación (la primera vez, también permiso para instalar apps de OpenRTVE). Los datos se conservan. Si se elige "Más tarde", esa versión no se vuelve a ofrecer en tres días.

Es la única conexión que no tiene que ver con ver RTVE: una petición a api.github.com y, al actualizar, la descarga desde GitHub. Se puede apagar en Ajustes → Avisar de versiones nuevas, y Ajustes → Buscar actualizaciones comprueba al momento.

Enlaces: en Android 12 o superior, abrir un enlace rtve.es directamente en OpenRTVE requiere activarlo en Ajustes → Aplicaciones → OpenRTVE → Abrir por defecto (RTVE no publica la verificación de dominio para terceros). La vía "Compartir → OpenRTVE" funciona siempre.

Web

openrtve.pages.dev: la misma app para todo lo que no es Android (iPhone, iPad, Mac, Windows, Linux, Chromebook), sin instalar nada. Comparte con Android las reglas de clasificación, el orden de episodios, las secciones de las fichas, "Seguir viendo" y "Mi lista": no es una versión recortada.

Instalarla como app

Es una PWA: instalada se abre a pantalla completa, con su icono, y arranca sin red con lo último que se vio.

Dónde Cómo
iPhone y iPad (Safari) Compartir → Añadir a pantalla de inicio
Android (Chrome) Menú ⋮ → Instalar aplicación (o Añadir a pantalla de inicio)
Ordenador (Chrome, Edge, Brave) Icono de instalar en la barra de direcciones
Mac (Safari 17 o posterior) Archivo → Añadir al Dock

En Firefox de escritorio se usa como una web normal: Firefox no instala PWA.

Qué incluye

  • Inicio, Buscar, Explorar y Mi lista en la barra inferior del móvil (Ajustes, con el engranaje de arriba en Inicio y Explorar, como en la app) y en un panel lateral en pantallas anchas; fichas de programa y de vídeo con sus pestañas; "Seguir viendo".
  • Reproductor con calidad, velocidad, audio y subtítulos, miniaturas al arrastrar, siguiente episodio, imagen en imagen, pantalla completa (apaisada en Android; en iPhone, la del propio sistema) y doble toque a los lados para saltar 10 s. Con teclado: espacio o K reproduce y pausa, ← → (o J L) saltan 10 s, ↑ ↓ volumen, F pantalla completa, M silencio, C subtítulos, N siguiente episodio e I imagen en imagen.
  • Enlaces de RTVE: en Android, Compartir → OpenRTVE con la web instalada abre la ficha, como en la app.
Navegador Contenido protegido
Chrome, Edge, Firefox, Brave (escritorio y Android) Widevine
Safari (iPhone/iPad con iOS 17.1 o posterior, Mac) Variante sin cifrar que RTVE publica para dispositivos sin Widevine (misma calidad)

Privacidad

Sin cuenta ni cookies de seguimiento. "Seguir viendo", "Mi lista" y los ajustes se guardan solo en ese navegador: no se sincronizan con otros dispositivos ni con la app de Android. El catálogo, las imágenes, el vídeo y las licencias van directos del navegador a RTVE. Por el servidor de la web pasan las recomendaciones de RTVE (Similares, búsquedas predefinidas y rankings), que RTVE solo sirve a su propio dominio, y las métricas agregadas de reproducción.

Estas métricas suman reproducciones, llegadas al final y tiempo por contenido y día en una base privada de Cloudflare. No guardan IP ni identificadores de usuario y respetan DNT y Global Privacy Control. El aviso inicial y Ajustes informan del tratamiento; su funcionamiento y conservación se detallan en Métricas de reproducción.

La web está en web/: cómo desarrollarla, probarla y publicar tu propia copia, en su README.

Compilar

Esto es la app de Android; la web se compila aparte (ver web/README.md). Con el SDK de Android instalado:

./gradlew assembleDebug          # APK de depuración
./gradlew testDebugUnitTest lintDebug

Tests

  • ./gradlew testDebugUnitTest: tests JVM (parser de los feeds, repositorio y caché, cliente HTTPS, resolución de reproducción y de enlaces, historial y ViewModels). Corren sin emulador y son los que ejecuta la CI.
  • ./gradlew connectedDebugAndroidTest: tests de Compose de la portada, la búsqueda y las fichas de programa y de vídeo (en móvil y en TV, con el mando) contra un repositorio falso, sin red; también prueban la sesión de reproducción con ExoPlayer, un archivo local y tokens controlados. Necesitan un emulador o dispositivo conectado (ANDROID_SERIAL=emulator-5554 si hay varios); al terminar, Gradle desinstala la app de ese dispositivo.

Los fakes y los contratos de recuperación de red, caché y búsqueda compartidos por ambas capas están en app/src/sharedTest.

Sin SDK en el host, con Docker:

docker build --output type=local,dest=build/docker .

El APK queda en build/docker/openrtve-debug.apk. La imagen fija Android Command-line Tools por versión y SHA-256, instala API 37 y Build Tools 36, y ejecuta tests, lint y assembleDebug.

Release

./gradlew assembleRelease

Si existe keystore.properties en la raíz (storeFile, storePassword, keyAlias, keyPassword) el APK se firma con esa clave; si no, con la de depuración para que siga siendo instalable. Keystore y propiedades están en .gitignore y .dockerignore: guarda una copia, sin esa clave no se pueden publicar actualizaciones sobre la app instalada.

Baseline Profile

El release incluye un Baseline Profile (app/src/release/generated/baselineProfiles/) que ART usa al instalar para precompilar los caminos calientes: arranque en frío y primeros scrolls más rápidos en cualquier dispositivo. Se regenera con un emulador o móvil conectado (imagen google_apis o aosp, con adb root):

./gradlew :app:generateBaselineProfile

Diseño del código

Un único módulo app; los paquetes separan responsabilidades que ya tienen comportamiento:

  • data: cliente HTTPS sobre OkHttp, parser JSON tolerante, caché y repositorio;
  • domain: modelos, tipos editoriales de RTVE (MediaClassification), allowlist de hosts y política de reproducción;
  • ui: navegación (una pila por pestaña y Ajustes global), un ViewModel por pantalla, el estado que comparten móvil y TV (secciones de las fichas, paginación, textos);
  • ui/mobile y ui/tv: los dos árboles de interfaz, que comparten todo lo demás;
  • playback: ExoPlayer, MediaSessionService, controles y gestos.

La web (web/) es un proyecto aparte en Svelte 5, TypeScript y Vite, con Shaka Player: porta la misma lógica de dominio (clasificación, orden de episodios, secciones de las fichas, política de reproducción) en vez de compartir código.

No se añadirán módulos Gradle, base de datos ni framework de inyección hasta que una función real los justifique. Las decisiones se amplían en docs/architecture.md.

Documentación de interoperabilidad

Estos documentos describen contratos HTTP públicos y comportamiento observado. El repositorio no incorpora código decompilado, material gráfico de la aplicación original, credenciales, claves de firma ni licencias DRM.

Agradecimientos

El diseño de la portada, las fichas y el reproductor se inspira en Findroid; el código es propio.

Licencia

GPL-3.0.

About

Cliente libre de RTVE Play para Android y Android TV

Topics

Resources

Stars

13 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages