Skip to content
vantaflowPublic

About

Le launcher Android TV complet qui reste fluide sur les petites box — accueil façon Google TV, recommandations, personnalisation poussée. Sans compte Google, sans pub.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Repository files navigation

Kairo

Le launcher Android TV complet… qui reste fluide sur les petites box.
Accueil épuré façon Google TV, recommandations de vos applis, personnalisation poussée — sans compte Google, sans pub, sans traqueur.

Dernière version Android TV 11+ Kotlin + Compose Code Downloader 5568887 APK ~3 Mo Site


Accueil de Kairo

Pourquoi Kairo ?

Les box Android TV d'entrée de gamme (2 Go de RAM, processeur 32 bits) rament sous Google TV, et les launchers alternatifs rapides sont souvent austères. Kairo vise les deux : tout ce qu'on attend d'un écran d'accueil moderne, mesuré et optimisé image par image sur une Mecool KM7 Plus (Android 14, 2 Go).

Mesuré sur la KM7 Plus Kairo
Temps médian par image en naviguant dans les recommandations 34 ms (85–97 ms avant optimisation)
Taille de l'appli ~3 Mo
Compte Google, pubs, collecte de données aucun

Fonctions

Accueil

  • Comme Google TV : favoris en tête, puis À suivre, puis une rangée de recommandations publiées par vos applis (YouTube, SmartTube, Ultra TV, TiviMate…) et une rangée d'applis (Récentes, « Toutes les applis », outils) en alternance.
  • Onglets comme Google TV : Pour vous, Films, Séries, Applis en haut à gauche ; à droite, boutons en icônes, température et heure.
  • Films et séries à voir (TMDB), dans tous les pays : Kairo repère le pays de la box et les plateformes qui y sont proposées (Netflix, Prime Video, Apple TV, Disney+, Shahid, Max, Canal+…), les rapproche des applis installées, puis affiche seulement ce qui est inclus dans vos abonnements (pas de location ni d'achat) : tendances, mieux notés, et une rangée par plateforme quand il y en a plusieurs. Catalogue mis à jour une fois par jour et gardé sur la box (l'accueil n'attend jamais le réseau). Fiche avec résumé, note et « Regarder sur » chaque appli où le titre est disponible.
  • Ma liste : un clic sur « + Ma liste » dans la fiche ; la rangée apparaît dans Pour vous, Films et Séries.
  • Reprendre : les applis qui ne publient pas leur « À suivre » dans Android (Apple TV, Prime Video, Shahid…) ont une carte « Reprendre » quand vous les avez ouvertes récemment. Un titre lancé depuis la fiche de Kairo y garde son affiche, et la vidéo en cours dans YouTube (ou toute appli qui l'annonce à Android) y apparaît avec son image et son titre. Apple TV n'annonce rien : sa carte garde la bannière de l'appli.

Reprendre : la vidéo YouTube en cours dans « À suivre »

  • Musique en cours : Spotify, Anghami, Deezer… sont traitées comme la radio : pastille « ♪ » sur l'accueil, petit lecteur (précédent, pause, suivant) et carte sur l'écran de veille. Demande une fois l'accès aux notifications (Réglages › Assistant de configuration).
  • Box avec tuner TV ou entrées HDMI : rangées Chaînes TV (logo, numéro, ouverture directe dans l'appli TV) et Entrées, affichées seulement si la box en a.
  • Fond « héros » : l'affiche du contenu sélectionné, floutée et fondue en dégradé, comme sur Google TV.
  • Heure synchronisée sur un serveur de temps (NTP), date et météo (Open-Meteo, position par IP ou ville).
  • Rangée sélectionnée calée sous l'en-tête : rien n'est jamais coupé en défilant.

Recommandations et fond héros

Personnalisation

  • Fonds : images Pixabay par thème (nature, ville, mer, espace…), dégradés ou couleurs unies.
  • 6 thèmes (Google TV, Bleu nuit, Ambre, Émeraude, Violet, Minimal) qui changent les couleurs des écrans, de l’en-tête et du panneau, ou un thème sur mesure : accent, contour et zoom au focus, arrondi et taille des tuiles, titres de rangées.
  • Ordre et visibilité des recommandations par appli et par rangée.

Télécommande

  • Navigation complète au D-pad, appui long ou touche Menu pour les actions d'une appli.
  • Touches Réglages (roue dentée) et Entrées de la télécommande Google TV reprises par Kairo : réglages de Kairo, et écran « Entrées et HDMI » (entrées de la box, résolution, son, HDMI-CEC).
  • Touches YouTube / Netflix / Prime Video / Disney+ réassignables vers n'importe quelle appli.
  • Kairo Remote : le téléphone devient télécommande, sans rien installer : scannez le QR code affiché par la box (Réglages › Télécommande sur téléphone) et la page s'ouvre dans le navigateur, iPhone ou Android.
    • Flèches, OK, Retour, Accueil, lecture, volume (appui maintenu = répétition, glisser sur le pavé).
    • Clavier : le texte va dans le champ ouvert sur la box, sinon il lance une recherche dans Kairo.
    • Applis : la liste avec icônes, un appui pour ouvrir.
    • Envoi de fichiers et d'APK : un APK s'installe (confirmation sur la télé), les autres fichiers vont dans Téléchargements › Kairo.
    • Réseau local seulement, lien protégé par un jeton (renouvelable), désactivé par défaut.

Kairo Remote : QR code sur la box

Accueil animé au premier lancement

  • Plein écran, fond vivant et pages qui glissent : bienvenue, puis uniquement les étapes qui manquent sur la box (recommandations, écran d'accueil, touches, mises à jour, écran de veille).
  • Chaque étape se coche toute seule une fois faite et passe à la suivante ; si la box refuse, la commande ADB exacte est affichée.
  • Choix du thème en direct, puis « Tout est prêt ! ». À revoir à tout moment dans Réglages › Assistant de configuration.
Bienvenue Une étape
Accueil animé : bienvenue Accueil animé : une étape
Choix du thème en direct Tout est prêt
Accueil animé : thème Accueil animé : fin

Réglages en panneau latéral

  • Assistant de configuration : ce qui est prêt, ce qui s'active d'un clic (recommandations, mises à jour, touches, écran de veille, écran d'accueil) et, si la box refuse, la commande ADB exacte.
  • Panneau à droite par-dessus l'accueil : les changements se voient en direct.
  • Réseau (Wi-Fi / Ethernet), raccourci HDMI-CEC et accès direct aux paramètres Android de la box.
  • DNS privé (DNS sur TLS) en un clic (Réglages › Réseau) : Automatique, Cloudflare, Google, Quad9, AdGuard, AdGuard Famille, Cloudflare Famille, Mullvad, Mullvad anti-pub. Appliqué à toute la box (autorisation à donner une fois par ADB : adb shell pm grant com.vantaflow.kairo android.permission.WRITE_SECURE_SETTINGS).
  • Profils (dont un profil enfant verrouillé par code), sauvegarde et restauration, nettoyage mémoire, mise à jour depuis GitHub.
Menu des réglages Section Thème
Menu des réglages Réglages du thème
DNS privé (DNS sur TLS)
DNS privé

Et aussi

  • Favoris à déplacer directement sur l'accueil, comme sur Google TV : appui long › Déplacer, puis ← →.
  • Toutes les applis, applis masquées, accès au Play Store.
  • Recherche dans les applis et les contenus, avec dictée vocale.
  • Écran de veille paramétrable (Réglages › Écran de veille) : photos du web par thème, vos photos (box et clés USB) ou dégradés de couleurs animés (6 palettes) ; durée, transition (fondu, fondu lent, zoom lent), heure et météo ; bouton Aperçu. Citation du jour sous l'heure (418 citations et proverbes, aucune répétition dans l'année). Si la radio joue, une carte radio s'affiche : ← → changent de radio, OK l'arrête, les autres touches réveillent la box.
Toutes les applications Recherche
Toutes les applications Recherche
Onglet Films Onglet Séries
Films Séries
Fiche d'un titre
Fiche
Rangées de recommandations Déplacer un favori
Rangées de recommandations Déplacer un favori
Écran de veille : dégradé animé Réglages de l'écran de veille
Écran de veille Réglages de l'écran de veille

Captures prises sur une Mecool KM7 Plus.

Outils

Un bouton Outils dans l'en-tête (menu) et une rangée Outils sous « Toutes les applis » (masquable dans Réglages › Affichage de l'accueil) :

  • Radio : les radios en direct du monde entier (annuaire libre radio-browser.info), le pays de l'utilisateur en premier, favoris (appui long), recherche. Lecteur plein écran (précédente, lecture / arrêt, suivante, favori) ; la radio continue sur l'accueil avec une pastille « ♪ » dans l'en-tête : un clic ouvre un petit lecteur (précédente, arrêt, suivante) ; la pastille disparaît à l'arrêt ; touches ⏮ ⏯ ⏭ de la télécommande ; une autre appli qui joue du son l'arrête.
  • Météo : maintenant, courbe des températures sur 24 h, 7 jours avec écart min / max ; lever et coucher du soleil, UV, pluie, vent et rafales, pression, nuages (← → change de jour).
  • Minuteur : mise en veille de la box (et de la télé par HDMI-CEC) après 15 min à 2 h ; un bandeau prévient 1 min avant, une touche ajoute 15 min. Nécessite le service Kairo (Accessibilité).
  • Nettoyeur : mémoire et stockage (clés USB comprises), « Tout optimiser » ferme les applis en arrière-plan et vide le cache de Kairo, applis les plus lourdes.
  • Bloqueur de pubs (Réglages › Bloqueur de pubs) : pubs et pistage bloqués dans toutes les applis et tous les sites, par un filtre DNS (AdGuard DNS) via un VPN local qui ne capte que le DNS (aucun effet sur le débit). Filtre « contenus adultes » en plus, automatique sur le profil enfant ; compteur des pubs bloquées. Si la box a déjà un DNS privé anti-pub, Kairo le détecte et ne lance rien. Les pubs intégrées aux vidéos YouTube ne passent pas par un serveur à part : pour YouTube sans pub, utilisez SmartTube.
  • Nettoyage automatique (actif par défaut, Réglages › Mémoire) : une appli laissée en arrière-plan plus de 30 min (15 min à 2 h, ou jamais) est fermée ; sous 25 % de mémoire libre, les applis en arrière-plan sont fermées, sauf la dernière utilisée. L'appli à l'écran et celles qui jouent du son ne sont jamais touchées.
Menu Outils Outils sur l'accueil
Menu Outils Outils
Radio Lecteur radio
Radio Lecteur radio
Petit lecteur radio (bulle ♪ de l'accueil) Recherche
Petit lecteur radio Recherche
Météo sur 7 jours Nettoyeur
Météo Nettoyeur
Bloqueur de pubs Écran de veille : citation du jour
Bloqueur de pubs Citation du jour
Écran de veille : radio en cours
Radio sur l'écran de veille

Nos applications, intégrées à Kairo

Kairo met en avant et installe les autres applis Vantaflow, et les intègre partout :

  • Rangée « Nos applications » sur l'accueil (désactivable) : les applis pas encore installées ou qui ont une mise à jour, installées en un clic depuis GitHub (avec progression), puis la rangée disparaît.
  • Accueil animé : page facultative « Nos applications » au premier lancement.
  • Réglages › Mise à jour : version installée, version publiée, installation ou mise à jour.
  • Recherche : « Chercher dans Ultra TV » et « Chercher dans Kairo Player » en tête des suggestions.
  • Accueil : « À suivre » et rangées publiées par Ultra TV et Kairo Player (vidéos récentes, reprise de lecture).
  • Kairo Remote : une vidéo ou une musique envoyée du téléphone s'ouvre directement dans Kairo Player.
Application Ce qu'elle fait
Kairo Player Vidéos, photos et musique de la box et des clés USB, reprise dans « À suivre ».
Ultra TV Lecteur IPTV : Xtream Codes et M3U, guide TV, replay, pause du direct, profils.

Nos applications au premier lancement

Kairo Player

L'appli compagnon pour lire vos vidéos, photos et musiques de la box et des clés ou disques USB (installation séparée : le launcher reste léger).

  • Accueil par rangées : Reprendre, Dossiers (avec le nom de la clé USB), vidéos et photos récentes, musique.
  • Lecteur Media3 (ExoPlayer) : MKV, MP4, sous-titres et pistes audio intégrés, ← → pour reculer / avancer de 10 s, OK pour pause, épisode suivant du dossier à la fin.
  • Reprise là où vous vous êtes arrêté, et la vidéo apparaît dans « À suivre » de Kairo (et de Google TV) avec sa vignette.
  • Photos plein écran, diaporama d'un appui sur OK. Mise à jour automatique quand une clé est branchée.
  • Ouvre aussi les vidéos envoyées depuis le téléphone avec Kairo Remote (Téléchargements › Kairo).

Installation : https://github.com/vantaflow/kairo/releases/latest/download/kairo-player.apk

Kairo Player Reprise dans « À suivre » de Kairo
Kairo Player À suivre

Comment rester fluide sur une petite box

Kairo est écrit en Kotlin avec Jetpack Compose et chaque écran a été profilé sur la box (traces système atrace) :

  • Build release R8 + profil de démarrage couvrant tout le code de Kairo : compilé à l'avance dès l'installation, même après une mise à jour par Downloader.
  • Mémoire rendue : quand la box manque de RAM, Kairo en arrière-plan libère ses images de tuiles pour l'appli en cours.
  • Fonds figés dans une texture : le fond d'écran et le fond « héros » ne sont redessinés que lorsqu'ils changent, jamais pendant la navigation.
  • Tuiles et cartes légères : zoom et contour lus uniquement au dessin, aucune recomposition au changement de focus ; une seule affiche décodée par contenu, en RGB 565.
  • Accessibilité Compose coupée : les box gardent toujours des services d'accessibilité actifs (télécommande, constructeur), ce qui faisait reparcourir tout l'écran à Compose à chaque défilement — environ 100 ms perdues par seconde.

Installation

  1. Dans Downloader sur la box, tapez le code 5568887 (ou l'adresse vantaflow.github.io/kairo/apk) : la dernière version se télécharge et s'installe. Lien direct : https://github.com/vantaflow/kairo/releases/latest/download/kairo.apk
  2. Ou installez-le par clé USB ou adb install kairo.apk.

Depuis la version 1.9.0, l'identifiant de Kairo est com.vantaflow.kairo (avant : com.tvhome.launcher). Une box qui avait une version antérieure installe la nouvelle à côté : sauvegardez vos réglages (Réglages › Sauvegarde), installez la 1.9.0, restaurez, puis désinstallez l'ancien Kairo.

  1. Ouvrez Kairo : l'accueil animé vous guide (écran d'accueil par défaut, recommandations, nos applications). Tout reste dans Réglages › Assistant de configuration.

Pour un réglage complet en une commande depuis un PC (autorisations, touches de la télécommande, écran de veille) :

scripts/deploy.sh <IP_DE_LA_BOX> --no-build   # avec l'APK placé dans build-remote/app-release.apk
Autorisations accordées par ADB (facultatif)
adb shell pm grant com.vantaflow.kairo com.android.providers.tv.permission.READ_EPG_DATA
adb shell pm grant com.vantaflow.kairo android.permission.READ_TV_LISTINGS
adb shell cmd role add-role-holder android.app.role.HOME com.vantaflow.kairo

READ_TV_LISTINGS est indispensable pour lire « À suivre » et les recommandations des autres applis.

Compiler

Prérequis : JDK 17, Gradle 8.7, SDK Android 34.

echo "PIXABAY_API_KEY=votre_clé" > secrets.properties   # facultatif : clé Pixabay intégrée
gradle :app:assembleRelease :player:assembleRelease

Sans clé, les fonds Pixabay restent disponibles en saisissant sa propre clé dans Réglages › Fond d'écran. Le dépôt contient aussi scripts/remote.py pour compiler sur un serveur distant (configuration dans remote.properties).

Vie privée

Kairo n'a ni compte, ni publicité, ni statistiques. Les seuls appels réseau : la météo (Open-Meteo, position approximative par IP via geojs / ipwho.is), les images Pixabay si vous les choisissez, l'heure NTP et la vérification des mises à jour sur GitHub.

Du même auteur

📺 Ultra TV — lecteur IPTV pour Android TV / Google TV, smartphone, tablette, Windows et Mac : Xtream Codes et M3U, guide TV, replay, pause du direct, profils. Ses recommandations s'affichent directement dans Kairo. → Site d'Ultra TV



Kairo — fait pour les box modestes et les gens exigeants.

Ce produit utilise l'API TMDB mais n'est ni approuvé ni certifié par TMDB (themoviedb.org).

About

Le launcher Android TV complet qui reste fluide sur les petites box — accueil façon Google TV, recommandations, personnalisation poussée. Sans compte Google, sans pub.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages