Files
xtremobile/task.md
T
MichaelandClaude Opus 5 8d74bbb320 feat: XMLTV EPG fallback, Warm Cinema theme, background release
Align the Android app with xtremflow on three fronts.

EPG: add XmltvService, a streaming XMLTV parser (gunzip-aware, indexed to a
-3h/+18h window, JSON disk cache with a 6h TTL). XtreamServiceMobile now falls
back through the provider's xmltv.php, a user-supplied URL, then a community
guide whenever get_short_epg returns nothing. Channels are matched on
epg_channel_id first, then on a normalized name (accents, HD/FHD/4K suffixes,
"FR:" and "|FR|" prefixes). A streamId -> Channel index populated by
getLiveChannels supplies those keys, so no getShortEPG call site changed.
EPG requests are also funnelled through a 3-slot semaphore, as in xtremflow:
a 30-tile grid used to fire 30 parallel player_api.php calls, which rate-limited
panels answered with errors, emptying the guide for the whole screen.

Theme: port the Warm Cinema charter (ember/charcoal/cream, Fraunces + Karla)
into app_colors, app_theme and app_decorations. The 21 Apple TV colour names
already in use are kept as compatibility aliases. mobile_theme now derives from
AppTheme instead of duplicating its 390 lines.

Playback lifecycle: stop reacting to AppLifecycleState.inactive, which fires on
transient Android interruptions such as pulling down the notification shade and
was killing playback. Both engines now release on paused/hidden/detached via
_releasePlayback(): stream stopped, decoder released, timers cancelled, wakelock
dropped. An _isReleased latch keeps the watchdog and reconnect paths from
restarting a stream from the background.

Long-run stability: cancel the six player stream subscriptions on dispose, cap
demuxer-max-back-bytes at 8MB (mpv defaults to 50MiB, which combined with the
150MB readahead pushed the native heap toward an Android memory kill after a few
hours), rebuild on position only while the controls are visible, and dispose the
Lite player's focus nodes.

Startup: prewarmHost() pre-resolves DNS and opens then closes a bare TCP/TLS
socket before playback. No HTTP request is issued, so no provider connection
slot is consumed. Capped at 1.5s.

Verified: flutter analyze clean on all touched files; 19/19 tests, including a
run over a real 46MB/69802-programme dump (517 channels indexed in 1.1s, 5/5
name probes matched); flutter build apk --release succeeds.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 19:25:33 +02:00

3.5 KiB

Task: Alignement sur xtremflow — EPG XMLTV, thème, stabilité des flux

1. EPG — repli XMLTV quand le fournisseur ne répond pas

  • Nouveau lib/features/iptv/services/xmltv_service.dart : téléchargement, gunzip transparent, parse en flux (toXmlEvents), index réduit à une fenêtre -3 h / +18 h, cache disque JSON (TTL 6 h)
  • Chaîne de repli dans XtreamServiceMobile : get_short_epg → {dns}/xmltv.php du fournisseur → URL personnalisée → source communautaire (epgshare01 FR1)
  • Correspondance par epg_channel_id, puis par nom normalisé (accents, suffixes HD/FHD/4K, préfixes FR: / |FR|)
  • Index streamId → Channel alimenté par getLiveChannels : aucun site d'appel de getShortEPG n'a changé
  • Sémaphore EPG (3 requêtes max), comme xtremflow — une grille de 30 tuiles ne noie plus le panel et ne vide plus l'EPG de tout l'écran
  • Réglages : « EPG communautaire » (on/off) + « URL XMLTV personnalisée »

2. Thème — port de la charte « Warm Cinema » de xtremflow

  • app_colors.dart : palette ember/charbon/crème, alias de compatibilité conservés pour les 21 symboles Apple TV déjà utilisés
  • app_theme.dart : typo Fraunces (display) + Karla (UI), tokens spacing/radius/durations/curves alignés sur xtremflow
  • mobile_theme.dart : dérive désormais de AppTheme (échelle typo mobile) au lieu de dupliquer 390 lignes
  • app_decorations.dart : hexs Apple codés en dur remplacés par la palette

3. Lecture — arrêt en arrière-plan et tenue dans la durée

  • AppLifecycleState.inactive retiré du déclencheur d'arrêt : il se déclenchait au moindre volet de notifications
  • _releasePlayback() sur paused / hidden / detached — arrêt du flux, libération du décodeur, annulation des timers, wakelock coupé (les deux moteurs : native_player_screen et lite_player_screen)
  • Verrou _isReleased : watchdog et reconnexions ne peuvent plus relancer un flux depuis l'arrière-plan
  • Abonnements aux Stream du player stockés et annulés au dispose
  • demuxer-max-back-bytes plafonné à 8 Mo (défaut mpv : 50 Mio) — évite la dérive mémoire qui finissait en kill Android après plusieurs heures
  • setState de position limité aux moments où les contrôles sont visibles ; horloge ne reconstruit qu'au changement de minute
  • FocusNodes du lecteur Lite libérés au dispose

4. Vitesse de chargement

  • prewarmHost() : pré-résolution DNS + socket TCP/TLS ouvert puis fermé avant l'ouverture du flux (aucune requête HTTP, donc aucun slot de connexion consommé chez le fournisseur), plafonné à 1,5 s

Non retenu par l'utilisateur : décodage matériel VOD, réduction du probe, audio multicanal natif. Le profil de décodage reste inchangé.

Vérifications

  • flutter analyze : 0 erreur / 0 warning sur les fichiers touchés (3 warnings de code mort restants, déjà présents dans HEAD)
  • flutter test : 19/19 (18 unitaires + 1 sur un vrai dump)
  • Vrai dump epg_ripper_FR1.xml.gz (5,4 Mo gz / 46 Mo XML / 69 802 programmes) : 517 chaînes indexées en 1,1 s, 5/5 correspondances
  • flutter build apk --release → app-release.apk (94,3 Mo)

Non corrigé (pré-existant, hors périmètre) : erreurs d'analyse dans lib/core/utils/memory_profiler.dart et hive_encryption_benchmark.dart (orphelins, hors graphe d'import) et test/widget_test.dart.