freeflix-cli 2.1.2__tar.gz → 2.3.0__tar.gz

{freeflix_cli-2.1.2 → freeflix_cli-2.3.0}/CHANGELOG.md

@@ -1,5 +1,65 @@
 # Changelog
 
+## 2.3.0
+
+- **Match** : la chaîne est affichée entre parenthèses **devant** le match,
+  avec un badge court (`beIN SPORTS 1..4` → `B1..B4`), ex.
+  `(B4) ● LIVE 20:45 · Toulouse VS Strasbourg`.
+- **Qualités Match** : chaque ligne affiche désormais la résolution, le débit
+  minimum estimé et la consommation horaire estimée, ex.
+  `HD (1080p) · ≥ 5.0 Mbps · ~2.25 Go/h`, `SD (720p) · ≥ 2.5 Mbps · ~1.13 Go/h`,
+  `Low (480p) · ≥ 1.0 Mbps · ~0.45 Go/h` ; `Auto` reste en bas.
+- 604 tests au vert, ruff OK.
+
+## 2.2.2
+
+- Menus **qualité** et **choix du lecteur** en plein écran : souris alignée
+  (survol + clic) sur Linux et Windows.
+- **Anime4K désactivé par défaut** : activation explicite par l'utilisateur
+  (`CTRL+1` / `CTRL+2`, `CTRL+0` pour couper), conseil affiché en bas de mpv
+  pendant 5 s, migration des anciennes configs sans toucher aux shaders perso.
+- Entrée du menu principal renommée **Films, Séries & Anime** (traduite) ;
+  la liste des providers et son fonctionnement restent inchangés.
+- **Configs lecteurs isolées** : mpv utilise toujours son dossier dédié
+  (`--config-dir`, sinon `--no-config`) ; VLC est lancé avec
+  `--ignore-config --no-media-library --no-plugins-cache`. Les réglages
+  personnels de la machine ne sont ni lus ni modifiés.
+- Derniers correctifs Windows/mise à jour (ancrage console, VT input, redémarrage
+  par nouveau processus, recherche uv/pipx hors PATH).
+- 602 tests au vert, ruff OK.
+
+## 2.2.1
+
+- **Compatibilité Windows** :
+  - ancrage souris des menus inline via `GetConsoleScreenBufferInfo`
+    (fini les clics décalés) ;
+  - activation VT input avec `ENABLE_EXTENDED_FLAGS` pour que Windows
+    Terminal transmette vraiment les rapports SGR ;
+  - écran des qualités en plein écran, ancrage fiable sur tous les OS ;
+  - redémarrage après mise à jour via un nouveau processus sur Windows
+    (`os.execv` n'est pas fiable avec un interpréteur Python verrouillé).
+- **Mises à jour** : correction de la comparaison de version en mode
+  source, détection `uv` resserrée, commande de mise à jour adaptée à
+  l'installeur réel (uv/pipx/pip).
+- VLC : lecture par **ffmpeg → TS** comme mpv (plus de fin de playlist
+  HLS), timestamps normalisés, audio calé.
+- 600 tests + tests Windows dédiés au vert, ruff OK.
+
+## 2.2.0
+
+- **Nouvel onglet Match** dans le menu principal : matchs de football du
+  catalogue YacineTV, à l'heure du Cameroun (UTC+1), avec badge `LIVE`,
+  à venir et terminés.
+- Qualités HD/SD/Low + **Auto** (meilleure disponible), choix du lecteur
+  **mpv / VLC** mémorisé, souris en clic seul sur les qualités.
+- Noms d'équipes et de compétitions **traduits dynamiquement** en français
+  ou anglais (cache local, aucun mapping en dur).
+- Flux live servis par un mini-proxy HLS local : en-têtes UTF-8 exacts et
+  segments `.php/.pdf` réécrits pour mpv/VLC.
+- mpv en direct : cache mémoire 3 s, démarrage au bord du live, plus de
+  cache disque de 30 min.
+- 598 tests au vert, ruff OK.
+
 ## 2.1.2
 
 - **Téléchargements Vidzy / fsvid / uqload réparés** : l'URL passée à yt-dlp

{freeflix_cli-2.1.2 → freeflix_cli-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: freeflix-cli
-Version: 2.1.2
+Version: 2.3.0
 Summary: Watch movies, series, and anime from your terminal — multi-language, multi-source, no browser required. A maintained fork of autoflix-cli.
 Project-URL: Homepage, https://github.com/freedy237/freeflix-cli
 Project-URL: Repository, https://github.com/freedy237/freeflix-cli.git
@@ -49,7 +49,7 @@ Description-Content-Type: text/markdown
 
 <p align="center">
   <b>🎬 Movies · 📺 Series · 🍿 Anime (VF / VOSTFR / VO)</b><br>
-  <sub>mpv-powered · Anime4K upscaling · downloads · resume · AniList sync</sub>
+  <sub>mpv/VLC-powered · live football · Anime4K opt-in · downloads · resume · AniList sync</sub>
 </p>
 
 <p align="center">
@@ -65,13 +65,15 @@ Description-Content-Type: text/markdown
 - **Everything, always up to date** — anime (Anime-Sama, HiAnime,
   GoldenAnime), films & series (GoldenMS, Coflix, French-Stream, YTS/EZTV),
   in **French (VF/VOSTFR)** or **VO**.
-- **Live planning & Nouveautés** — the Anime-Sama weekly schedule, and a feed
-  of new episodes for the shows you follow.
+- **Live planning, Match & Nouveautés** — the Anime-Sama weekly schedule, live
+  football (YacineTV, Cameroon time, HD/SD/Low + Auto), and a feed of new
+  episodes for the shows you follow.
 - **Actually nice to use** — poster previews in the terminal (chafa), breadcrumb
   navigation, `/` to filter, `Esc` to go back anywhere, `?` for help.
 - **Download & keep** — pick a quality, batch a whole season into its own folder,
   resume interrupted downloads, see ✓ watched / ▸ resume / ⬇ downloaded badges.
-- **Crisp picture** — Anime4K GPU upscaling pre-tuned, one keypress to toggle.
+- **Crisp picture on demand** — Anime4K GPU upscaling pre-bundled but **off by
+  default**; enable it with `CTRL+1` (max) or `CTRL+2` (light).
 - **Optional AniList sync** — your progress updates automatically as you watch.
 
 ---
@@ -87,7 +89,13 @@ Description-Content-Type: text/markdown
 - **Daily new-episode notifications** via systemd timer + libnotify ;
 - A **Nyaa torrent provider** (downloads via aria2 BitTorrent) ;
 - A **Local Downloads browser** in the home menu ;
-- **Anime4K** shaders pre-bundled (S by default, VL with CTRL+1, off with CTRL+0) ;
+- **Live football Match** (YacineTV) : schedule in Cameroon time, LIVE badges,
+  HD/SD/Low + Auto, mpv or VLC;
+- **Anime4K** shaders pre-bundled but **opt-in** (CTRL+1 max, CTRL+2 light,
+  CTRL+0 off), with an OSD hint at playback start;
+- **Player configs isolated** : mpv uses a dedicated `--config-dir` (or
+  `--no-config`), VLC runs with `--ignore-config`; your machine's own player
+  settings are never read or modified;
 - **French localisation** of the whole UI (auto-switched based on language pref) ;
 - Multi-mirror portal fallback + `website_origin` caching (24 h TTL) ;
 - Multiple **bug fixes** : 403 on `/catalogue/?search=` (animes-sama.fr refactor), double-slash legacy URLs in history, settings-menu exit loop, ffmpeg infinite-reconnect at byte 1506, Videasy/Vidlink Referer not propagated, history resume silent-failure, and more.
@@ -113,10 +121,13 @@ Description-Content-Type: text/markdown
 | 🆕 | **Nouveautés** : new episodes of the shows you follow, cleared once watched |
 | 🖱 | **Full mouse control** : hover, click, wheel, right-click back, clickable pagination |
 | 🎨 | **Cinema Noir** (2.0) design system, 12 themes, reduced-motion support |
+| ⚽ | **Match** : live football from YacineTV, Cameroon time, HD/SD/Low + Auto, mpv/VLC |
+| 🎬 | **Browse Films, Séries & Anime** : the provider list, grouped as before |
 | 🎮 | **4 player backends** : mpv, VLC, browser, download-only |
 | 🇫🇷 | **French UI** : the whole CLI is in French when language is set to FR |
 | 🛡 | **Anti-crash mpv config** : ytdl-hook off, gpu renderer, no infinite reconnect |
-| 🎨 | **Anime4K** pre-bundled with runtime toggle CTRL+1 / CTRL+0 |
+| 🎨 | **Anime4K** pre-bundled, **off by default** — CTRL+1 max, CTRL+2 light, CTRL+0 off |
+| 🔒 | **Player configs isolated** — global mpv/VLC settings untouched |
 | 🩺 | **`freeflix --doctor`** system diagnostic (check deps, config, network) |
 | 🔄 | **Startup updater** : asks yes/no, upgrades with the same installer (uv/pipx/pip), reloads |
 
@@ -234,12 +245,19 @@ freeflix
 
 That's it. The menu walks you through everything.
 
+- **Films, Séries & Anime** opens the provider list (unchanged grouping).
+- **Match** shows live/upcoming football with kick-off in Cameroon time
+  (UTC+1); pick a match, then HD/SD/Low or **Auto**, then mpv or VLC.
+- Player settings are isolated: FreeFlix never edits your global mpv/VLC
+  configuration.
+
 ### Common keyboard shortcuts in mpv
 
 | Key | Action |
 |---|---|
-| **CTRL + 1** | Enable Anime4K Mode A_VL |
-| **CTRL + 0** | Disable Anime4K |
+| **CTRL + 1** | Enable Anime4K Mode A_VL (max) |
+| **CTRL + 2** | Enable Anime4K Mode A_S (light) |
+| **CTRL + 0** | Disable Anime4K (default) |
 | **`#`** | Cycle audio track |
 | **`j`** | Cycle subtitle track |
 | **`_`** (Shift + `-`) | Cycle video track |

{freeflix_cli-2.1.2 → freeflix_cli-2.3.0}/README.md

@@ -17,7 +17,7 @@
 
 <p align="center">
   <b>🎬 Movies · 📺 Series · 🍿 Anime (VF / VOSTFR / VO)</b><br>
-  <sub>mpv-powered · Anime4K upscaling · downloads · resume · AniList sync</sub>
+  <sub>mpv/VLC-powered · live football · Anime4K opt-in · downloads · resume · AniList sync</sub>
 </p>
 
 <p align="center">
@@ -33,13 +33,15 @@
 - **Everything, always up to date** — anime (Anime-Sama, HiAnime,
   GoldenAnime), films & series (GoldenMS, Coflix, French-Stream, YTS/EZTV),
   in **French (VF/VOSTFR)** or **VO**.
-- **Live planning & Nouveautés** — the Anime-Sama weekly schedule, and a feed
-  of new episodes for the shows you follow.
+- **Live planning, Match & Nouveautés** — the Anime-Sama weekly schedule, live
+  football (YacineTV, Cameroon time, HD/SD/Low + Auto), and a feed of new
+  episodes for the shows you follow.
 - **Actually nice to use** — poster previews in the terminal (chafa), breadcrumb
   navigation, `/` to filter, `Esc` to go back anywhere, `?` for help.
 - **Download & keep** — pick a quality, batch a whole season into its own folder,
   resume interrupted downloads, see ✓ watched / ▸ resume / ⬇ downloaded badges.
-- **Crisp picture** — Anime4K GPU upscaling pre-tuned, one keypress to toggle.
+- **Crisp picture on demand** — Anime4K GPU upscaling pre-bundled but **off by
+  default**; enable it with `CTRL+1` (max) or `CTRL+2` (light).
 - **Optional AniList sync** — your progress updates automatically as you watch.
 
 ---
@@ -55,7 +57,13 @@
 - **Daily new-episode notifications** via systemd timer + libnotify ;
 - A **Nyaa torrent provider** (downloads via aria2 BitTorrent) ;
 - A **Local Downloads browser** in the home menu ;
-- **Anime4K** shaders pre-bundled (S by default, VL with CTRL+1, off with CTRL+0) ;
+- **Live football Match** (YacineTV) : schedule in Cameroon time, LIVE badges,
+  HD/SD/Low + Auto, mpv or VLC;
+- **Anime4K** shaders pre-bundled but **opt-in** (CTRL+1 max, CTRL+2 light,
+  CTRL+0 off), with an OSD hint at playback start;
+- **Player configs isolated** : mpv uses a dedicated `--config-dir` (or
+  `--no-config`), VLC runs with `--ignore-config`; your machine's own player
+  settings are never read or modified;
 - **French localisation** of the whole UI (auto-switched based on language pref) ;
 - Multi-mirror portal fallback + `website_origin` caching (24 h TTL) ;
 - Multiple **bug fixes** : 403 on `/catalogue/?search=` (animes-sama.fr refactor), double-slash legacy URLs in history, settings-menu exit loop, ffmpeg infinite-reconnect at byte 1506, Videasy/Vidlink Referer not propagated, history resume silent-failure, and more.
@@ -81,10 +89,13 @@
 | 🆕 | **Nouveautés** : new episodes of the shows you follow, cleared once watched |
 | 🖱 | **Full mouse control** : hover, click, wheel, right-click back, clickable pagination |
 | 🎨 | **Cinema Noir** (2.0) design system, 12 themes, reduced-motion support |
+| ⚽ | **Match** : live football from YacineTV, Cameroon time, HD/SD/Low + Auto, mpv/VLC |
+| 🎬 | **Browse Films, Séries & Anime** : the provider list, grouped as before |
 | 🎮 | **4 player backends** : mpv, VLC, browser, download-only |
 | 🇫🇷 | **French UI** : the whole CLI is in French when language is set to FR |
 | 🛡 | **Anti-crash mpv config** : ytdl-hook off, gpu renderer, no infinite reconnect |
-| 🎨 | **Anime4K** pre-bundled with runtime toggle CTRL+1 / CTRL+0 |
+| 🎨 | **Anime4K** pre-bundled, **off by default** — CTRL+1 max, CTRL+2 light, CTRL+0 off |
+| 🔒 | **Player configs isolated** — global mpv/VLC settings untouched |
 | 🩺 | **`freeflix --doctor`** system diagnostic (check deps, config, network) |
 | 🔄 | **Startup updater** : asks yes/no, upgrades with the same installer (uv/pipx/pip), reloads |
 
@@ -202,12 +213,19 @@ freeflix
 
 That's it. The menu walks you through everything.
 
+- **Films, Séries & Anime** opens the provider list (unchanged grouping).
+- **Match** shows live/upcoming football with kick-off in Cameroon time
+  (UTC+1); pick a match, then HD/SD/Low or **Auto**, then mpv or VLC.
+- Player settings are isolated: FreeFlix never edits your global mpv/VLC
+  configuration.
+
 ### Common keyboard shortcuts in mpv
 
 | Key | Action |
 |---|---|
-| **CTRL + 1** | Enable Anime4K Mode A_VL |
-| **CTRL + 0** | Disable Anime4K |
+| **CTRL + 1** | Enable Anime4K Mode A_VL (max) |
+| **CTRL + 2** | Enable Anime4K Mode A_S (light) |
+| **CTRL + 0** | Disable Anime4K (default) |
 | **`#`** | Cycle audio track |
 | **`j`** | Cycle subtitle track |
 | **`_`** (Shift + `-`) | Cycle video track |

{freeflix_cli-2.1.2 → freeflix_cli-2.3.0}/config/mpv.conf

@@ -82,19 +82,12 @@ screenshot-directory=~/Pictures/mpv
 screenshot-format=png
 screenshot-template='%F-%P'
 
-# ─── Anime4K : Mode A_S (Small) par défaut — équilibre GPU ──
-# 3 niveaux dispos via les keybinds dans input.conf :
-#   CTRL+1 → Mode A_VL (Very Lite — qualité max, GPU le plus lourd)
-#   CTRL+2 → Mode A_S  (Small — défaut, ~3× moins de GPU)
+# ─── Anime4K : DÉSACTIVÉ au démarrage (choix explicite de l'utilisateur) ──
+# Raccourcis (input.conf) :
+#   CTRL+1 → Mode A_VL (qualité max, GPU le plus lourd)
+#   CTRL+2 → Mode A_S  (Small, plus léger)
 #   CTRL+0 → OFF
-# Le S garde quand même le CNN + Restore, juste avec un réseau plus
-# petit. Sur un GPU intégré, on passe d'un drop FPS visible à fluide.
-glsl-shaders="~~/shaders/Anime4K_Clamp_Highlights.glsl:~~/shaders/Anime4K_Restore_CNN_S.glsl:~~/shaders/Anime4K_Upscale_CNN_x2_S.glsl"
-
-# Auto-désactive Anime4K quand la source est déjà ≥ 1080p — pas
-# de bénéfice à upscaler 1080→2160 sur ce hardware, et ça mange du GPU
-# pour rien.
-[anime4k-skip-high-res]
-profile-cond=p["video-params/h"] ~= nil and p["video-params/h"] >= 1080
-profile-restore=copy-equal
-glsl-shaders=
+# Rien n'est chargé automatiquement : les vidéos (sport, films…) démarrent
+# sans surcoût GPU. À activer à la demande.
+osd-playing-msg="Anime4K OFF · CTRL+1 max · CTRL+2 léger · CTRL+0 off"
+osd-duration=5000

{freeflix_cli-2.1.2 → freeflix_cli-2.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "freeflix-cli"
-version = "2.1.2"
+version = "2.3.0"
 description = "Watch movies, series, and anime from your terminal — multi-language, multi-source, no browser required. A maintained fork of autoflix-cli."
 readme = "README.md"
 requires-python = ">=3.9.2"

{freeflix_cli-2.1.2 → freeflix_cli-2.3.0}/src/freeflix_cli/cli_utils.py

@@ -603,6 +603,7 @@ def _enable_windows_vt() -> bool:
         STD_INPUT_HANDLE = -10
         ENABLE_VIRTUAL_TERMINAL_PROCESSING = 0x0004
         ENABLE_VIRTUAL_TERMINAL_INPUT = 0x0200
+        ENABLE_EXTENDED_FLAGS = 0x0080
 
         h = k32.GetStdHandle(STD_OUTPUT_HANDLE)
         if not h or h == wintypes.HANDLE(-1).value:
@@ -626,9 +627,11 @@ def _enable_windows_vt() -> bool:
         if not k32.GetConsoleMode(hi, ctypes.byref(imode)):
             return _VT_READY
         if not (imode.value & ENABLE_VIRTUAL_TERMINAL_INPUT):
-            if not k32.SetConsoleMode(
-                hi, imode.value | ENABLE_VIRTUAL_TERMINAL_INPUT
-            ):
+            # Windows requires extended flags (and quick-edit off) for VT
+            # input; without it msvcrt never sees SGR mouse reports.
+            new_mode = (imode.value | ENABLE_VIRTUAL_TERMINAL_INPUT
+                        | ENABLE_EXTENDED_FLAGS)
+            if not k32.SetConsoleMode(hi, new_mode):
                 return _VT_READY
 
         _VT_READY = True
@@ -647,9 +650,13 @@ def _mouse_write(seq: str) -> None:
 
 
 def _mouse_off() -> None:
+    """Always send the disable sequence.
+
+    The terminal (notably Windows VT input) can still be in mouse mode even
+    when our flag says otherwise after a nested Live/reader; skipping the OFF
+    sequence leaves the user's terminal printing SGR reports.
+    """
     global _mouse_active
-    if not _mouse_active:
-        return
     _mouse_active = False
     _mouse_write(_MOUSE_OFF)
 
@@ -739,7 +746,39 @@ def _cursor_row(timeout: float = 0.15):
     """
     import sys
     try:
-        if os.name == "nt" or not sys.stdin.isatty():
+        if os.name == "nt":
+            # Windows has no DSR/select; GetConsoleScreenBufferInfo gives the
+            # real cursor row, so inline menus keep accurate click coordinates.
+            try:
+                import ctypes
+                from ctypes import wintypes
+
+                class COORD(ctypes.Structure):
+                    _fields_ = [("X", wintypes.SHORT), ("Y", wintypes.SHORT)]
+
+                class SMALL_RECT(ctypes.Structure):
+                    _fields_ = [("Left", wintypes.SHORT),
+                                ("Top", wintypes.SHORT),
+                                ("Right", wintypes.SHORT),
+                                ("Bottom", wintypes.SHORT)]
+
+                class CONSOLE_SCREEN_BUFFER_INFO(ctypes.Structure):
+                    _fields_ = [("dwSize", COORD),
+                                ("dwCursorPosition", COORD),
+                                ("wAttributes", wintypes.WORD),
+                                ("srWindow", SMALL_RECT),
+                                ("dwMaximumWindowSize", COORD)]
+
+                k32 = ctypes.WinDLL("kernel32", use_last_error=True)
+                handle = k32.GetStdHandle(-11)
+                info = CONSOLE_SCREEN_BUFFER_INFO()
+                if not k32.GetConsoleScreenBufferInfo(
+                        handle, ctypes.byref(info)):
+                    return None
+                return int(info.dwCursorPosition.Y) + 1
+            except Exception:
+                return None
+        if not sys.stdin.isatty():
             return None
         import select as _sel
         import termios
@@ -1539,7 +1578,8 @@ def select_from_list(options: list[str], prompt: str, default_index: int = 0,
                      top=None, flush_input: bool = False,
                      esc_selects_last: bool = True,
                      clear_on_back: bool = True,
-                     inline: bool = False) -> int:
+                     inline: bool = False,
+                     mouse_motion: bool = True) -> int:
     """
     Display an interactive menu where users can navigate with arrow keys.
 
@@ -1560,6 +1600,9 @@ def select_from_list(options: list[str], prompt: str, default_index: int = 0,
             (default). Set False for a sub-menu that returns to its parent
             inside the same detail view (seasons → languages → episodes), so
             the poster and context stay on screen until the series is left.
+        mouse_motion: False keeps click selection but ignores hover/motion —
+            useful for short quality lists where a moving mouse would change
+            the highlighted row by accident.
 
     Returns:
         Index of the selected option (0-based)
@@ -1752,7 +1795,7 @@ def select_from_list(options: list[str], prompt: str, default_index: int = 0,
     if flush_input:
         # Kept for compat — already covered by the settled flush above.
         drain_stdin()
-    with mouse_tracking():
+    with mouse_tracking(all_motion=mouse_motion):
         with Live(generate_renderable(), **live_kwargs) as live:
             while result is None:
                 key = _read_menu_key()

freeflix_cli-2.3.0/src/freeflix_cli/handlers/match.py

@@ -0,0 +1,227 @@
+"""Match menu — live football from the YacineTV catalogue.
+
+Cameroon time (UTC+1, no DST). The list is fetched fresh on every entry and
+falls back to the last snapshot only when the API is unreachable.
+"""
+
+from __future__ import annotations
+
+import re
+
+from datetime import datetime, timedelta, timezone
+
+from ..cli_utils import (
+    print_error,
+    print_info,
+    print_warning,
+    select_from_list,
+    spinner,
+)
+from ..i18n import t
+from ..icons import icon
+from ..scraping import yacine_match as ym
+from ..tracker import tracker
+
+_CAM = timezone(timedelta(hours=1))
+
+
+def _when_label(ev: ym.MatchEvent, now: datetime) -> str:
+    dt = ev.start_dt
+    today = now.date()
+    if dt.date() == today:
+        return f"{dt:%H:%M}"
+    if dt.date() == today + timedelta(days=1):
+        return f"{t('Tomorrow')} {dt:%H:%M}"
+    return f"{dt:%d/%m %H:%M}"
+
+
+def _channel_label(channel: str) -> str:
+    """Short live-TV badge: beIN SPORTS 1..4 → B1..B4."""
+    m = re.search(r"be\s*in\s*sports?\s*([1-4])", channel or "", re.I)
+    return f"B{m.group(1)}" if m else (channel or "")
+
+
+def _match_label(ev: ym.MatchEvent, now_ts: int, now: datetime) -> str:
+    state = ev.status(now_ts)
+    when = _when_label(ev, now)
+    if state == "live":
+        badge = f"● {t('LIVE')}"
+    elif state == "ended":
+        badge = f"✓ {t('Finished')}"
+    else:
+        badge = f"○ {t('Upcoming')}"
+    league = f"  ·  {ev.championship}" if ev.championship else ""
+    channel = f"({_channel_label(ev.channel)})  " if ev.channel else ""
+    return f"{channel}{badge}  {when}  ·  {ev.home}  VS  {ev.away}{league}"
+
+
+def _sort_events(events: list[ym.MatchEvent], now_ts: int) -> list[ym.MatchEvent]:
+    order = {"live": 0, "upcoming": 1, "ended": 2}
+    return sorted(events, key=lambda e: (order.get(e.status(now_ts), 3), e.start))
+
+
+# Conservative live HLS minimums (Mbps) used for the GB/hour estimate.
+_MIN_MBPS = {1080: 5.0, 720: 2.5, 480: 1.0, 360: 0.7}
+
+
+def _quality_metrics(stream: dict) -> tuple[int | None, float, float]:
+    """(height, minimum Mbps, estimated GB/hour) for a stream label."""
+    name = str(stream.get("name") or "?")
+    low = name.lower()
+    m = re.search(r"(\d{3,4})p", low)
+    if m:
+        height = int(m.group(1))
+    elif "hd" in low:
+        height = 1080
+    elif "sd" in low:
+        height = 720
+    elif "low" in low:
+        height = 480
+    else:
+        height = None
+    mbps = _MIN_MBPS.get(height, 2.0)
+    return height, mbps, mbps * 3600 / 8 / 1000
+
+
+def _quality_label(stream: dict) -> str:
+    name = str(stream.get("name") or "?")
+    height, mbps, gb = _quality_metrics(stream)
+    res = f" ({height}p)" if height else ""
+    return (f"{icon('play')} {name}{res}  ·  ≥ {mbps:.1f} Mbps  ·  "
+            f"~{gb:.2f} {t('GB/h')}")
+
+
+def _play(event: ym.MatchEvent, stream: dict, player_name: str = "") -> None:
+    from ..player_manager import play_direct_stream
+
+    title = f"YacineTV · {event.home}  VS  {event.away}"
+    print_info(f"{t('Selected quality:')} {stream.get('name', '?')}")
+    ok = play_direct_stream(stream["url"], stream.get("headers") or {}, title,
+                            player_name=player_name or None)
+    if not ok:
+        print_warning(t("Could not start the match stream."))
+
+
+def _available_players() -> list[str]:
+    from ..player_manager import get_mpv_path, get_vlc_path
+
+    out = []
+    if get_mpv_path():
+        out.append("mpv")
+    if get_vlc_path():
+        out.append("vlc")
+    return out
+
+
+def _current_player() -> str:
+    avail = _available_players()
+    saved = (tracker.get_match_player() or "").lower()
+    if saved in avail:
+        return saved
+    return "mpv" if "mpv" in avail else ("vlc" if "vlc" in avail else "")
+
+
+def _choose_player(current: str, allow_cancel: bool = False):
+    """Choose mpv/VLC after quality. Returns None when Back is pressed."""
+    avail = _available_players()
+    if len(avail) < 2:
+        if avail:
+            return avail[0]
+        print_warning(t("No video player found (mpv or VLC)."))
+        return None
+    labels = ["mpv" if n == "mpv" else "VLC" for n in avail]
+    options = list(labels)
+    if allow_cancel:
+        options.append(t("← Back"))
+    default = labels.index(current) if current in labels else 0
+    idx = select_from_list(
+        options, t("Choose a player"), header=f"{icon('football')} {t('Match')}",
+        default_index=default,
+    )
+    if 0 <= idx < len(avail):
+        chosen = avail[idx]
+        tracker.set_match_player(chosen)
+        print_info(f"{t('Match player set to:')} {chosen}")
+        return chosen
+    return None if allow_cancel else current
+
+
+def handle_match() -> None:
+    """Live football list → quality (Auto at the bottom) → playback."""
+    while True:
+        # Refresh on every pass (including after a playback) so the list and
+        # the LIVE badges follow the catalogue, like the weekly planning.
+        try:
+            with spinner(t("Loading matches…")):
+                events, cached = ym.fetch_events()
+                events = ym.localize_events(
+                    events, tracker.get_language() or "en")
+        except Exception as e:
+            print_error(f"{t('Matches unavailable:')} {e}")
+            return
+
+        if cached:
+            print_warning(t("Showing cached matches — network unavailable."))
+        if not events:
+            print_warning(t("No football matches right now."))
+            return
+
+        now = datetime.now(tz=_CAM)
+        now_ts = int(now.timestamp())
+        ordered = _sort_events(events, now_ts)
+        player_name = _current_player()
+        labels = [_match_label(ev, now_ts, now) for ev in ordered]
+        labels.append(t("← Back"))
+        header = (f"{icon('football')} {t('Football matches')}  ·  "
+                  f"{t('Cameroon time (UTC+1)')}")
+
+        idx = select_from_list(
+            labels, t("Select a match"), header=header, clear_on_back=True,
+        )
+        if idx < 0 or idx >= len(ordered):
+            return
+        event = ordered[idx]
+
+        try:
+            with spinner(t("Loading streams…")):
+                streams = ym.fetch_streams(event.id)
+        except Exception as e:
+            print_error(f"{t('Streams unavailable:')} {e}")
+            continue
+
+        if not streams:
+            print_warning(t("No stream available for this match."))
+            continue
+
+        options = [_quality_label(s) for s in streams]
+        options.append(f"{icon('sparkle')} {t('Auto (best quality)')}")
+        options.append(t("← Back"))
+        auto_idx = len(streams)
+        choice = select_from_list(
+            options,
+            f"{t('Choose the quality')}  ·  {event.home}  VS  {event.away}",
+            header=(f"{icon('football')} "
+                    f"{event.championship or t('Football')}"
+                    + (f"  ·  {_channel_label(event.channel)}"
+                       if event.channel else "")),
+        )
+        if choice < 0 or choice >= auto_idx:
+            if choice == auto_idx:
+                stream = ym.pick_auto(streams)
+                if not stream:
+                    print_warning(t("No stream available for this match."))
+                    continue
+                _h, _mbps, _gb = _quality_metrics(stream)
+                print_info(f"{t('Auto quality:')} {stream.get('name', '?')}  ·  "
+                           f"≥ {_mbps:.1f} {t('Mbps')}  ·  ~{_gb:.2f} "
+                           f"{t('GB/h')}")
+                chosen = _choose_player(player_name, allow_cancel=True)
+                if chosen:
+                    _play(event, stream, chosen)
+            else:
+                return
+            continue
+
+        chosen = _choose_player(player_name, allow_cancel=True)
+        if chosen:
+            _play(event, streams[choice], chosen)

{freeflix_cli-2.1.2 → freeflix_cli-2.3.0}/src/freeflix_cli/i18n.py

@@ -990,6 +990,54 @@ _FR = {
         "AniList : ton jeton est invalide ou expiré. "
         "Réglages → AniList → Changer le jeton.",
     'AniList is unreachable right now:': 'AniList est injoignable pour le moment :',
+    # ── Match / football (YacineTV) ──
+    'Match': 'Match',
+    'Football': 'Football',
+    'Football matches': 'Matchs de football',
+    'Cameroon time (UTC+1)': 'Heure du Cameroun (UTC+1)',
+    'Select a match': 'Choisis un match',
+    'Select quality': 'Choisis la qualité',
+    'Choose the quality': 'Choisis la qualité',
+    'Loading matches…': 'Chargement des matchs…',
+    'Matches unavailable:': 'Matchs indisponibles :',
+    'Showing cached matches — network unavailable.':
+        'Affichage des matchs en cache — réseau indisponible.',
+    'No football matches right now.':
+        'Aucun match de football pour le moment.',
+    'Loading streams…': 'Chargement des flux…',
+    'Streams unavailable:': 'Flux indisponibles :',
+    'No stream available for this match.':
+        'Aucun flux disponible pour ce match.',
+    'Auto (best quality)': 'Auto (meilleure qualité)',
+    'Auto quality:': 'Qualité auto :',
+    'Selected quality:': 'Qualité sélectionnée :',
+    'Could not start the match stream.':
+        'Impossible de lancer le flux du match.',
+    'Tomorrow': 'Demain',
+    'Upcoming': 'À venir',
+    'LIVE': 'LIVE',
+    'Match streams use mpv or VLC; launching mpv.':
+        'Les matchs utilisent mpv ou VLC ; lancement de mpv.',
+    'The stream ended unexpectedly.':
+        'Le flux s’est arrêté de façon inattendue.',
+    'Playing in VLC…': 'Lecture dans VLC…',
+    'VLC stopped early. Log:': 'VLC s’est arrêté trop tôt. Journal :',
+    'Movies, Series & Anime': 'Films, Séries & Anime',
+    'Mbps': 'Mbps',
+    'GB/h': 'Go/h',
+    'Match player:': 'Lecteur des matchs :',
+    'Match player set to:': 'Lecteur des matchs :',
+    'Choose a player': 'Choisis un lecteur',
+    'No video player found (mpv or VLC).':
+        'Aucun lecteur vidéo trouvé (mpv ou VLC).',
+    'Auto': 'Auto',
+    'mpv is not installed or not in PATH.':
+        "mpv n'est pas installé ou absent du PATH.",
+    'VLC is not installed or not in PATH.':
+        "VLC n'est pas installé ou absent du PATH.",
+    'This stream needs mpv or VLC: the required HTTP headers cannot be forwarded to a browser.':
+        'Ce flux nécessite mpv ou VLC : les en-têtes HTTP requis ne peuvent pas '
+        "être transmis à un navigateur.",
 }