Skip to content

Films et Series

khalilbenaz edited this page Jun 23, 2026 · 7 revisions

Films & Séries

Les sections Films (VOD) et Séries présentent ton catalogue façon plateforme de streaming, enrichi par TMDB.

Navigation

  • Hero en tête + rails horizontaux : Tendances (numérotées, triées par note), Dernières sorties, Récemment ajoutés, 4K · UHD. Les rails restent globaux et constants quand on change de catégorie (seule la grille filtre).
  • Grille à défilement infini (v1.15.2) : les contenus se chargent en continu au scroll (par lots de 60), plus de pagination à cliquer. Catégories cliquables.
  • Fiche détaillée (films) : affiche, note, synopsis, genres, casting avec photos des acteurs.

Enrichissement TMDB

Affiches, notes, synopsis, genres et casting sont récupérés via TMDB. Activable et configurable dans Réglages → Enrichissement TMDB (langue des métadonnées : français / anglais / arabe).

🔒 Depuis v1.11.1 : les appels TMDB passent par un proxy (Cloudflare Worker ktv-tmdb) qui garde le token côté serveur — plus de token embarqué dans l'app. Tu peux toujours renseigner ta propre clé TMDB v4 (appel direct).

Lecture, reprise & enchaînement

  • Reprise de lecture (films et séries) : la position est mémorisée et proposée à la relecture (« ▶ Reprise à … » avec option Recommencer). La barre de progression et le temps restant s'affichent sur les vignettes et dans Reprendre la lecture (accueil).
  • Enchaînement automatique de l'épisode suivant — et de la saison suivante en fin de saison (v1.13.1).

Marquer comme vu

  • Automatique : un film/épisode terminé (≥ 90 % ou fin de lecture) est marqué vu.
  • Affiches : badge ✓ Vu sur les films (grille, accueil, catégories, recherche) et les séries (série entière) — bascule manuelle au survol (v1.15).
  • Fiche film : bouton ☆/✓ Vu (v1.15).
  • Fiche série : bouton ☆/✓ Vu (série entière) + un ✓ par épisode dans la liste (v1.15). Quand tous les épisodes d'une saison sont vus, la saison porte un ✓ dans le sélecteur.
  • Synchro Trakt bidirectionnelle (v1.13.3 / v1.15) : tout marquage (film, série entière, épisode) ajoute/retire de l'historique Trakt ; inversement, ce qui est déjà vu sur Trakt est marqué vu dans KTV. L'appariement se fait par ID TMDB exact (v1.15.1) (plus de mauvaise série homonyme). (Trakt doit être connecté ; sinon le ✓ reste local.)
  • Cohérence d'affichage (v1.15.3) : marquer un contenu met à jour toutes ses affiches à l'écran instantanément.
  • Pistes audio / sous-titres, PiP, plein écran, raccourcis clavier (voir Live TV).

Synchronisation Trakt

Lie ton compte Trakt pour le marquage vu automatique (à ~90 % de la lecture, avant le générique, y compris depuis « Reprendre ») et l'ajout à la watchlist.

🔁 Synchro « vu » bidirectionnelle (v1.13.3) :

  • Trakt → KTV : les films/épisodes déjà vus sur Trakt sont marqués vus dans KTV (films appariés par titre+année, épisodes par série+saison+épisode) — récupéré au démarrage et à la connexion.
  • KTV → Trakt : la bascule manuelle ✓ Vu (films) et l'auto-marquage à ≥90 % ajoutent/retirent de l'historique Trakt.

Configurer Trakt :

  1. Crée une application sur trakt.tv/oauth/applications avec Redirect URI = urn:ietf:wg:oauth:2.0:oob.
  2. Dans KTV → Réglages → Synchronisation Trakt, colle le Client ID et le Client Secret.
  3. Connecte-toi via « Connecter (code device) » (code à saisir sur trakt.tv/activate) ou via PIN.

Téléchargements

  • Films et séries (épisode, saison entière ou série complète).
  • Mis en file et traités un par un (respect de la limite d'une seule connexion fournisseur), avec tiroir de progression.

🎬 Formats non supportés (MKV, AVI, WMV…) (v1.14) : KTV les convertit automatiquement à la volée (relais ffmpeg dédié → HLS local, remux ou transcode matériel) pour les lire dans le lecteur intégré — sans dépendance externe, identique macOS/Windows. Le repli se déclenche aussi si la lecture échoue (ex. codec HEVC). En dernier recours, tu peux toujours télécharger le fichier et l'ouvrir dans VLC.

➡️ Voir aussi Guide TV & EPG.

Clone this wiki locally