Documentation

SIVO documentation

De l'installation en une ligne jusqu'aux abonnés qui regardent dans leurs applications.

Installation rapide

Un panneau en quelques minutes, avec une seule commande.

Exécutez-le en root sur un serveur Ubuntu 24.04 ou 26.04 neuf (x86_64) dans votre réseau.

Consultez le guide d'installation complet
Ubuntu — bash
curl -fsSL https://sivo.securytik.com/install.sh | sudo bash

Prise en main

Vue d'ensemble

SIVO est une plateforme IPTV que vous exploitez sur votre propre serveur, dans votre réseau. Elle récupère chaque chaîne en direct depuis Internet une seule fois et la sert à chaque abonné qui la regarde ; le coût de liaison montante d'une chaîne ne croît donc pas avec son audience. Films, séries et enregistrements de rattrapage résident sur le même serveur.

Les abonnés regardent dans les applications qu'ils utilisent déjà : IPTV Smarters, TiviMate, VLC, applications des téléviseurs connectés. SIVO parle l'API Xtream Codes et M3U : il vous suffit donc de leur envoyer une adresse de serveur, un nom d'utilisateur et un mot de passe, ou un seul lien M3U.

  • Le panneau (port 80) sert à gérer les chaînes, les contenus et les abonnés.
  • La porte de diffusion (port 8080 par défaut) est celle à laquelle se connectent les applications ; chaque requête y est vérifiée : compte activé, non expiré, forfait autorisant la chaîne, nombre d'appareils simultanés.

Prise en main

Prérequis

  • Ubuntu 24.04 ou 26.04, x86_64 (amd64). ARM et Docker ne sont pas pris en charge.
  • 4 cœurs CPU et 8 GB de RAM pour quelques centaines de spectateurs ; davantage de spectateurs demandent plus de réseau que de CPU, car les chaînes sont copiées, non réencodées.
  • Disque pour la bibliothèque et le rattrapage : un film fait 1 à 20 GB, une journée de rattrapage d'une chaîne HD environ 30 à 40 GB.
  • Un accès réseau depuis Internet pour récupérer les chaînes, et depuis vos abonnés jusqu'au serveur.

Prise en main

Installation

Exécutez en root sur un serveur neuf :

curl -fsSL https://sivo.securytik.com/install.sh | sudo bash

L'installateur télécharge la dernière version signée (depuis GitHub, ou depuis le miroir dl.securytik.com si GitHub est bloqué), installe PostgreSQL, le moteur de diffusion, nginx et le panneau, puis affiche le mot de passe administrateur à la fin. Le relancer est sans danger : vos données et réglages sont conservés.

Prise en main

Première connexion

Ouvrez http://SERVER-IP/admin/ et connectez-vous en tant que admin avec le mot de passe affiché par l'installateur. Modifiez-le depuis votre profil.

  • Paramètres → Diffusion : définissez l'adresse publique utilisée par les abonnés (par exemple http://tv.example.net:8080). Elle figure dans chaque identifiant de connexion et chaque lien M3U.
  • Chaînes en direct → Chaînes de démarrage : ajoute les chaînes gratuites que les diffuseurs émettent eux-mêmes.
  • Système → Licence : enregistrez l'installation avec votre compte SecuryTik (l'offre Gratuite couvre 100 utilisateurs).

Prise en main

Réglages de diffusion

  • Adresse publique et port : ce à quoi se connectent les applications.
  • Qualité récupérée depuis les sources : la meilleure disponible, ou un plafond (1080p, 720p, 576p, 480p) si votre ligne Internet est petite.
  • Les connexions inactives se terminent d'elles-mêmes après le délai que vous avez défini.
  • Dossier média : où sont stockés les films, séries et rattrapages.

Contenu

Chaînes en direct

