TOUPILO
Tes films, séries, photos et musique de l'ordinateur (Mac ou PC) sur la TV, par le Wi-Fi
========================================================================================
Site : toupilo.com (mode d'emploi, téléchargement, mises à jour).
(Toupilo s'appelait Diffuseur maison jusqu'à la version 1.9 : même programme,
nouveau nom.)

Ce que ça fait
--------------
Tu choisis un film sur l'ordinateur (ou depuis ton téléphone) et la TV le lit toute
seule. Tu peux continuer à utiliser l'ordinateur ou éteindre son écran : le film
continue.

La page a quatre espaces, en haut (en bas sur un téléphone) :
  - Films et Séries : tes vidéos, avec leurs affiches, rangées en catégories ;
  - Photos : tes photos et vidéos personnelles, par album, par année, en diaporama
    sur la TV ;
  - Musique : tes albums, par artiste et par genre, joués par la TV ou par une
    enceinte Google (Nest, Chromecast Audio).

Il marche avec :
  - les TV qui lisent les films du réseau (DLNA) : LG, Samsung, Sony, Philips,
    Panasonic… ;
  - Google Cast : Chromecast, et TV ou vidéoprojecteurs sous Google TV ou Android TV
    avec Chromecast intégré (JMGO, XGIMI, Sony…). Voir « Chromecast et Google TV ».

  - La TV lit directement les fichiers qu'elle connaît (MKV, MP4, AVI…), avec le
    retour et l'avance rapides de sa propre télécommande.
  - Il reconnaît ta TV, quelle que soit sa marque, et un test de lecture de deux
    minutes vérifie ce qu'elle lit (voir « Ta TV : ce qu'elle sait lire »). Quand
    le son ne passe pas (le DTS ou le Dolby Digital sur certaines TV), il
    ré-emballe le film à la volée : l'image reste intacte, le son est converti dans
    un format qu'elle lit.
  - Quand l'image ne passe pas (rare), il convertit tout le film en direct.
  - Les sous-titres posés à côté du film (.srt, .ass, .vtt) et ceux intégrés au
    fichier sont envoyés à la TV. Les sous-titres « image » (PGS) sont incrustés.
  - Tes films s'affichent comme sur une plateforme, avec leurs affiches officielles
    de cinéma, leur résumé et leur bande-annonce (TMDB, la grande base de films du
    cinéma). À défaut : la boutique Apple, puis l'affiche de Wikipédia, sinon une
    image du film.
    Un film pas encore sorti en France n'a parfois qu'un résumé en anglais : sa
    fiche le signale, et Toupilo cherche la version française toutes les deux
    semaines (elle remplace l'anglais dès qu'elle existe).
  - Des rangées et des catégories pour s'y retrouver : Reprendre, Ajoutés
    récemment, les sagas (Avatar, Shrek…), Films français, Pour un soir de semaine
    (moins d'1 h 30), Cinéma asiatique, puis une ligne de catégories (Action &
    aventure, Comédie, Drame, Thriller & policier, Science-fiction & fantastique,
    Animation, Famille & jeunesse…). « Plus de filtres » ajoute l'époque, la
    durée, l'origine, les sous-genres (Super-héros, Espionnage…) et la version
    (française ou sous-titrée). Les filtres se combinent.
  - Les séries ont leur propre espace : « Épisode suivant » (la suite de ce que tu
    regardes), « Nouveaux épisodes », une seule affiche par série, ses saisons et
    ses épisodes dans sa fiche. À la fin d'un épisode, le suivant se lance tout
    seul après 10 secondes, dans la même langue et avec les mêmes sous-titres.
  - Une Fire TV reçoit aussi les films, les photos et la musique, par une page ouverte
    dans son navigateur Silk (voir « Fire TV » plus bas).
  - Les commandes de lecture sont sur l'ordinateur, et la télécommande s'affiche sur
    n'importe quel téléphone ou tablette du même Wi-Fi : iPhone, iPad, Android…
    (QR code à scanner).
  - Le programme se souvient où tu t'es arrêté dans chaque film, et des films vus.

Tes films, tes photos et ta musique ne sortent pas de la maison : ils passent par ton
Wi-Fi. Seuls les titres des films (et leur année) sont envoyés à TMDB, à Wikipédia et
à la boutique Apple, pour trouver les affiches, genres, résumés et bandes-annonces.
Pour couper ça : « Dossiers de films et de séries, affiches », en bas de l'espace
Films. Rien des photos ni de la musique n'est envoyé sur Internet. Une bande-annonce
se lit avec le lecteur YouTube, dans sa version sans cookies de suivi.


Fire TV (et tout appareil avec un navigateur)
---------------------------------------------
Une Fire TV ne connaît ni le DLNA ni Google Cast : elle reçoit les films de Toupilo
par une page web, l'« Écran Toupilo », ouverte dans Silk, son navigateur. Une seule
fois :
1. Sur l'ordinateur, dans « Regarder sur », ouvre « Fire TV, ou un autre écran avec
   un navigateur », puis « Relier une Fire TV » : une adresse s'affiche, par exemple
   192.168.1.20:8870/tv/4821 (le code de la fin sert une seule fois, 15 minutes).
2. Sur la Fire TV, ouvre l'appli Silk (le navigateur d'Amazon ; sinon installe-la
   depuis l'Appstore, elle est gratuite) et tape cette adresse. Astuce : l'appli
   Fire TV du téléphone permet de la taper avec le clavier du téléphone.
