freeflix-cli 2.4.0__tar.gz → 2.5.0__tar.gz

{freeflix_cli-2.4.0 → freeflix_cli-2.5.0}/CHANGELOG.md

@@ -1,5 +1,186 @@
 # Changelog
 
+## 2.5.0
+
+- **Anime-Sama : les lecteurs jouent enfin (nouveau format 12/11/2026)**. Les
+  tableaux d'épisodes ne contiennent plus d'URL mais `"lien:<id>"` ; le vrai
+  lien vient de `/api/lien.php?j=<jeton>&l=<id>`, qui répond
+  **`403 {"erreur":"origine"}`** dès que la requête paraît cross-site (le
+  fingerprint navigateur envoie `Sec-Fetch-Site: none`). C'était la cause du
+  `anime-sama::signed` affiché puis de « Impossible de résoudre l'URL du
+  flux ». FreeFlix signe maintenant en `same-origin`, avec rafraîchissement du
+  jeton expiré.
+- **Tous les lecteurs visibles sont réellement lisibles** : les lignes
+  indirectes sont résolues **en parallèle avant le menu** (et non plus une par
+  une au clic), donc les lecteurs morts (uqload bloqué par sa page « premium »,
+  ids sendvid supprimés) disparaissent au lieu de faire échouer la lecture.
+  L'analyse de qualité (résolutions + bitrate) tourne ensuite normalement sur
+  ces URL réelles : `1080p ~4.9 · 480p ~0.5 Mbps`, `720p ~1.1 Mbps` mesurés.
+- **Déduplication corrigée** : toutes les lignes indirectes partagent la même
+  URL factice, ce qui réduisait un épisode à un seul « Lecteur 1 ». L'identité
+  du slot (épisode/lecteur/id) est maintenant la clé.
+- **Saisons 9× plus rapides** : un seul téléchargement de page (les langues
+  déclarées par le site) au lieu de sonder neuf `episodes.js` en 404.
+- **« Nouveautés » visible dès l'ouverture** : le flux coûtait ~30 s de réseau
+  alors que l'écran n'attendait que 8 s — d'où la liste vide jusqu'à un détour
+  par le Planning. Il est désormais persisté sur disque (affichage immédiat au
+  lancement), rafraîchi en parallèle (4 séries à la fois) et l'attente est
+  portée à 45 s.
+- **Match : message court** quand la journée est vide —
+  « Aucun match disponible aujourd'hui. » au lieu d'un mur de diagnostics.
+- **Navigation fluide dans la recherche et le planning** : les touches d'une
+  même rafale (auto-repeat, frappes pendant le rendu d'une affiche) étaient
+  **silencieusement jetées** — pire, une touche Entrée coincée dans le même
+  lot était avalée et l'écran semblait bloqué. Décodage un-événement-par-lot
+  avec rejeu du reste, et l'affiche sixel n'est plus repeinte (~128 ms, 0,5 Mo
+  par appui) qu'une fois la navigation stabilisée. Mesures : 10 flèches
+  rapides = 10/10 appliquées (avant 1/10), survol souris 120 rapports = retour
+  en 10 ms (avant > 30 s).
+- **Sortie propre** : Rich écrivait `?1049l` trois fois, et Konsole rejouait
+  son écran sauvegardé à chaque fois — d'où la ligne « Que veux-tu faire ?
+  Quitter » ré-affichée sous le prompt du shell. Une seule sortie d'écran
+  alterné, purge des rapports souris en vol, et Ctrl-C affiche « Au revoir ! »
+  au lieu d'un traceback.
+- **Windows : lecture réparée**. Le mpv/ffmpeg téléchargé par le setup était
+  installé dans un dossier hors PATH que la résolution ignorait (et
+  `_resolve_tool` cherchait `ffmpeg` sans `.exe`) → « mpv is not installed »
+  alors qu'il était là. Aussi : `select()` sur un pipe (crash
+  `WinError 10038` du préflight Match) remplacé par un lecteur portable,
+  `-nostdin` + `CREATE_NO_WINDOW` sur les pipes ffmpeg, port du proxy publié
+  avant le bind réel (course → « connection refused »), en-têtes du mode
+  direct mpv joints par des virgules, VLC Windows routé par le proxy HLS.
+- **Installation idempotente** : les « fausses demandes » à chaque lancement
+  venaient d'un setup dont le succès dépendait du run courant (un shader
+  manquant remettait `setup_done=False` pour toujours). Le succès est dérivé
+  des fichiers réellement sur disque, une réparation silencieuse ne
+  télécharge que le manquant et ne pose plus de question, les shaders sont
+  validés par leur contenu (plus de re-téléchargement quand Anime4K change en
+  amont), la Nerd Font n'est plus retéléchargée, le wrapper PRIME et
+  FlareSolverr ne sont plus réécrits/recréés. Scripts : pré-vérification des
+  paquets (2ᵉ run : 0 install, 0 téléchargement, config utilisateur
+  conservée), `uv tool upgrade` au lieu de `--force`, mode non-TTY sans
+  abandon, PowerShell 5.1 sans `NativeCommandError`, PATH du bon shell.
+- **`--doctor` honnête** : un binaire système n'est plus annoncé « managed
+  MISSING », FlareSolverr non lancé = « NOT RUNNING (optional) », versions
+  minimales comparées, commande de réinstallation adaptée à uv/pipx/pip.
+- 752 tests au vert, ruff et shellcheck OK.
+
+## 2.4.4
+
+- **animes-sama.fr (avec un « s ») réparé sur trois points**. Ce miroir a
+  divergé de `anime-sama.to` et cassait FreeFlix silencieusement :
+  1. la recherche utilise une **troisième mise en page** (`div.card-title`,
+     sans titre `h2`/`h3`) → **0 résultat** pour toute requête ;
+  2. `<langue>/episodes.js` répond **404** : les épisodes sont désormais
+     **inline** dans la page de saison → « Aucun épisode trouvé » ;
+  3. ces tableaux ne contiennent plus d'URL mais des **drapeaux `"1"`/`""`** :
+     le vrai lien est fabriqué à la demande par l'API signée
+     `/api/player/sign` puis `/api/player/resolve`. FreeFlix sait maintenant
+     signer et résoudre ces liens (même session = même cookie CSRF, sinon
+     `419`), donc ces lecteurs jouent au lieu d'être masqués.
+- **Vérifié sur Avatar, le dernier maître de l'air** (saisons 1, 3, 4, film,
+  VF et VOSTFR) : 2 à 3 lecteurs par épisode, chaîne complète
+  sign → resolve → `PLAYABLE`.
+- **`oneupload.to` masqué** : le domaine répond `Connection refused` depuis
+  six pays testés (HK, ID, IR, TR…) et depuis ici — il est mort. C'était le
+  « Lecteur 1 » de nombreuses séries.
+- **Anime-Sama : les lecteurs Voe rotatifs s'affichent enfin**. Le site sert
+  son lecteur Voe sous des domaines jetables qui changent tous les jours
+  (`claireguessthousand`, `derricknationtop`, `ashleyhardat`,
+  `shanelocaldog`…). Comme la liste était figée dans le code, ces lignes
+  étaient **masquées comme « non supportées »** alors que l'épisode se lit.
+  La détection reconnaît maintenant la forme de l'URL (`/e/<id>`) puis
+  vérifie en direct (avec cache) que la page parle bien Voe, ce qui couvre
+  les prochains domaines sans nouvelle version.
+- **Contrôle complet des lecteurs Anime-Sama** (7 séries, 2026-11-11) :
+  `ansembed`, `smoothpre` et les miroirs Voe → **lisibles** ;
+  `uqload` réclame désormais de désactiver l'adblocker (bloqué côté site),
+  `sibnet` répond 403 sur toute la plateforme, `sendvid` est supprimé (404),
+  `vk.com` et `oneupload` ne sont pas des lecteurs supportés.
+- 6 tests dédiés (`tests/test_voe_mirrors.py`).
+- **Fin du `avformat_open_input() failed` incompréhensible**. Un lien CDN
+  signé peut expirer entre la résolution et la lecture : la playlist répond
+  encore `200` avec tous les segments, mais **chaque segment revient en 403**.
+  mpv s'arrêtait sur cette erreur ffmpeg brute, VLC affichait une fenêtre
+  noire — impossible de distinguer « lien expiré » de « installation cassée ».
+  Un préflight HLS vérifie maintenant la playlist **et le premier segment**
+  avant d'ouvrir le lecteur :
+  « Ce lien de lecture a expiré (le CDN refuse les segments). »
+  + « Rouvre l'épisode ou choisis une autre source pour obtenir un lien neuf. »
+- **Relance automatique de mpv** : si le lecteur se ferme en moins de 3 s
+  (échec du démultiplexeur), FreeFlix re-sonde le flux et retente une fois au
+  lieu d'abandonner.
+- Le préflight est volontairement **non bloquant** : une erreur réseau, une
+  playlist multipiste, un direct sans segment ou un `.mp4` ne refusent jamais
+  une lecture. Un flux qui marche n'est pas bloqué par la sonde.
+- 7 tests dédiés (`tests/test_hls_preflight.py`) : expiré, 410, hors ligne,
+  flux valide, master playlist, panne réseau, fichier direct.
+- 657 tests au vert, ruff OK.
+
+## 2.4.3
+
+- **Installation initiale réparée** : le pin SHA-256 de `mpv.conf` n'avait pas
+  suivi la suppression du chargement Anime4K, donc un premier lancement
+  téléchargeait le bon fichier puis le refusait (« somme de contrôle
+  INCORRECTE »). Le pin est corrigé, le message distingue désormais un fichier
+  modifié en amont d'un binaire altéré, et un test CI compare les pins aux
+  fichiers `config/` pour empêcher la dérive. Un pin reste valide que le
+  fichier arrive en LF (HTTPS) ou en CRLF (copie Windows).
+- **Un `mpv.conf` déjà présent n'est plus écrasé** par le setup (Linux et
+  macOS) : un réglage personnel (`hwdec=vaapi-copy`, cache, HDR…) survit
+  désormais à un relancement du premier lancement. Seuls les fichiers
+  réellement absents sont téléchargés.
+- **mpv sous Windows : vrai binaire CLI** : l'installateur pose
+  `shinchiro.mpv` (puis `mpv-player.mpv-CI.MSVC`, `mpv.net` en dernier
+  recours) au lieu de `mpv.net` seul. `mpv.net` ne fournit que `mpvnet.exe`,
+  une interface graphique qui n'accepte pas toujours la lecture sur stdin,
+  l'IPC ou `--config-dir` — d'où les échecs de lecture. La découverte de mpv
+  cherche aussi les dossiers winget versionnés, Scoop et Chocolatey, et le
+  dossier `WinGet\Links` est ajouté au PATH après installation.
+- **Faux positif antivirus documenté** : Defender signale parfois
+  l'installateur PowerShell ou le binaire PyInstaller comme
+  `Trojan:Win32/Commando.*!ml` / `Wacatac.*!ml` (heuristique `!ml`, pas une
+  signature). Le README remplace le `iwr | iex` par un téléchargement +
+  `Unblock-File`, et `docs/TROUBLESHOOTING.md` explique comment vérifier le
+  SHA-256, restaurer le fichier et signaler le faux positif.
+- **Match : erreur YacineTV clarifiée**. Quand l'API répond `200` avec un
+  catalogue vide, FreeFlix l'annonce comme tel (« côté serveur, 0 rencontre »)
+  au lieu d'afficher l'erreur `HTTP 436` du host de secours, qui faisait croire
+  à un problème de connexion. Le cache précédent reste utilisé si disponible.
+- 635 tests au vert, ruff OK.
+
+## 2.4.2
+
+- **Match ne reste plus bloqué sur un écran vide** : si l'API répond `[]`
+  (entre deux journées, ou incident côté serveur), FreeFlix garde le dernier
+  catalogue connu et affiche un message clair (« Le catalogue est vide entre
+  deux journées ; réessaie plus tard. ») au lieu d'une liste vide.
+- En cas d'erreur réseau, message explicite + pause pour pouvoir lire la
+  raison, puis retour au menu.
+- 625 tests au vert, ruff OK.
+
+## 2.4.1
+
+- **Match : une seule ligne par affiche**. Le catalogue répétait un même
+  match sur plusieurs créneaux (un « Twente - Ajax » en direct alors qu'un
+  autre du même jour était déjà terminé). Une entrée live/à venir/terminée
+  par match, la plus utile gagne.
+- **Bascule automatique de source** : un match en direct expose désormais
+  HD, SD, Low et des flux **Multi**. Si la qualité choisie est refusée par
+  le CDN, FreeFlix essaie les autres sources au lieu de s'arrêter.
+- **Contrôle avant lecture fiable** : le préflight passe par **ffmpeg en
+  direct** (comme la lecture) et lit sa sortie en continu. Le proxy local
+  déclenchait des 404 anti-hotlink et un live qui joue « sans fin » était
+  pris pour une panne — les deux sont corrigés. Les erreurs sont
+  distinguées : `403` (serveur qui refuse) vs `404/invalid data` (flux sans
+  données).
+- **Multi en tête** : les flux « Multi » passent avant HD/SD/Low (source la
+  plus fiable en direct) ; tri stable, ordre du catalogue conservé à
+  qualité égale.
+- Proxy HLS : rafraîchissement automatique de la playlist quand un segment
+  devient introuvable.
+- 618 tests au vert, ruff OK.
+
 ## 2.4.0
 
 - **Match regroupé par statut** : sections `En direct (n)`, `À venir (n)`,