Ajoutez une chaîne avec son adresse source (HLS, RTMP, RTSP, SRT, UDP) et une source de secours facultative. Une chaîne à la demande démarre à l'ouverture par le premier spectateur et s'arrête une minute après le départ du dernier ; désactivez la demande pour les chaînes qui doivent toujours tourner.

  • État : diffusion, inactif, ou écran sans signal (la source ne répond pas ; les spectateurs voient votre écran).
  • Le numéro, la catégorie, le logo et l'ID du guide sont ce que les applications affichent.
  • Importer M3U ajoute beaucoup de chaînes d'un coup, depuis un fichier ou une adresse.

Contenu

Écran sans signal

Lorsqu'une source ne répond pas, les spectateurs voient l'écran de SIVO au lieu d'une erreur d'application, et l'image revient d'elle-même quand la source redevient disponible. Modifiez ses deux lignes de texte, ou téléversez votre propre image, dans Paramètres → Écran sans signal.

Contenu

Sources et importations

Les sources regroupent les comptes fournisseurs (Xtream Codes) dont vous détenez les droits. Ajoutez le serveur, le nom d'utilisateur et le mot de passe ; SIVO vérifie la connexion et lit les chaînes en direct, films et séries du compte. Ce que vous ajoutez relève de votre responsabilité : voir les Conditions et Politique.

  • Ouvrez un compte, filtrez par type ou catégorie, recherchez, cochez les titres souhaités et choisissez Importer la sélection.
  • Films et épisodes sont téléchargés sur votre serveur par une seule file, un fichier à la fois, ainsi un compte qui n'autorise qu'une connexion n'est jamais utilisé deux fois. Ils apparaissent dans les applications une fois téléchargés.
  • Une série est importée avec toutes les saisons et tous les épisodes disponibles chez le fournisseur, ainsi que les affiches et le synopsis.
  • Les chaînes en direct importées depuis un compte sont récupérées depuis celui-ci pendant qu'un spectateur les regarde ; chaque chaîne regardée au même moment utilise l'une des connexions du compte.

N'importez que les contenus que vous avez le droit de distribuer.

Contenu

Films

  • Téléversez un fichier, ou indiquez son adresse et choisissez Stocker sur ce serveur pour le télécharger.
  • Le statut indique : en file d'attente, téléchargement avec son pourcentage, prêt ou erreur.
  • Synopsis, distribution, réalisateur, affiche et image de fond à la main ou depuis TMDB (ajoutez une clé TMDB dans Paramètres).
  • Ajoutez les langues audio et les fichiers de sous-titres ; SIVO les regroupe dans un seul fichier pour que les applications les listent dans leurs menus.

Contenu

Séries

  • Séries → une série → ses saisons → les épisodes d'une saison ; chaque niveau est une liste que vous pouvez rechercher, trier et traiter en masse.
  • Les fichiers nommés S01E01, S01E02… reçoivent d'eux-mêmes leur numéro de saison et d'épisode.
  • Les noms de saisons, synopsis et affiches sont affichés dans les applications.

Contenu

Rattrapage

Définissez les jours de rattrapage (1 à 30) sur une chaîne. SIVO l'enregistre par tranches de 10 secondes, les applications proposent les émissions passées depuis le guide, et les enregistrements plus anciens que le réglage sont supprimés. La section Enregistrements affiche l'espace disque utilisé par chaque chaîne.

Contenu

Guide TV

Ajoutez les adresses de guide XMLTV dans Guide TV. Elles sont récupérées toutes les 6 heures et associées aux chaînes par leur ID de guide. Les applications des abonnés reçoivent le guide avec leur propre lien.

Abonnés

Forfaits

Un forfait ouvre des catégories choisies de chaînes, de films et de séries. Un abonné sans forfait voit tout.

Abonnés

Abonnés

  • Nom d'utilisateur et mot de passe (utilisés dans l'application), nom complet, téléphone, forfait, expiration et appareils simultanés.
  • Accès affiche le serveur, l'identifiant, les liens M3U et guide à envoyer.
  • Prolonger ajoute des jours à partir d'aujourd'hui ou de l'expiration actuelle, selon la date la plus tardive ; Désactiver met fin à ce que l'abonné regarde.
  • Chaque nouvel abonné compte dans la limite d'utilisateurs de la licence.

Abonnés

Applications et liens