3. Ajoute la page aux favoris de Silk, puis appuie sur OK (le bouton du milieu de la
   télécommande) : le son est permis.
Ensuite, à chaque fois : ouvre ce favori sur la Fire TV, puis choisis « Fire TV »
dans « Regarder sur ». Tant que la page est ouverte, la Fire TV est dans la liste,
comme une TV. Sa télécommande pilote aussi la lecture : OK ou Lecture/Pause pour la
pause, gauche et droite pour reculer ou avancer de 10 secondes (photos : la
précédente, la suivante), Retour pour arrêter.
Si l'adresse de l'ordinateur change (box redémarrée), relie de nouveau la Fire TV.
Pour l'éviter, réserve l'adresse de l'ordinateur dans les réglages de ta box
(« bail statique », « réservation DHCP »). « Oublier », dans la même rubrique, délie
un écran. La même page marche sur une console, une TV ou un ordinateur avec un
navigateur : relie-les de la même façon.


AirPlay (Apple TV, TV compatibles AirPlay)
------------------------------------------
Une Apple TV, ou une TV compatible AirPlay (Samsung, LG, Sony récentes…), reçoit
les films par Safari, qui les envoie en AirPlay :
- Sur le Mac : « Regarder sur » > « Fire TV, AirPlay, ou un autre écran avec un
  navigateur » > « AirPlay depuis ce Mac ». Safari s'ouvre sur la page de l'écran,
  déjà relié : clique sur « Choisir la TV (AirPlay) » et choisis la TV.
- Sur un iPhone ou un iPad : « Relier une Fire TV » donne une adresse ; tape-la dans
  Safari, puis « Choisir la TV (AirPlay) ».
Ensuite, choisis « AirPlay (Safari) » (ou « iPhone (AirPlay) ») dans « Regarder
sur » : les films passent sur la TV choisie, tant que la page reste ouverte dans
Safari. Les sous-titres sont incrustés dans l'image (Safari ne les envoie pas en
AirPlay), ce qui demande de convertir le film pendant la lecture.

Apple TV, envoi direct (expérimental) : une Apple TV (tvOS 15 ou plus récent)
apparaît aussi toute seule dans « Regarder sur », sans Safari. La première fois,
clique sur « Jumeler » sous la liste des TV, puis tape le code de quatre chiffres
que l'Apple TV affiche ; c'est fait une fois pour toutes. Si ça ne marche pas (ce
mode n'a pas encore été essayé sur une vraie Apple TV), passe par Safari.


Installation sur le Mac (une seule fois, quelques minutes)
----------------------------------------------------------
Marche sur les Mac Intel (comme l'iMac 2019) et Apple Silicon, sans Homebrew.

1. Double-clique sur Toupilo.zip (dans Téléchargements) : un dossier
   « Toupilo » apparaît.

2. Dans ce dossier, double-clique sur « Installer-Mac.command ».
   Cette toute première fois, le Mac l'arrête (« Apple n'a pas pu vérifier… »).
   C'est normal pour un programme gratuit qui ne vient pas de l'App Store :
     a. clique « Terminé » ;
     b. ouvre Réglages Système > Confidentialité et sécurité, descends tout en bas :
        « Installer-Mac.command a été bloqué » > « Ouvrir quand même » ;
     c. donne ton mot de passe, puis confirme « Ouvrir quand même ».
   Tu n'auras plus jamais à le faire : la suite est créée sur ton Mac, et le Mac
   ne bloque que ce qui vient d'Internet.
   (Si le bouton n'apparaît pas : ouvre le Terminal, tape « bash » suivi d'une
   espace, glisse « Installer-Mac.command » dans sa fenêtre, puis appuie sur Entrée.)

3. L'installateur range l'application « Toupilo » dans le dossier
   Applications, te la montre dans le Finder, puis la lance. Si « Diffuseur
   maison » (l'ancien nom) était installé, il l'arrête, reprend ses réglages et
   retire l'ancienne application : rien à faire de plus. Au premier lancement,
   il télécharge deux outils gratuits et reconnus, vérifiés par somme de contrôle :
   FFmpeg, le moteur vidéo, et uv, qui fournit Python (rangés dans ton dossier
   personnel : ~/.toupilo et ~/.local). Rien d'autre n'est modifié.

4. Le Mac pose ensuite une ou deux questions, une seule fois. Réponds « Autoriser » :
   - Terminal veut accéder au dossier Téléchargements (ou Documents…) : c'est
     là que sont tes films ;
   - sur certaines versions de macOS, « Terminal » veut trouver des appareils sur
     le réseau local : sans ça, la TV reste introuvable.

5. La page affiche alors « Vérification de l'installation » et contrôle tout seul
   chaque point : le moteur vidéo, tes dossiers de films, la TV, l'autorisation
   « Réseau local », le pare-feu du Mac et un éventuel VPN. Si un point bloque, il
   dit quoi faire en une phrase, et son bouton ouvre directement le bon écran des
   Réglages du Mac (ou, pour le pare-feu, l'autorise d'un clic : le Mac demande
   alors son mot de passe). Quand tout est vert : « Tout est prêt ».
   Tu peux relancer cette vérification quand tu veux : « Vérifier l'installation »,
   tout en bas de la page.

6. C'est fini. Tu peux supprimer le fichier .zip et le dossier « Toupilo ».
   Astuce : glisse l'icône « Toupilo » dans le Dock.

Pour l'installer chez quelqu'un d'autre : envoie-lui le même Toupilo.zip et
ce mode d'emploi. Il n'aura que l'étape 2 à faire à la main (le Mac l'exige pour
tout programme qui ne vient pas de l'App Store), puis à répondre « Autoriser ».


Installation sur un PC Windows (une seule fois, quelques minutes)
-----------------------------------------------------------------
Le même dossier sert pour les Mac et les PC : sur une clé USB, par exemple, chacun
double-clique l'installateur de son ordinateur (« Installer-Mac.command » sur un
Mac, « Installer-Windows » sur un PC). Il faut Windows 10 ou 11 (64 bits) et
Internet pendant l'installation : environ 140 Mo à télécharger (Python, le moteur
du programme, et FFmpeg, le moteur vidéo), vérifiés par somme de contrôle.

