Obtenir une Playlist

Qu'est-ce que M3U ?

M3U (et sa variante M3U8) est un format de playlist en texte brut, conçu à l'origine pour les lecteurs audio et devenu le standard de facto pour les playlists de diffusion. Un fichier M3U ne contient aucune vidéo ni audio en lui-même — c'est simplement une liste d'adresses de flux, une par ligne, avec quelques métadonnées optionnelles au-dessus de chacune.

Voici un exemple minimal et annoté :

#EXTM3U
#EXTINF:-1 tvg-id="demo.source" tvg-logo="https://example.com/logo.png" group-title="Actualités",Source Actualités Démo
https://example.com/live/demo-source.m3u8

• #EXTM3U — première ligne obligatoire, indique qu'il s'agit d'une playlist M3U étendue.
• #EXTINF — une ligne de métadonnées par flux : un espace réservé pour la durée (-1 pour les flux en direct), des attributs optionnels comme tvg-id (utilisé pour faire correspondre les données du guide XMLTV), tvg-logo, et group-title (utilisé pour le regroupement par catégorie), suivis d'un nom d'affichage.
• La dernière ligne est l'URL du flux proprement dite — généralement une adresse HLS se terminant par .m3u8, parfois un flux MPEG-TS direct.

Une playlist peut contenir un seul flux ou plusieurs milliers. LoomiTV lit le fichier (ou une URL qui en renvoie un), regroupe les entrées par group-title, et utilise tvg-logo et tvg-id pour les icônes et la correspondance avec le guide.

Qu'est-ce que XMLTV ?

XMLTV est le format XML standard pour les données de guide de programmes (EPG) — ce qui est diffusé, quand, sur quel flux. C'est un fichier distinct de votre playlist M3U ; les deux sont liés en faisant correspondre le channel id du fichier XMLTV à l'attribut tvg-id de vos entrées M3U.

Un exemple minimal :

<tv>
  <channel id="demo.source">
    <display-name>Source Actualités Démo</display-name>
  </channel>
  <programme start="20260810180000 +0000" stop="20260810183000 +0000" channel="demo.source">
    <title>Titre de Programme Exemple</title>
    <desc>Description de programme d'exemple.</desc>
  </programme>
</tv>

Toutes les sources ne fournissent pas de données XMLTV. Si la vôtre n'en fournit pas, LoomiTV lit quand même tous les flux de votre fichier M3U — vous n'aurez simplement pas de guide de programmes, seulement une grille en direct des noms de flux.

Utiliser une playlist iptv-org

iptv-org est un vaste dépôt open-source, maintenu par la communauté, de liens de flux publics et en clair, organisés par pays et par catégorie. C'est un projet réel sur GitHub, non affilié à LoomiTV.

1. 1Rendez-vous sur le dépôt iptv-org à l'adresse github.com/iptv-org/iptv.
2. 2Ouvrez le répertoire /streams et choisissez un fichier par pays ou par catégorie — chacun est un simple fichier .m3u, consultable directement dans le navigateur.
3. 3Utilisez l'affichage « Raw » de GitHub pour obtenir une URL de fichier directe (elle commencera par raw.githubusercontent.com).
4. 4Dans LoomiTV, choisissez « Playlist M3U » comme type de connexion et collez directement cette URL brute — aucun téléchargement nécessaire.

iptv-org vérifie et supprime périodiquement les liens morts, mais la disponibilité n'est garantie pour aucun flux individuel — c'est un index maintenu par des bénévoles, pas un service avec des garanties de disponibilité.

Jellyfin & Plex (auto-hébergé)

Jellyfin et Plex sont des plateformes de serveur multimédia auto-hébergées. Leurs fonctionnalités de TV en direct reposent exactement sur les mêmes standards que LoomiTV : vous configurez une source de type tuner à l'aide d'une playlist M3U et, éventuellement, d'un guide XMLTV — généralement depuis un boîtier tuner réseau (comme un HDHomeRun) ou une autre source M3U/XMLTV que vous êtes autorisé à utiliser.

Une fois la configuration TV en direct / tuner de votre serveur effectuée, cherchez dans ses réglages TV en direct l'URL de la playlist M3U et l'URL du guide XMLTV qu'il utilise ou expose sur votre réseau local — le chemin exact dans les menus varie selon la version, consultez donc la documentation de votre serveur pour la procédure actuelle. Collez cette URL M3U dans LoomiTV comme pour toute autre source, ainsi que l'URL XMLTV si votre serveur en expose une séparément.

Ceci concerne le contenu auquel vous êtes autorisé à accéder via votre propre configuration serveur — vos propres enregistrements, votre propre matériel tuner, ou des sources que vous êtes déjà en droit d'utiliser.

Sources compatibles avec l'API Xtream

Certains serveurs multimédias utilisent une autre méthode de connexion : l'API compatible Xtream. Au lieu d'une seule URL de playlist, elle utilise trois champs distincts — une adresse de serveur, un nom d'utilisateur et un mot de passe — qui vous sont fournis par l'exploitant de ce serveur.

Dans LoomiTV, choisissez « API compatible Xtream » comme type de connexion et saisissez les trois champs exactement tels qu'ils vous ont été fournis. Une faute de frappe dans l'adresse du serveur ou le port est la cause la plus fréquente d'échec de connexion. LoomiTV se connecte directement depuis votre appareil à ce serveur ; il ne voit ni ne stocke rien au-delà de ce que vous saisissez.

Dépannage