{freeflix_cli-2.4.0 → freeflix_cli-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: freeflix-cli
-Version: 2.4.0
+Version: 2.5.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
@@ -143,12 +143,21 @@ No git, no package manager, no sudo needed. Just Python (or PowerShell on Window
 # Linux / macOS
 curl -fsSL https://raw.githubusercontent.com/freedy237/freeflix-cli/main/scripts/install.py | python3
 
-# Windows (PowerShell)
-powershell -c "iwr -useb https://raw.githubusercontent.com/freedy237/freeflix-cli/main/scripts/install.ps1 | iex"
+# Windows (PowerShell) — download, inspect, then run
+irm https://raw.githubusercontent.com/freedy237/freeflix-cli/main/scripts/install.ps1 -OutFile install.ps1
+Unblock-File .\install.ps1
+powershell -ExecutionPolicy Bypass -File .\install.ps1
 ```
 
 This installs `uv` if missing, then `freeflix-cli`.
 
+> **Antivirus on Windows:** Defender's ML engine sometimes flags the installer
+> or the standalone `.exe` as `Trojan:Win32/Commando.*!ml` or
+> `.../Wacatac.*!ml`. The `!ml` suffix means a heuristic guess, not a virus
+> signature — it fires on unsigned installers that download and run things.
+> Verify the SHA-256 published with the release, then restore/add an exclusion.
+> Details: [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md#windows--antivirus-faux-positif).
+
 ### From PyPI (if you already have the system deps)
 
 If `mpv`, `yt-dlp`, `ffmpeg`, `aria2` and `libnotify` are installed :

{freeflix_cli-2.4.0 → freeflix_cli-2.5.0}/README.md

@@ -111,12 +111,21 @@ No git, no package manager, no sudo needed. Just Python (or PowerShell on Window
 # Linux / macOS
 curl -fsSL https://raw.githubusercontent.com/freedy237/freeflix-cli/main/scripts/install.py | python3
 
-# Windows (PowerShell)
-powershell -c "iwr -useb https://raw.githubusercontent.com/freedy237/freeflix-cli/main/scripts/install.ps1 | iex"
+# Windows (PowerShell) — download, inspect, then run
+irm https://raw.githubusercontent.com/freedy237/freeflix-cli/main/scripts/install.ps1 -OutFile install.ps1
+Unblock-File .\install.ps1
+powershell -ExecutionPolicy Bypass -File .\install.ps1
 ```
 
 This installs `uv` if missing, then `freeflix-cli`.
 
+> **Antivirus on Windows:** Defender's ML engine sometimes flags the installer
+> or the standalone `.exe` as `Trojan:Win32/Commando.*!ml` or
+> `.../Wacatac.*!ml`. The `!ml` suffix means a heuristic guess, not a virus
+> signature — it fires on unsigned installers that download and run things.
+> Verify the SHA-256 published with the release, then restore/add an exclusion.
+> Details: [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md#windows--antivirus-faux-positif).
+
 ### From PyPI (if you already have the system deps)
 
 If `mpv`, `yt-dlp`, `ffmpeg`, `aria2` and `libnotify` are installed :

{freeflix_cli-2.4.0 → freeflix_cli-2.5.0}/docs/TROUBLESHOOTING.md

@@ -88,6 +88,67 @@ fois) ; annule avec `Échap Échap`.
 - Police Nerd : l'installateur la pose et configure Windows Terminal ; ferme
   **toutes** les fenêtres pour que la police s'applique.
 
+## Windows : antivirus (faux positif)
+
+Defender (ou un antivirus tiers) peut signaler `scripts/install.ps1` ou
+`freeflix-windows-x86_64.exe` comme :
+
+- `Trojan:Win32/Commando.A!ml` / `Commando.C!ml`
+- `Trojan:Script/Wacatac.*!ml`
+- `Program:Win32/Wacapew.*!ml`
+
+Le suffixe `!ml` = détection **heuristique** (machine learning), pas une
+signature. Un installeur PowerShell non signé qui télécharge `uv`, écrit dans
+le PATH et installe des paquets déclenche régulièrement ces faux positifs ;
+c'est aussi le cas classique des binaires PyInstaller.
+
+**Vérifier avant de faire confiance :**
+
+1. Le script est public et lisible en entier :
+   <https://github.com/freedy237/freeflix-cli/blob/main/scripts/install.ps1>
+2. Compare le SHA-256 du binaire téléchargé avec `SHA256SUMS` de la release :
+   `Get-FileHash .\freeflix-windows-x86_64.exe -Algorithm SHA256`
+3. Envoie le fichier sur <https://www.virustotal.com> : quelques détections
+   heuristiques parmi 70 moteurs = faux positif probable.
+
+**Débloquer :**
+
+```powershell
+# Fichier téléchargé depuis Internet : retire la marque "Mark of the Web"
+Unblock-File .\install.ps1
+Unblock-File .\freeflix-windows-x86_64.exe
+
+# Restaure depuis la quarantaine (Sécurité Windows → Protection contre les
+# virus → Historique des menaces → Autoriser sur l'appareil), puis ajoute une
+# exclusion sur le dossier de l'app si nécessaire :
+Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\Microsoft\WinGet\Packages"
+```
+
+Signale le faux positif à Microsoft :
+<https://www.microsoft.com/en-us/wdsi/filesubmission>
+
+## Windows : mpv introuvable ou ne démarre pas
+
+Depuis 2.4.3, l'installateur pose un **vrai mpv CLI** (`shinchiro.mpv`, puis
+`mpv-player.mpv-CI.MSVC` en secours) au lieu de `mpv.net`. `mpv.net` ne fournit
+que `mpvnet.exe`, une interface graphique qui n'accepte pas toujours les
+options utilisées par FreeFlix (lecture sur stdin, IPC, `--config-dir`) —
+d'où les échecs de lecture.
+
+```powershell
+# Vérifier ce que FreeFlix trouve
+freeflix --doctor
+winget install --id shinchiro.mpv -e
+# ou, si le paquet n'existe plus :
+winget search mpv
+```
+
+Après installation, ouvre un **nouveau** terminal (le lien winget est dans
+`%LOCALAPPDATA%\Microsoft\WinGet\Links`). Si seul `mpvnet.exe` est présent,
+FreeFlix l'utilise en dernier recours mais peut refuser certains flux : dans ce
+cas installe VLC (`winget install --id VideoLAN.VLC -e`) et choisis VLC comme
+lecteur des matchs.
+
 ## macOS
 
 - `install-mac.sh` écrit dans `~/.config/freeflix/mpv` (dossier dédié).

{freeflix_cli-2.4.0 → freeflix_cli-2.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "freeflix-cli"
-version = "2.4.0"
+version = "2.5.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.5.0/scripts/install-mac.sh

@@ -0,0 +1,209 @@
+#!/usr/bin/env bash
+# FreeFlix CLI — macOS installer (Homebrew based)
+#
+# Re-runnable by design : already-installed brew packages are skipped, an
+# existing tuned mpv.conf is never overwritten, shaders are only downloaded
+# when missing, and prompts are skipped when stdin is not a terminal.
+
+set -euo pipefail
+
+BLUE="\033[1;34m"; GREEN="\033[1;32m"; YELLOW="\033[1;33m"; RED="\033[1;31m"; NC="\033[0m"
+log()   { echo -e "${BLUE}»${NC} $*"; }
+ok()    { echo -e "${GREEN}✓${NC} $*"; }
+warn()  { echo -e "${YELLOW}!${NC} $*"; }
+err()   { echo -e "${RED}✗${NC} $*" >&2; }
+
+# Take the default instead of hanging/aborting when piped (no TTY).
+ask() {
+    local prompt="$1" default="$2" ans
+    if [[ ! -t 0 ]]; then
+        [[ "$default" == "y" ]]
+        return
+    fi
+    read -rp "$prompt" ans
+    ans="${ans:-$default}"
+    [[ "$ans" =~ ^[Yy] ]]
+}
+
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+# ─── 1. Ensure Homebrew ──────────────────────────────────────────────
+if ! command -v brew >/dev/null 2>&1; then
+    log "Homebrew not found, installing it…"
+    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+    # Add brew to PATH for this session (Apple Silicon vs Intel default paths)
+    if [[ -x /opt/homebrew/bin/brew ]]; then
+        eval "$(/opt/homebrew/bin/brew shellenv)"
+    elif [[ -x /usr/local/bin/brew ]]; then
+        eval "$(/usr/local/bin/brew shellenv)"
+    fi
+fi
+ok "Homebrew available"
+
+# ─── 2. Install system packages (only the missing ones) ──────────────
+# `brew list --versions` is a cheap local check ; calling `brew install`
+# again for present packages re-ran the whole dependency resolution and
+# printed upgrade noise on every re-run.
+brew_installed() {
+    brew list --versions "$1" >/dev/null 2>&1 \
+        || brew list --cask --versions "$1" >/dev/null 2>&1
+}
+
+log "Installing system deps via brew (missing only)…"
+for pkg in python yt-dlp ffmpeg aria2 mpv chafa; do
+    if brew_installed "$pkg"; then
+        continue
+    fi
+    brew install --quiet "$pkg" || warn "Could not install $pkg — continuing."
+done
+if ! brew_installed vlc; then
+    brew install --quiet --cask vlc 2>/dev/null \
+        || brew install --quiet vlc 2>/dev/null \
+        || warn "VLC unavailable — mpv alone is enough to watch."
+fi
+ok "System packages ready"
+
+# ─── 2b. Nerd Font (crisp TUI icons) — idempotent ────────────────────
+if brew_installed font-caskaydia-cove-nerd-font; then
+    ok "Nerd Font already installed"
+elif brew install --quiet --cask font-caskaydia-cove-nerd-font 2>/dev/null; then
+    ok "Nerd Font installed (set your terminal font to 'CaskaydiaCove Nerd Font')"
+else
+    warn "Nerd Font cask unavailable — emoji icons still work out of the box."
+fi
+
+# ─── 3. Install freeflix-cli (skip when already at this version) ─────
+install_uv_if_missing() {
+    if command -v uv >/dev/null 2>&1; then
+        return 0
+    fi
+    log "uv not found — installing …"
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+    export PATH="$HOME/.local/bin:$PATH"
+    if ! command -v uv >/dev/null 2>&1; then
+        err "Could not install uv automatically."
+        err "Visit https://docs.astral.sh/uv/#getting-started"
+        exit 1
+    fi
+    ok "uv installed"
+}
+
+project_version() {
+    sed -n 's/^version = "\(.*\)"/\1/p' "$PROJECT_ROOT/pyproject.toml" | head -n 1
+}
+
+install_uv_if_missing
+want="$(project_version)"
+have="$(uv tool list 2>/dev/null | awk '/^freeflix-cli /{print $2; exit}' | sed 's/^v//')"
+if [[ -n "$have" && -n "$want" && "$have" == "$want" \
+      && "${FREEFLIX_FORCE_REINSTALL:-0}" != "1" ]]; then
+    ok "freeflix-cli ${have} already installed (no reinstall)"
+else
+    log "Installing freeflix-cli${want:+ ${want}} via uv…"
+    uv tool install --force "$PROJECT_ROOT"
+    ok "freeflix command installed"
+fi
+
+ensure_permanent_path() {
+    local bin_dir="$HOME/.local/bin"
+    mkdir -p "$bin_dir"
+    local rc
+    case "${SHELL:-}" in
+        *zsh*) rc="$HOME/.zshrc" ;;
+        *bash*) rc="$HOME/.bashrc" ;;
+        *) rc="$HOME/.profile" ;;
+    esac
+    if ! grep -qs "$bin_dir" "$rc" 2>/dev/null; then
+        {
+            echo ""
+            echo "# Added by FreeFlix CLI"
+            echo "export PATH=\"$bin_dir:\$PATH\""
+        } >> "$rc"
+        ok "$bin_dir added to $rc (source it or open a new terminal)"
+    else
+        ok "$bin_dir already in $rc"
+    fi
+}
+ensure_permanent_path
+
+# ─── 4. Optional : mpv config + Anime4K (never overwrites) ──────────
+MPV_CFG="$HOME/.config/freeflix/mpv"
+
+install_file_once() {
+    local src="$1" dest="$2"
+    if [[ -s "$dest" ]]; then
+        return 0
+    fi
+    cp "$src" "$dest"
+}
+
+download_shader_once() {
+    local dest="$1" url="$2"
+    if [[ -s "$dest" ]]; then
+        return 0
+    fi
+    if curl -fsSL -o "$dest.part" "$url" && [[ -s "$dest.part" ]]; then
+        mv "$dest.part" "$dest"
+    else
+        rm -f "$dest.part"
+        warn "Could not download $(basename "$dest") — anime upscaling may be limited."
+    fi
+}
+
+if [[ -s "$MPV_CFG/mpv.conf" && -s "$MPV_CFG/input.conf" \
+      && -s "$MPV_CFG/scripts/freeflix_position.lua" ]]; then
+    ok "mpv config already installed (kept)"
+elif ask "Install default mpv config (Anime4K toggle, anti-crash) ? [Y/n] " y; then
+    # FreeFlix launches mpv with --config-dir ~/.config/freeflix/mpv: writing
+    # the global ~/.config/mpv made Anime4K invisible to the app.
+    mkdir -p "$MPV_CFG/scripts" "$MPV_CFG/shaders"
+    install_file_once "$PROJECT_ROOT/config/mpv.conf" "$MPV_CFG/mpv.conf"
+    install_file_once "$PROJECT_ROOT/config/input.conf" "$MPV_CFG/input.conf"
+    install_file_once "$PROJECT_ROOT/config/freeflix_position.lua" \
+        "$MPV_CFG/scripts/freeflix_position.lua"
+    ok "mpv config installed (CTRL+1 toggles Anime4K)"
+fi
+
+if [[ -d "$MPV_CFG/shaders" ]]; then
+    BASE="https://raw.githubusercontent.com/bloc97/Anime4K/master/glsl"
+    download_shader_once "$MPV_CFG/shaders/Anime4K_Clamp_Highlights.glsl" \
+        "$BASE/Restore/Anime4K_Clamp_Highlights.glsl"
+    # mpv.conf loads the S variant by default; CTRL+1 switches to VL.
+    download_shader_once "$MPV_CFG/shaders/Anime4K_Restore_CNN_S.glsl" \
+        "$BASE/Restore/Anime4K_Restore_CNN_S.glsl"
+    download_shader_once "$MPV_CFG/shaders/Anime4K_Upscale_CNN_x2_S.glsl" \
+        "$BASE/Upscale/Anime4K_Upscale_CNN_x2_S.glsl"
+    download_shader_once "$MPV_CFG/shaders/Anime4K_Restore_CNN_VL.glsl" \
+        "$BASE/Restore/Anime4K_Restore_CNN_VL.glsl"
+    download_shader_once "$MPV_CFG/shaders/Anime4K_Upscale_CNN_x2_VL.glsl" \
+        "$BASE/Upscale/Anime4K_Upscale_CNN_x2_VL.glsl"
+fi
+
+# ─── 5. Optional : FlareSolverr (auto-solve Cloudflare) via Docker ───
+flaresolverr_running() {
+    curl -fsS --max-time 2 http://127.0.0.1:8191/health >/dev/null 2>&1 \
+        || curl -fsS --max-time 2 http://127.0.0.1:8191/ >/dev/null 2>&1
+}
+
+if flaresolverr_running; then
+    ok "FlareSolverr already running on :8191"
+elif ask "Set up FlareSolverr to auto-solve Cloudflare (needs Docker) ? [y/N] " n; then
+    if command -v docker >/dev/null 2>&1; then
+        if ! docker start flaresolverr >/dev/null 2>&1; then
+            if docker container inspect flaresolverr >/dev/null 2>&1; then
+                warn "FlareSolverr container exists but could not be started."
+            elif ! docker run -d --name flaresolverr --restart unless-stopped \
+                    -p 8191:8191 ghcr.io/flaresolverr/flaresolverr:latest; then
+                warn "Could not start FlareSolverr — start it manually later."
+            fi
+        fi
+        ok "FlareSolverr requested (give it a moment to be ready)."
+    else
+        warn "Docker not found. Install Docker, then run the flaresolverr container."
+    fi
+fi
+
+echo
+ok "Installation complete. Run :  ${GREEN}freeflix${NC}"
+log "Icons: set your terminal font to 'CaskaydiaCove Nerd Font', then in"
+log "FreeFlix go to Settings > Icon Style > nerd (emoji is the default)."