1. Copie le dossier « Toupilo » sur le PC (depuis la clé USB, par exemple).
   Si tu as reçu Toupilo.zip : clic droit dessus > « Extraire tout... »
   (pas de lancement depuis l'intérieur du zip).

2. Dans ce dossier, double-clique sur « Installer-Windows ».
   Si Windows affiche « Windows a protégé votre ordinateur » : clique sur
   « Informations complémentaires », puis « Exécuter quand même ». C'est normal pour
   un programme gratuit qui ne vient pas d'une boutique.

3. Une fenêtre montre l'installation étape par étape. Dès le début (étape 3 sur 6),
   Windows demande s'il faut autoriser des modifications : réponds « Oui ». C'est
   pour le pare-feu, afin que la TV et le téléphone de la maison puissent joindre
   Toupilo.

4. C'est fini : Toupilo s'ouvre dans le navigateur, avec la même
   « Vérification de l'installation » que sur Mac. Les fois suivantes, ouvre-le par
   l'icône « Toupilo », sur le Bureau ou dans le menu Démarrer. Le dossier
   copié à l'étape 1 n'est plus utile.

Toupilo est installé pour ce compte Windows seulement (dans
%LOCALAPPDATA%\Programs\Toupilo). Si l'installation n'aboutit pas, un rapport
« Toupilo - rapport d'installation » est posé sur le Bureau : envoie-le à
qui t'a donné Toupilo.

Cas particuliers sur PC :
- Windows « en mode S » (certains PC d'entrée de gamme) n'exécute que les programmes
  de la boutique Microsoft : l'installateur ne peut pas y fonctionner (il faut
  d'abord quitter le mode S, dans Paramètres > Système > Activation).
- Si « Smart App Control » (Windows 11) bloque l'installateur, il faut l'éteindre
  dans Sécurité Windows > Contrôle des applications et du navigateur.
- PC à processeur ARM (Surface Pro X, Snapdragon) : pris en charge (Python ARM64) ;
  FFmpeg y tourne en émulation, la conversion d'un film est alors plus lente.
- Pendant un film, le PC ne se met pas en veille ; un portable fermé peut quand même
  couper le Wi-Fi : garde-le ouvert (ou branché, selon tes réglages d'alimentation).


Utilisation
-----------
Ouvre « Toupilo » (Dock, dossier Applications, Launchpad ou Spotlight).
Rien à taper : la page de Toupilo s'ouvre dans ton navigateur.

Une fenêtre du Terminal s'ouvre aussi : c'est le moteur qui envoie le film à la TV.
Réduis-la si tu veux (bouton jaune), mais ne la ferme pas pendant un film.
Si Toupilo est déjà lancé, l'application ouvre simplement la page (ou sa fenêtre,
voir « Toupilo dans sa propre fenêtre » plus bas).

Sur un PC : icône « Toupilo » (Bureau ou menu Démarrer). Il n'y a pas de
fenêtre à garder ouverte : Toupilo travaille en arrière-plan, et fermer
l'onglet du navigateur ne l'arrête pas (l'icône rouvre la page).

1. Allume la TV (ou le Chromecast, le vidéoprojecteur). Elle apparaît dans la case
   « Regarder sur » au bout de quelques secondes (sur un téléphone : le bouton en
   forme de TV, en haut à droite).
2. Tes films sont pris dans les dossiers Films (Vidéos sur PC) et Téléchargements,
   tes photos dans Images, ta musique dans Musique. La première fois, les affiches
   arrivent en quelques minutes, en arrière-plan.
   Pour un autre dossier (disque externe, disque réseau…) : « Dossiers de films et
   de séries, affiches » en bas de l'espace Films (ou « Ouvrir un fichier… »),
   « Dossiers de photos » en bas de l'espace Photos, « Dossiers de musique » en bas
   de l'espace Musique.
   Un film, une photo ou un morceau ajouté dans ces dossiers apparaît tout seul (et
   disparaît s'il est supprimé) : dès que tu reviens sur la page, sinon dans les
   5 minutes tant qu'elle est ouverte devant toi. Un fichier en cours de
   téléchargement ou de copie apparaît quand il est complet ; les films d'un disque
   débranché restent dans la liste. « Relire les dossiers » fait tout de suite le
   point sur ce qui est vraiment là. Un dossier renommé ou déplacé : ajoute-le de
   nouveau.
3. Clique sur l'affiche d'un film : sa fiche s'ouvre (résumé, genres, durée). Un
   genre, une saga ou une origine de la fiche mène aux films qui lui ressemblent.
   « Bande-annonce » la lit dans la fiche, sur l'écran où est la page (ordinateur ou
   téléphone ; pas sur la TV). Vérifie le son et les sous-titres, puis « Lire sur la
   TV ». « Marquer comme vu » range le film dans les vus ; un film regardé jusqu'au
   bout l'est tout seul.
   Séries : à la fin d'un épisode, la carte de lecture annonce « Épisode suivant
   dans 10 s » puis le lance sur la même TV, avec la même langue et les mêmes
   sous-titres (« Lancer maintenant » n'attend pas, « Annuler » l'en empêche).
   Après trois épisodes de suite sans que personne ne touche à rien, le suivant
   est seulement proposé : « Lancer l'épisode » quand tu es là. Pendant un
   épisode, « Épisode suivant » y passe tout de suite. Pour ne plus rien lancer
   tout seul : décoche « Enchaîner les épisodes » dans la carte de lecture.
4. Télécommande sur un téléphone ou une tablette (iPhone, iPad, Android…) : vise
   le QR code avec l'appareil photo (même Wi-Fi) et ouvre le lien. Pour la garder
   comme une appli : « Partager > Sur l'écran d'accueil » dans Safari, ou
   « ⋮ > Ajouter à l'écran d'accueil » dans Chrome sur Android.
5. « Éteindre l'écran de l'ordinateur » éteint son écran (depuis l'ordinateur ou la
   télécommande) ; le film continue. Le programme empêche l'ordinateur de se mettre
   en veille pendant le film.
6. Pour tout arrêter : « Quitter Toupilo » tout en bas de la page (ou, sur Mac,
   ferme la fenêtre du Terminal).

La recherche, en haut de la page, cherche partout : films, séries, albums photo,
artistes, albums et morceaux de musique.

Toupilo dans sa propre fenêtre
------------------------------
Toupilo peut s'ouvrir dans une fenêtre à lui, comme une application : sans onglet ni
barre d'adresse, avec son icône dans le Dock (Mac) ou la barre des tâches (PC). La
page de l'ordinateur le propose une fois, dans un bandeau en haut ; ensuite,
« Installer comme une appli » reste tout en bas de la page.
  - Chrome ou Edge (Mac et PC) : clique sur « Installer », puis confirme.
  - Safari (Mac, Safari 17 et macOS Sonoma 14 ou plus récents) : clique sur
    « Installer » ; puis, dans la barre des menus, Fichier > Ajouter au Dock…,
    nomme-la « Toupilo (fenêtre) » et clique sur « Ajouter ». Fais-le dans le quart
    d'heure qui suit : la fenêtre se relie toute seule à Toupilo.
La fenêtre s'appelle « Toupilo (fenêtre) » : « Toupilo » tout court reste
l'application qui lance Toupilo. Sur Mac, cette application ouvre ensuite la
fenêtre plutôt qu'un onglet.
Si la fenêtre montre un code à 4 chiffres (Safari après le quart d'heure, ou
Toupilo réinstallé), elle demande la clé de Toupilo : « Ouvrir la page de Toupilo »
ouvre sa page dans le navigateur ; tapes-y ce code, puis « Relier ». La page ne
montre jamais le code : seule ta fenêtre le connaît. Une demande que tu n'as pas
faite (pas de fenêtre Toupilo ouverte) : « Refuser ».
Si Toupilo n'est pas lancé, la fenêtre le dit : « Lancer Toupilo » le démarre, et
elle s'ouvre toute seule dès qu'il répond.
La fenêtre est liée au port 8870 de l'ordinateur. Si un autre programme l'a pris,
Toupilo s'ouvre sur un autre port et le dit ; ferme ce programme (ou redémarre
l'ordinateur), puis rouvre Toupilo.
Pour retirer la fenêtre : dans Chrome ou Edge, son menu (⋮ ou …) > Désinstaller ;
avec Safari, mets « Toupilo (fenêtre) » à la corbeille (dossier Applications de ton
compte : dans le Finder, Aller > Départ, puis Applications).

Les modes de lecture (choix « Automatique » conseillé) :
  - Direct : la TV lit le fichier d'origine. Langue et sous-titres intégrés se
    règlent aussi avec la télécommande de la TV (bouton des options du lecteur).
  - Ré-emballage : image intacte, son adapté. Démarre en quelques secondes.
  - Conversion complète : pour les formats que la TV ne lit pas. Utilise la puce
    vidéo de l'ordinateur si elle répond (Mac, carte NVIDIA, AMD ou Intel), sinon le
    processeur ; image en HD 1080p.


Photos
------
L'espace Photos montre tes photos et tes vidéos personnelles :
  - « Il y a un an » : les photos prises à la même époque, une année passée ;
  - les albums : un album par dossier, tel que tu les as rangés ;
  - les années, mois par mois (date de prise de vue, lue dans la photo, sinon dans
    le nom du fichier) ;
  - les vidéos personnelles, qui se lisent sur la TV comme un film.
Clique sur une photo pour l'agrandir (flèches du clavier ou glisser du doigt pour
passer à la suivante). « Sur la TV » l'affiche sur la TV, qui suit ensuite la
visionneuse ; « Diaporama » (dans la visionneuse, ou « Diaporama sur la TV » en haut
de l'espace) fait passer les photos toutes seules (de 4 à 40 secondes chacune,
réglable dans la carte de lecture, avec pause et photo suivante). Lancer un film ou
de la musique arrête le diaporama, et l'inverse.

Tes photos sont privées : par défaut, elles ne s'affichent que sur l'ordinateur.
Pour les voir aussi sur le téléphone ou la tablette, coche « Montrer les photos sur
la télécommande », dans « Dossiers de photos, confidentialité » (en bas de l'espace
Photos). Les photos de l'app Photos du Mac restent dans sa bibliothèque, que
Toupilo ne lit pas : exporte-les dans un dossier (Photos > Fichier > Exporter).


Musique
-------
L'espace Musique range tes morceaux d'après leurs étiquettes (titre, artiste, album,
numéro, année, genre, pochette) ou, à défaut, d'après les noms des dossiers
(« Artiste/Album/01 - Titre.mp3 ») : Écoutés récemment, Ajoutés récemment, les
genres (regroupés en grandes familles : Rock, Pop, Électro, Jazz & blues, Chanson
française…), les artistes et tous les albums. Un album en plusieurs disques (CD1,
CD2) n'en fait qu'un ; une compilation est rangée sous « Artistes divers ».

Clique sur un album pour voir ses morceaux, puis « Lire » ou « Aléatoire » (ou
clique sur un morceau : l'album joue à partir de lui). « Lecture aléatoire » joue
toute ta musique dans le désordre. Les morceaux s'enchaînent tout seuls ; « Précédent »
et « Suivant » sont dans la carte de lecture.

« Écouter sur » choisit l'appareil qui joue la musique : la TV, ou une enceinte
Google (Nest, Google Home, Chromecast Audio, groupes d'enceintes). Ce choix est gardé
à part de celui de la TV des films. MP3, AAC (M4A), FLAC, Ogg, WAV… : un format que
l'appareil ne lit pas est converti en MP3 pendant l'écoute. Les morceaux d'un
abonnement (Apple Music, Spotify, Deezer…) sont protégés et ne peuvent pas être
lus ; ceux que tu as achetés ou importés, oui.


Masquer de Toupilo
------------------
Un film que tu ne regarderas pas, un album en double, des photos que tu préfères ne
pas montrer : masque-les, sans toucher aux fichiers (sur l'ordinateur seulement).
  - un film : « Masquer de Toupilo » dans sa fiche ; un épisode ou toute la série :
    « Masquer l'épisode » ou « Masquer toute la série » ;
  - un morceau : l'œil barré au bout de sa ligne ; un album : « Masquer l'album » ;
  - une photo : l'œil barré de la visionneuse ; un album photo : « Masquer l'album ».
Ce qui est masqué disparaît partout : listes, recherche, lecture aléatoire,
diaporamas, télécommande ; plus rien n'est cherché sur Internet pour un film masqué.
Une série, un album ou un album photo masqués le restent avec leurs nouveaux
épisodes, morceaux ou photos. Avant de masquer, une fenêtre dit ce qui va
disparaître, que rien n'est supprimé, et comment revenir en arrière : « Masquer » la
valide, « Annuler » (ou Échap) n'y touche pas. Juste après, « Annuler » dans le
message défait encore le masquage.
« Éléments masqués », en bas de chaque espace, permet de tout réafficher. Un fichier
renommé ou déplacé réapparaît de lui-même (l'ancienne entrée est alors signalée
« introuvable » : « Retirer de la liste » la fait disparaître). Un film masqué que tu
ouvres toi-même (« Ouvrir avec » Toupilo) s'affiche quand même.


Clé TMDB personnelle (facultatif)
---------------------------------
Les fiches viennent d'abord de TMDB, avec la clé de Toupilo : rien à régler. Si tu
préfères ta propre clé gratuite (compte sur themoviedb.org, puis Paramètres > API,
« clé d'API »), colle-la dans « Dossiers de films et de séries, affiches » > « Clé
TMDB » : elle passe avant celle de Toupilo. Les clés restent sur l'ordinateur
(jamais envoyées au téléphone) ; « Retirer » supprime la tienne.


Ta TV : ce qu'elle sait lire
----------------------------
Toutes les TV ne lisent pas les mêmes formats : selon la marque et l'année, l'une
refuse l'image HEVC des films 4K, l'autre le son DTS ou le Dolby Digital, une autre
encore ne montre pas les sous-titres envoyés à part ; et un Wi-Fi juste fait
saccader les films très lourds. Toupilo convertit pendant la lecture ce que la TV ne
lit pas. Sous le nom de la TV, la page montre ce qu'elle lit directement et ce que
Toupilo convertit.

Test de lecture (deux minutes, une fois pour toutes) : « Tester la lecture », sous
l'appareil choisi ; il est proposé tout seul la première fois. De courts extraits
passent sur la TV : une mire de couleurs qui bouge, des bips à gauche puis à droite,
un sous-titre. Pour chacun, réponds Oui ou Non à une à trois questions (« Tu vois la
mire bouger ? », « Tu entends les bips ? ») ; ce que la TV refuse, Toupilo le voit
tout seul. Il vérifie l'image HEVC et AV1, le son Dolby Digital et DTS, les
sous-titres, et si le réseau suit un film 4K : sinon, des extraits plus légers
disent jusqu'où il suit, et les films plus lourds seront convertis, plus légers.
Il marche pour toutes les marques de TV et de vidéoprojecteurs, les Chromecast, les
écrans Toupilo (Fire TV) et l'Apple TV, depuis l'ordinateur ou le téléphone. Ce
qu'il a vérifié s'affiche sous la TV (« test de lecture ») et passe avant tout le
reste, sauf un format forcé à la main ; « Refaire le test » quand tu veux. Après un
film qui n'a pas pu être lu, la page le propose aussi.

Sans test, pour une TV LG, Toupilo connaît les formats de chaque année : le son DTS
oui jusqu'en 2019, non de 2020 à 2022, oui en 2023 et 2024, non depuis 2025 ; la
vidéo AV1 depuis 2020. Dès que la TV est trouvée, le programme lui demande sa
version de webOS (sans appairage : rien ne s'affiche sur la TV), qui donne son
année. Si le nom d'origine de la TV est resté (« [LG] webOS TV OLED55C1PUB »), le
modèle y est lu directement. Quand webOS est mis à jour, le test est proposé de
nouveau.

Les TV LG compatibles AirPlay annoncent aussi leur référence sur le réseau : le
programme l'y lit, même si la TV a été renommée. Quand le modèle reste incertain
(une TV de 2022 ou après, dont webOS a été mis à jour), le DTS est converti par
précaution : le film marche quand même, et il n'y a rien à faire.

Facultatif : « Modèle et formats de la TV » permet d'indiquer le modèle d'une TV LG
(par exemple OLED55C3, dans les paramètres de la TV, rubrique « À propos de cette
TV »), ou de forcer un format à la main ; « Revenir au réglage automatique » annule
ce choix. Pour une TV d'une autre marque, la rubrique s'appelle « Formats de la
TV » : seuls les formats se règlent. Sans test de lecture, les formats douteux sont
convertis par précaution : le film marche quand même.


Chromecast et Google TV
-----------------------
Les Chromecast, et les TV ou vidéoprojecteurs avec Chromecast intégré, apparaissent
tout seuls dans la liste des TV dès qu'ils sont allumés sur le même Wi-Fi (la carte
TV affiche « Google Cast »). Rien à installer sur l'appareil : Toupilo lance le
lecteur de Google, qui lit le film depuis l'ordinateur.

  - Un MP4 courant est lu tel quel. Les autres fichiers (MKV…) sont ré-emballés à
    la volée : l'image reste intacte, le son est converti en AAC, que tous les
    appareils Google Cast lisent. Si le test de lecture montre que l'appareil lit
    le Dolby Digital (un Chromecast avec Google TV relié à un ampli, par exemple),
    ce son-là passe tel quel.
  - Sous-titres, pause, déplacement, volume : depuis la page ou le téléphone. Avec
    une télécommande Google TV, pause et lecture marchent aussi.
  - Si l'appareil refuse un film tel quel (les premiers Chromecast ne lisent pas le
    HEVC), Toupilo le convertit aussitôt, sans rien demander, et s'en souvient
    pour les films suivants.
  - « Arrêter » ferme le lecteur : l'appareil revient à son écran d'accueil.


D'un endroit à l'autre (bureau, maison…)
------------------------------------------
La liste « Regarder sur » ne garde que les appareils là où tu es : une TV vue au
bureau en sort dès que l'ordinateur change de réseau, et une TV éteinte depuis une
demi-heure aussi. Elles reviennent toutes seules quand elles répondent de nouveau,
avec leurs réglages. Si la TV choisie n'est pas là, Toupilo prend celle dont tu
t'es servi en dernier parmi celles qui répondent (ta TV de la maison en rentrant).
Un appareil que tu ne veux pas voir (écran d'un collègue, enceinte…) : choisis-le,
puis « Ignorer cet appareil », juste en dessous (sur l'ordinateur). « Appareils
ignorés » permet de le remettre.

Plusieurs TV : la liste montre le nom de chaque appareil, suivi de sa marque et de
son modèle quand le nom ne les dit pas (« Télé · Samsung UE55Q80T ») ; deux appareils
au même nom sont départagés par la fin de leur adresse. Sous l'appareil choisi (sur
l'ordinateur) :
  - « Identifier » : une TV affiche quelques secondes « C'est moi : <son nom> », une
    enceinte joue un petit carillon. Pratique avec deux TV du même modèle.
  - « Renommer » : donne-lui ton propre nom (Salon, Chambre, Bureau…), montré
    partout, sur la télécommande aussi. La TV garde le sien ; un nom vide le lui
    rend.


Si ça ne marche pas
-------------------
- Commence par « Vérifier l'installation » (tout en bas de la page) : chaque point
  qui bloque y est expliqué, avec le bouton qui va bien.
- Sur un Mac, une fenêtre propose d'installer des « outils de ligne de commande » :
  clique « Annuler », Toupilo n'en a pas besoin. (Depuis la 1.5.1, il évite de
  la faire apparaître.)
- La TV n'apparaît pas : dans la carte « Regarder sur », ouvre « La TV n'apparaît
  pas ? » puis « Diagnostiquer le réseau » : la page dit ce qui bloque et quoi faire
  (pare-feu, VPN, autre réseau, réglage de la TV selon sa marque). Tu peux aussi y
  donner l'adresse de la TV : la page dit où la trouver dans ses paramètres, selon sa
  marque (celle de ta TV habituelle quand c'est elle qui manque, sinon celle des
  appareils trouvés ; tu peux en choisir une autre). En général : Réseau, puis
  « État du réseau » ou « Informations ». La page ou l'application de ta box
  l'indique aussi, dans la liste des appareils connectés. Le diagnostic dit aussi
  quel réglage activer sur la TV selon sa marque (« LG Connect Apps » sur certaines
  LG, « Renderer » sur une Sony…). Une Fire TV se relie par son navigateur (voir
  « Fire TV »), une Apple TV par AirPlay (voir « AirPlay »).
- La page dit « Ouvre Toupilo depuis son application » : c'est une protection
  (voir « Sécurité »). Ouvre simplement l'application « Toupilo » (sur PC :
  son icône).
- Sur PC, la TV ne trouve pas les films, ou le téléphone ne se connecte pas : c'est
  souvent le pare-feu de Windows. Dans « Vérifier l'installation », clique sur
  « Autoriser Toupilo » et réponds « Oui » (ou relance « Installer-Windows »).
  Un antivirus avec son propre pare-feu (Norton, Kaspersky…) peut aussi demander
  d'autoriser « Python ».
- La TV affiche « format non pris en charge », ou un film ne se lance pas : fais le
  test de lecture (« Tester la lecture », sous la TV, ou sous le film refusé) ;
  Toupilo saura ensuite quoi convertir. Sinon, relance le film en mode
  « Ré-emballage », puis « Conversion complète » si besoin.
- La TV ne reprend pas là où tu t'étais arrêté (la page le signale) : avance avec
  la barre de lecture ; l'endroit mémorisé n'est pas perdu.
- Pas de son : fais le test de lecture (il vérifie le Dolby Digital et le DTS), ou,
  dans « Modèle et formats de la TV », vérifie le modèle indiqué (ou décoche « Ma
  TV lit le son DTS »), ou choisis une autre piste dans la fiche.
- La page dit « modèle pas encore connu » : la TV n'a pas répondu à la question sur
  sa version de webOS. Ce n'est pas grave (le DTS est converti par précaution). Sur
  certaines LG, « LG Connect Apps » (ou « Mobile TV On ») doit être activé dans les
  paramètres réseau de la TV.
- Un Chromecast ou un vidéoprojecteur Google TV n'apparaît pas : allume-le, vérifie
  qu'il est sur le même Wi-Fi que l'ordinateur (pas le Wi-Fi « invité »), puis clique
  sur « Rechercher ». Sur le Mac, l'autorisation « Réseau local » doit être donnée.
- Pas de sous-titres : active-les dans le lecteur de la TV, ou coche « Incruster
  les sous-titres dans l'image ». Le test de lecture vérifie si la TV les affiche :
  sinon, ils seront incrustés d'office.
- Démarrage lent avec des sous-titres intégrés au film : sur un très gros fichier,
  leur préparation peut prendre jusqu'à 2 minutes la première fois (ensuite c'est
  immédiat). S'ils sont illisibles, le film se lance sans eux et la page le dit.
- Saccades sur un gros fichier 4K : le Wi-Fi est peut-être trop juste. Le test de
  lecture mesure jusqu'où le réseau suit : les films plus lourds seront ensuite
  convertis, plus légers. Tu peux aussi choisir « Conversion complète », ou relier
  l'ordinateur à la box par câble.
- Une affiche manque, ou ce n'est pas le bon film : le programme reconnaît les films
  d'après le nom du fichier (et, au besoin, celui de son dossier). Un nom « Titre
  (année) » marche le mieux, par exemple « Le Comte de Monte-Cristo (2024).mkv ».
  Renomme le fichier, puis clique sur « Relire les dossiers » (dans « Dossiers de
  films et de séries, affiches », en bas de l'espace Films). Dans la fiche, « Pas le
  bon film ? » retire une mauvaise fiche (le film garde alors le nom de son fichier).
  Sous le résumé, une ligne grise dit d'où viennent l'affiche et le résumé, ou
  pourquoi le film n'a pas été trouvé.
- Pas d'affiches du tout : sans Internet, une image tirée du film les remplace ; le
  programme réessaie tout seul une heure plus tard, ou tout de suite avec « Relire
  les dossiers ».
- Une photo apparaît grise (« photo illisible ») : c'est souvent une photo HEIC
  (iPhone) que FFmpeg ne sait pas lire. Sur Mac, Toupilo passe alors par l'outil
  d'images du Mac, qui les lit toutes. Sur PC, si elles restent grises, règle
  l'iPhone sur « Le plus compatible » (Réglages > Appareil photo > Formats) ou
  convertis-les en JPEG.
- Les photos n'apparaissent pas sur le téléphone : c'est voulu (photos privées),
  voir « Photos ».
- Un morceau ne s'affiche pas sous le bon album ou le bon artiste : ses étiquettes
  sont incomplètes. Corrige-les (dans l'app Musique : Lire les informations), ou
  range le fichier dans « Artiste/Album/ ».
- Le « journal technique » (lien en bas de la page) aide à comprendre une panne.


Mettre à jour
-------------
Toupilo regarde une fois par jour sur toupilo.com s'il existe une nouvelle version
(rien d'autre n'est envoyé que son numéro de version). Quand il y en a une, un
bandeau en haut de la page la propose avec ses nouveautés : « Installer »
télécharge le fichier, le vérifie (empreinte, puis signature), l'installe et
redémarre ; la page se recharge. « Plus tard » met le bandeau de côté pour un
jour. Pour ne plus rien vérifier : décoche « Vérifier les nouvelles versions »,
tout en bas de la page (« Vérifier maintenant » juste à côté).

À la main, c'est toujours possible : télécharge le nouveau Toupilo.zip (sans le
décompresser), puis tout en bas de la page, « Installer une mise à jour… » et
choisis ce fichier. Toupilo s'installe, redémarre et la page se recharge. Tes
réglages, tes dossiers, tes reprises, tes films vus, tes affiches et FFmpeg sont
conservés. Depuis la 1.3.1 ou une version plus récente, la mise à jour se fait
ainsi, en une fois.
(Si le Mac a déjà décompressé le zip : clic droit sur le dossier Toupilo >
Compresser, puis choisis le .zip obtenu.)

Depuis la version 1.2 ou 1.3.0 : la page demande de choisir le fichier une seconde
fois, pour terminer (ces versions ne savaient installer qu'une partie des fichiers).
Depuis une version 1.0 ou 1.1 : décompresse le zip et double-clique
« Installer-Mac.command » (le Mac le bloque une dernière fois, comme à l'installation).

Sur un PC, la mise à jour se fait de la même façon depuis la page (avec le fichier
Toupilo.zip). Avec un nouveau dossier (clé USB), relance simplement
« Installer-Windows » : ce qui est déjà installé n'est pas retéléchargé, et tes
réglages sont conservés. Si tu utilisais l'ancien « Lancer-Windows.bat », passe par
« Installer-Windows » : tu retrouves tes réglages.

Chaque Toupilo.zip est signé par l'auteur : Toupilo vérifie cette
signature avant d'installer quoi que ce soit, et refuse un fichier modifié, d'une
autre provenance, ou d'une version plus ancienne que celle en place. Pour revenir
malgré tout à une ancienne version : quitte Toupilo et réinstalle-la avec son
installateur (Installer-Mac.command ou Installer-Windows).


Sécurité
--------
- Le programme n'est joignable que depuis ton réseau local.
- La page complète (dossiers, réglages, mises à jour, bouton Quitter) ne s'ouvre
  que par le lien que donne l'application, avec une clé secrète propre à ton
  compte : un autre compte de l'ordinateur, un autre programme ou un site piégé ne
  peut ni la piloter, ni installer une fausse mise à jour. (Sur un ordinateur
  partagé avec des inconnus, quitte Toupilo après usage : la clé reste gardée
  par le navigateur tant que la page est ouverte.)
- Le dossier des réglages (~/.toupilo) n'est lisible que par ton compte.
- Chaque film, photo ou morceau envoyé à la TV a une adresse secrète, valable le
  temps de la lecture.
- Les photos et les vidéos personnelles ne s'affichent que sur l'ordinateur, tant que
  tu n'as pas permis de les voir sur la télécommande.
- La télécommande du téléphone ou de la tablette passe par un lien secret ;
  « Changer le lien » désactive l'ancien (le téléphone affiche alors qu'il faut
  scanner le nouveau QR code).
- Pour connaître le modèle de la TV, le programme lui demande seulement sa version
  de webOS : pas d'appairage, aucun accès à la TV n'est demandé.
- Un appareil du Wi-Fi qui se ferait passer pour la TV est ignoré, et un appareil
  qui ouvrirait des centaines de connexions ne peut pas bloquer le programme.
- Les mises à jour sont signées : un Toupilo.zip modifié ou qui ne vient pas
  de l'auteur est refusé.


Pour qui veut modifier le programme
-----------------------------------
Le programme est rangé un fichier par rôle, dans le dossier « toupilo » ; la liste
des fichiers et leur rôle est en tête de toupilo_lanceur.py (le lanceur, livré aussi
sous son ancien nom, diffuseur.py, pour les installations d'avant). La page est
dans interface.html, interface.css et interface.js (le cœur), appareils.js,
essai.js, lecteur.js, fiche.js, reglages.js, fenetre.js, puis un fichier par
espace : bibliotheque.js (Films et Séries), photos.js et musique.js ; ses images
sont à côté (icônes, logo, logo de TMDB). Toupilo dans sa propre fenêtre :
appli.json, sw.js et la page « pas lancé » (hors-ligne.html, .css, .js). La page
d'un écran de Toupilo (Fire TV) : ecran.html, .css et .js. Le programme n'a besoin
que de Python et de FFmpeg. L'installation Windows est dans programme/windows
(scripts PowerShell : installation, désinstallation, pare-feu). Le dépôt de
développement (Toupilo-sources-x.y.z.zip) contient en plus les tests, l'outil de
construction et de signature des mises à jour, le générateur du site et la
documentation (architecture, sécurité, feuille de route) : c'est lui qu'il faut
reprendre pour une nouvelle version, car un Toupilo.zip non signé est refusé par
les installations.


Crédits
-------
Les fiches des films et des séries viennent d'abord de TMDB.
This product uses the TMDB API but is not endorsed or certified by TMDB.
(Toupilo utilise l'API de TMDB, sans être approuvé ni certifié par TMDB.)
À défaut : la boutique Apple, Wikipédia (textes sous licence CC BY-SA 4.0) et
Wikidata. Les outils et leurs licences (FFmpeg, Python, uv, qrcode) : « À propos de
Toupilo et crédits », tout en bas de la page, et toupilo.com/licences.


Désinstaller
------------
Sur PC : Paramètres > Applications > Applications installées > « Toupilo »
> Désinstaller. Il demande s'il faut aussi effacer tes réglages ; Windows demande
« Oui » pour retirer l'autorisation du pare-feu.

Sur Mac :
1. Glisse « Toupilo » du dossier Applications vers la Corbeille.
2. Dans le Finder : menu Aller > Aller au dossier…, tape ~/.toupilo et
   mets ce dossier à la Corbeille (réglages, affiches, vignettes des photos,
   pochettes, journal et FFmpeg).
3. Pour retirer aussi uv (Python), tape dans le Terminal :
       uv cache clean; rm -rf ~/.local/share/uv ~/.local/bin/uv ~/.local/bin/uvx \
           ~/.local/bin/env ~/.local/bin/env.fish ~/.config/uv