Dans IPTV Smarters, TiviMate et la plupart des applications, choisissez Xtream Codes et saisissez l'adresse du serveur, le nom d'utilisateur et le mot de passe. Les applications qui n'acceptent qu'une playlist utilisent le lien M3U de la section Accès.

http://tv.example.net:8080/get.php?username=USER&password=PASS&type=m3u_plus&output=ts

Abonnés

En cours de visionnage

En cours de visionnage liste toutes les connexions ouvertes : abonné, chaîne ou titre, appareil et adresse. Mettez-en fin depuis son menu ; un abonné ayant dépassé le nombre d'appareils simultanés se voit refuser le flux suivant.

Fonctionnement

Recherche, filtres et export

  • Saisissez dans la zone de recherche pour filtrer les lignes ; appuyez sur Entrée pour la garder sous forme de jeton.
  • Le menu à côté de la zone contient les filtres, Grouper par, les recherches enregistrées et les filtres personnalisés.
  • Cochez les lignes pour les actions groupées ; Exporter télécharge un CSV.

Fonctionnement

Administrateurs et rôles

Ajoutez des administrateurs avec des rôles qui définissent ce qu'ils peuvent voir et modifier. La connexion en deux étapes est disponible pour chaque administrateur, et chaque modification figure dans le journal d'audit.

Fonctionnement

Sauvegarde et restauration

Outils → Sauvegarde sauvegarde la base de données et les réglages (la médiathèque n'y est pas incluse ; copiez votre dossier média séparément). La restauration se fait depuis la même page.

Fonctionnement

Mises à jour

Les mises à jour sont signées par SecuryTik et vérifiées avant d'être appliquées. Système → Mises à jour affiche la version actuelle et la dernière version ; les mises à jour peuvent être appliquées à la main ou automatiquement.

Fonctionnement

Licence et offres

Chaque installation est licenciée séparément selon le nombre d'utilisateurs (abonnés). Une installation non enregistrée dessert jusqu'à 25 utilisateurs ; enregistrée sur l'offre Gratuite, 100. Offres payantes : Lite 500, Plus 1,000, Pro 2,000, Mega 5,000, Max 10,000 et Unlimited. Voir Tarifs.

Demandez une offre depuis Système → Licence ou depuis votre tableau de bord ; la première demande sur un compte donne un mois gratuit. Si une licence payante expire, un avertissement s'affiche, puis une période de grâce ; aucune donnée n'est jamais supprimée.

Fonctionnement

Cloudflare Tunnel

Système → Cloudflare Tunnel met le panneau (et, si vous le souhaitez, la porte de diffusion) sur votre propre domaine en HTTPS, sans ouvrir de ports.

Référence

API REST

Système → API crée des jetons avec des périmètres. L'API gère les abonnés (création, modification, prolongation, activation, désactivation, suppression, liens d'accès), les forfaits, les chaînes, les films, les séries, la liste des spectateurs et les totaux. La référence complète, avec un bouton Essayer, se trouve sur votre installation à /api/v1/docs.

curl -H "Authorization: Bearer sivo_YOUR_TOKEN" http://SERVER/api/v1/subscribers

Référence

Webhooks

Système → API → Webhooks envoie subscriber.created, subscriber.updated et subscriber.deleted à votre adresse au format JSON, signés avec X-Sivo-Signature: sha256=HMAC du corps. Les envois échoués sont réessayés.

Référence

Dépannage

  • Une chaîne affiche l'écran sans signal : sa source ne répond pas depuis votre serveur ; ouvrez le menu de la chaîne et choisissez Tester.
  • Une chaîne s'ouvre lentement ou saccade : la qualité de la source dépasse ce que votre ligne Internet permet ; définissez un plafond de qualité dans Paramètres → Diffusion.
  • Une application indique que l'identifiant est incorrect : vérifiez l'adresse publique dans les Paramètres, et que l'abonné est activé et non expiré.
  • Trop d'appareils : la limite d'appareils simultanés de l'abonné est atteinte ; terminez une ancienne connexion dans En cours de visionnage.