Fragen & Antworten

Ein vollständiges OTT-/IPTV-System: das Admin-Panel (Dashboard), den API-Server für die Apps der Zuschauer, die Auslieferung von Live-Kanälen, Filmen, Serien und Radio sowie einen Web-Player. Wir stellen das System bereit und warten es; Reseller nutzen es, um ihren Kunden das Recht zum Schauen (Lines) zu geben.

• Er kassiert kein Geld für Sie und hat kein Zahlungs-Gateway. Der Preis für Ihre Kunden, der Zahlungseingang und die Rechnungsstellung sind Sache des Resellers (siehe CON-01).
• Er kontaktiert die Zuschauer eines Resellers nicht. Das Panel sendet E-Mails nur an Panel-Konten, nie an eine Line.
• Er speichert keine personenbezogenen Daten eines gelöschten Kunden und hat keine Wiederherstellungsfunktion (siehe DATA-01).

1. Der Admin baut den Katalog auf (Kanäle, Filme, Serien, Radio) und gruppiert ihn in Bouquets.
2. Der Admin erstellt ein Paket: Bouquets + Laufzeit + Anzahl der Verbindungen + Preis in Credits.
3. Ein Reseller gibt Credits aus, um das Paket zu verkaufen → das System erstellt eine Line.
4. Der Kunde gibt die Zugangsdaten der Line in einer App ein; das System prüft die Line (nicht abgelaufen, aktiviert, innerhalb ihrer Limits) und spielt von einem passenden Server ab.

Ein Reseller kann die Listen der Kanäle, Filme, Serien, Radiosender, Bouquets und Pakete ansehen (wenn seine Gruppe die Berechtigung hat), aber keine Inhalte hinzufügen, bearbeiten oder löschen. Inhalte und Pakete verwaltet der Admin. Was ein Kunde schauen darf, bestimmt der Reseller über die Wahl des Pakets (und der Bouquets, wenn die Gruppe es erlaubt – PKG-05).

Der Eintrag Support in der Seitenleiste öffnet die separate Support-Seite. Das Panel hat kein eigenes Ticketsystem. Geben Sie bei einer Anfrage an: den Benutzernamen der Line (niemals das Passwort), den Zeitpunkt, die App bzw. das Gerät und den Fragencode von dieser Seite, falls Sie ihn schon ausprobiert haben.

Das Panel, der Web-Player und diese Hilfeseite haben einen Sprachumschalter mit 27 Sprachen. Englisch und Vietnamesisch sind die Referenzübersetzungen; in den anderen Sprachen kann ein neu hinzugefügter Bildschirm eine Weile auf Englisch bleiben. E-Mails des Panels sind derzeit nur auf Englisch.

Die Installationspakete, ihre SHA-256-Prüfsummen und die vollständige Installationsanleitung (auf Englisch) finden Sie unter https://download.xtream-ui.pro.

• Sie brauchen: Ubuntu 22.04 oder 24.04 (virtuelle Maschine oder Bare Metal), root oder sudo, am besten einen frischen Server.
• Installation: Laden Sie das Paket für Ihre CPU direkt auf dem Server herunter, prüfen Sie es mit sha256sum, entpacken Sie es und führen Sie sudo ./install.sh aus.
• Laufenden Server aktualisieren: sudo ./upgrade.sh --tag <version>.

Domains mit TLS, Edge-Nodes und alle Optionen werden in der Anleitung erklärt.

Das ist so gewollt: Eine Line ist kein Panel-Konto. Ein Kunde nutzt die Zugangsdaten der Line nur in einer IPTV-App, einer Set-Top-Box oder im Web-Player. Umgekehrt kann man mit einem Reseller-Konto keine Kanäle schauen.

Menüs und Aktionen hängen von der Gruppe ab, die der Admin Ihrem Konto zugewiesen hat. Eine Seite, für die Ihre Gruppe keine Berechtigung hat, wird in der Seitenleiste nicht angezeigt und lässt sich nicht öffnen. Bitten Sie den Admin um weitere Berechtigungen.

Im Kontobereich (Profil → Passwort ändern). Panel-Passwörter werden als Hash gespeichert; niemand kann sie auslesen – nicht einmal der Admin. Wenn Sie es vergessen, bitten Sie das übergeordnete Konto (Ihren übergeordneten Reseller oder den Admin), ein neues zu setzen.

Das Panel kann so konfiguriert werden, dass es eine Sitzung beendet, wenn sich deren IP-Adresse ändert, damit eine gestohlene Sitzung nicht weiterverwendet werden kann. Melden Sie sich erneut an. Das ist eine Admin-Einstellung.

Das Panel begrenzt fehlgeschlagene Anmeldungen (vom Admin konfiguriert). Nach Überschreiten des Limits müssen Sie warten, bevor Sie es erneut versuchen.

Ein Demo-Konto zeigt nur die Oberfläche: Es kann sein Passwort nicht ändern, sein Profil nicht bearbeiten, keine Aktivierungscodes erstellen und nichts tun, was sich nicht rückgängig machen lässt.

Das übergeordnete Konto hat es abgeschaltet: Sie können sich nicht am Panel anmelden und Ihre API-Schlüssel werden abgelehnt. Bereits verkaufte Lines werden nicht gelöscht. Wenden Sie sich an das übergeordnete Konto.

Logs → Reseller Logs (wenn die Gruppe Logs ansehen darf): jede erstellte, bearbeitete, verlängerte, aktivierte / deaktivierte oder gelöschte Line bzw. jedes Gerät, jeder erstellte Sub-Reseller und jede Credit-Übertragung – mit den berechneten Credits. Sie sehen nur Ihre eigenen Einträge und die der Konten unter Ihnen; das Log kann nicht gelöscht werden (nur Admin). Das Credit-Hauptbuch (CRD) bleibt der Ort, um einen Kontostand abzugleichen.

Die Prepaid-Einheit des Panels. Jeder Verkauf (Line erstellen, verlängern, Aktivierungscodes erstellen, Sub-Reseller erstellen) kostet Credits gemäß Paketpreis oder Gruppengebühr. Ein Credit ist kein Geld und das Panel rechnet ihn nicht um: Was ein Credit wert ist, vereinbaren Sie mit dem übergeordneten Konto.

Credits fließen von oben nach unten: Der Admin gibt einem Reseller Credits, ein Reseller überträgt sie an einen Sub-Reseller. Die Bezahlung an das übergeordnete Konto erfolgt außerhalb des Panels.

Immer die des Kontos, das die Aktion ausführt, auch wenn die Line einem Sub-Reseller darunter zugewiesen ist.

Auf der Seite Credits: eine Zeile pro Bewegung, mit Datum, Betrag, anschließendem Kontostand, Grund und Verursacher. Das ist das Hauptbuch – die maßgebliche Quelle für Ihren Kontostand.

Die gesamte Aktion wird abgelehnt: Es wird keine Line erstellt und nichts belastet. Ein Kontostand wird nie negativ.

Nein. Jede Verkaufsanfrage trägt eine Request-ID (request_id); wird dieselbe ID erneut gesendet, kommt das frühere Ergebnis zurück. Das Erstellen der Line und das Abbuchen der Credits gelingen immer gemeinsam oder werden gemeinsam abgebrochen.

Nein. Das Löschen einer Line erstattet nichts, auch wenn noch Restlaufzeit vorhanden ist. Die einzige Ausnahme: Das Löschen eines ungenutzten Aktivierungscodes, den der Reseller erstellt hat, wird erstattet (CODE-08).

Ja: Geben Sie im Bearbeitungsformular des Sub-Resellers eine negative Zahl im Feld für die Credit-Übertragung ein. Kein Kontostand kann unter 0 fallen.

Die Paketauswahl im Line-Formular zeigt Ihren eigenen Preis. Über die API liefert die Aktion pricing Ihren Kontostand, den Preis jedes Pakets und wie viele Sie sich leisten können.

Ein Bouquet ist eine Liste von Inhalten (Kanäle, Filme, Serien). Ein Paket ist das Produkt, das Sie verkaufen: ein oder mehrere Bouquets, eine Laufzeit, eine Anzahl von Verbindungen, Ausgabeformate, Sperren und ein Preis in Credits (offizieller Preis und Trial-Preis).

Ein Paket können nur die Gruppen verkaufen, die der Admin dafür ausgewählt hat. Ein Paket, das nicht für Ihre Gruppe vorgesehen ist, erscheint nicht in der Auswahl und wird bei Übermittlung über die API abgelehnt.

Der Admin kann pro Reseller für jedes Paket einen eigenen Preis festlegen (0 = kostenlos). Der eigene Preis gilt für das Erstellen einer offiziellen Line, das Verlängern und offizielle Aktivierungscodes; er gilt nicht für Trials.

Nein. Die Bouquets werden beim Verkauf in die Line kopiert; eine spätere Änderung des Pakets wirkt sich nicht auf bereits verkaufte Lines aus. Eine Line erhält die neuen Bouquets des Pakets bei der nächsten Verlängerung / dem nächsten Paketwechsel. (Ändern sich die Inhalte innerhalb eines Bouquets, sieht das jede Line mit diesem Bouquet sofort. Das Löschen eines Bouquets entfernt seine ID aus jeder Line und jedem Paket. Das Ändern der globalen Bouquet-Reihenfolge ändert die auf verkauften Lines gespeicherte Reihenfolge nur, wenn Sie das Kästchen "auf verkaufte Lines und Pakete anwenden" ankreuzen; die Menge der Bouquets einer Line ändert sich nicht.)

Nur wenn bei Ihrer Gruppe Allow Bouquet Selection aktiviert ist: Sie haken einen Teil der Bouquets des Pakets an; nichts angehakt = das ganze Paket; Bouquets außerhalb des Pakets werden verworfen. Der Preis ändert sich nicht.

Das Ablaufdatum (heute + Paketlaufzeit), die Anzahl der Verbindungen, Ausgabeformate, Restreamer, Gerätesperre, erzwungenes Land, erzwungener Server, ISP-Sperre, Bouquets. Werte, die ein Reseller für diese Felder eingibt, werden ignoriert, außer den Bouquets (PKG-05) und der ISP-Sperre, wenn bei der Gruppe Allow Line Restrictions aktiviert ist.

Ein Paket, das nur für diese Art von Set-Top-Box verkauft werden kann; es lässt sich weder für eine normale Line noch für den anderen Gerätetyp verkaufen. Umgekehrt muss ein Paket den Gerätetyp erlauben, bevor es im Formular Add MAG / Add Enigma verwendet werden kann.

Sie müssen ein Paket wählen, das Ihre Gruppe verkaufen darf, und genug Credits haben. Benutzername / Passwort: Geben Sie eigene ein (wenn die Gruppe es erlaubt) oder lassen Sie die Felder leer, damit sie generiert werden. Ein Admin darf beim Erstellen einer Line auch eines davon (oder beide) leer lassen: Das System generiert 10 Zeichen und zeigt sie direkt nach dem Speichern an; das Bearbeiten-Formular verlangt weiterhin einen Benutzernamen.

Bei Ihrer Gruppe sind Allow Username Change / Allow Password Change aus: Eine neue Line erhält generierte Werte. Wenn Sie eigene eingeben dürfen, legt die Gruppe die Mindestlänge fest (standardmäßig 8 Zeichen).

Im Bearbeitungsformular der Line und im Dialog Generate play link der Lines-Liste. Line-Passwörter werden lesbar gespeichert, weil IPTV-Apps und Playlist-Links sie benötigen. Ein generiertes Passwort wird direkt nach dem Speichern angezeigt.

Manche Lines, die eine frühere Version des Panels erstellt hat, enthalten nur ein gehashtes Passwort. Eine solche Line kann sich nicht anmelden und das Panel zeigt kein Passwort dafür an. Setzen Sie im Bearbeitungsformular der Line ein neues Passwort und senden Sie es dem Kunden.

Aktivieren / deaktivieren, Reseller-Notizen, Kontakt, Kategorie-Vorlage, Besitzer (innerhalb Ihres eigenen Baums); Benutzername und Passwort, wenn die Gruppe es erlaubt; Einschränkungen (IPs, User Agents, ISP-Sperre), wenn bei der Gruppe Allow Line Restrictions aktiviert ist; eine neue Bouquet-Auswahl innerhalb des Pakets, wenn die Gruppe es erlaubt. Das Paket, das Ablaufdatum, die Anzahl der Verbindungen, das Trial-Kennzeichen, die Ausgabeformate, die Gerätesperre und das Land lassen sich nicht direkt bearbeiten – sie ändern sich nur durch eine Verlängerung / einen Paketwechsel.

Zwei Wege, eine Regel:

• der Button Renew (charged) der Liste: verwendet das aktuelle Paket der Line;
• das Feld Extend with package des Bearbeitungsformulars: Wählen Sie ein beliebiges Paket, das Sie verkaufen dürfen (so wechseln Sie auch das Paket).

Wenn Sie eine Line bearbeiten und im selben Speichervorgang eine Verlängerung wählen, bilden beide eine Transaktion: Wird die Verlängerung abgelehnt (zu wenig Credits, Paket nicht verkaufbar), wird auch die Bearbeitung nicht gespeichert und es werden keine Credits belastet. Korrigieren Sie die Eingabe und speichern Sie erneut.

• Die Line ist nicht abgelaufen und das neue Paket ist mit dem alten kompatibel → die Zeit wird zum aktuellen Ablaufdatum addiert.
• Die Line ist abgelaufen, oder die beiden Pakete sind nicht kompatibel → es wird ab heute gezählt; eine Restzeit bleibt nicht erhalten.

"Kompatibel" wird nur geprüft, wenn beim neuen Paket die Option für die Kompatibilitätsprüfung aktiviert ist: Beide Pakete müssen dieselben Bouquets, Ausgabeformate, dieselbe Anzahl von Verbindungen, dasselbe Restreamer-Kennzeichen und dieselbe Gerätesperre haben. Bei deaktivierter Option gelten sie immer als kompatibel. Neue Pakete haben die Option standardmäßig aktiviert (der Admin kann sie ausschalten); bestehende Pakete behalten ihre Einstellung. Eine MAG-/Enigma-Line lässt sich nur mit einem Paket verlängern oder auf ein Paket umstellen, das diese Art von Box erlaubt.

Ein Paketwechsel = der Kauf einer offiziellen Laufzeit des neuen Pakets: Der volle Preis des neuen Pakets wird belastet (Ihr eigener Preis, falls vorhanden), ohne Gutschrift für den ungenutzten Teil. Die Line übernimmt alle Eigenschaften des neuen Pakets.

Deaktivieren: Der Kunde kann sich nicht anmelden oder schauen, laufende Sitzungen werden innerhalb von etwa einer Minute beendet; die Abo-Laufzeit läuft weiter; Sie können sie jederzeit wieder aktivieren. Löschen: endgültig, keine Wiederherstellung, keine Erstattung (DATA-01). Bei einem Kunden, der pausiert, deaktivieren Sie – löschen Sie nicht.

Der Kunde wird abgewiesen, bis die Line verlängert wird (eine Line, die abgelaufen und gesperrt ist, sieht den Clip "abgelaufen", weil der Ablauf zuerst geprüft wird); laufende Sitzungen werden innerhalb von etwa einer Minute beendet. Die Line wird nicht automatisch gelöscht: Verlängern Sie sie, und sie funktioniert mit demselben Benutzernamen / Passwort wieder.

Ja: Wählen Sie ein Konto unter Ihnen als Besitzer. Der Besitzer sieht die Line in seiner eigenen Liste. Die Credits werden weiterhin demjenigen belastet, der auf Speichern drückt.

Ihre eigenen und die jedes Kontos unter Ihnen. Eine Line außerhalb Ihres Baums existiert für Sie nicht (die Antwort lautet "nicht gefunden").

Damit Sie sich merken können, wer der Kunde ist (E-Mail, Telefonnummer, Bestellnummer). Der Abonnent sieht sie nie. Sie werden beim Löschen der Line endgültig gelöscht.

Wenn die Gruppe die Berechtigung hat: Logs → Line Activity zeigt den Wiedergabeverlauf jeder Line, und Logs → Live Connections zeigt jede offene Verbindung der Lines in Ihrem Baum (welche Line, welcher Kanal, von welcher Adresse) mit einem Button zum Schließen. Live Connections öffnet sich nur, wenn der Admin für Ihre Gruppe die Option zum Einsehen des Verbindungsverlaufs der Kunden aktiviert hat (das Kästchen client connection logs im Gruppenformular); Verbindungen einer Line außerhalb Ihres Baums sehen Sie nie.

Eine Line, die zu einem Aktivierungscode gehört, ist standardmäßig in der Liste ausgeblendet, bis Sie danach filtern (CODE-02).

Ja. Das Feld Expires on des Line-Formulars ist ein Datum mit Uhrzeit in der Zeitzone des Panels, sodass eine Line zu einer bestimmten Stunde ablaufen kann. Wenn Sie das Formular öffnen und speichern, ohne dieses Feld anzufassen, bleibt der Ablauf sekundengenau erhalten – das Bearbeiten einer Notiz oder der Bouquets verschafft einer stundenweisen Trial-Line keine zusätzliche Zeit. Ein nicht lesbarer Wert wird direkt am Feld gemeldet und wird nie zu "läuft nie ab". Die Massenbearbeitung nimmt weiterhin ein Datum an, das als Ende dieses Tages gelesen wird.

Wenn alle diese Bedingungen erfüllt sind: Der Admin hat Trials für Reseller nicht abgeschaltet; das Paket hat eine Trial-Laufzeit; Ihre Gruppe hat Allowed Trials > 0; Ihre Credits sind ≥ den Minimum Trial Credits der Gruppe; und die Anzahl der Trial-Lines, die Sie im Zählfenster erstellt haben, hat das Kontingent nicht erreicht.

Wie in der Gruppe eingestellt: Tag = die letzten 24 Stunden, Monat = die letzten 30 Tage. Beispiel, ein Kontingent von 5 / Tag: höchstens 5 Trial-Lines in beliebigen 24 Stunden. Ein älterer Trial gibt seinen Platz frei, wenn er das Fenster verlässt.

Genau den Trial-Preis des Pakets (meist 0). Der eigene Preis eines Resellers gilt nicht für Trials.

Eine der Bedingungen aus TRI-01 ist nicht erfüllt; das Formular nennt den Grund neben dem Kästchen.

Verlängern Sie die Line mit einem Paket: Die Line erhält eine offizielle Laufzeit und ist kein Trial mehr. Benutzername und Passwort bleiben gleich, der Kunde muss nichts neu einrichten.

Nein. Ein Trial wird einmal bei der Erstellung der Line gewährt; eine bestehende Line kann nur mit einer offiziellen Laufzeit verlängert werden (TRI-05). Damit ein Kunde es erneut testen kann, erstellen Sie eine neue Trial-Line (sie zählt zum Trial-Kontingent).

Lines → Generate play link: Wählen Sie das Format; der Link wird mit Benutzername und Passwort der Line gebaut. Über die API liefert get_line die Links fertig zurück: m3u, m3u_hls, xmltv, player_api, web_player.

Jede App, die die Xtream Codes API unterstützt (IPTV Smarters, TiviMate, XCIPTV, GSE…): Serveradresse + Benutzername + Passwort eingeben. Für eine App, die nur eine Playlist annimmt, nutzen Sie den M3U-Link. MAG-Boxen nutzen das Portal, Enigma2-Boxen eine Playlist / ein Plugin. Ohne jedes Gerät nutzen Sie den Web-Player im Browser.

MPEG-TS: schnelles Umschalten der Kanäle, passt zu IPTV-Apps und Set-Top-Boxen. HLS: funktioniert gut in Browsern, auf Apple-Geräten und in instabilen Netzwerken. Eine Line kann nur die Formate nutzen, die ihr Paket erlaubt; ein Link in einem nicht erlaubten Format wird abgelehnt.

m3u_plus (mit Logos, Gruppen, EPG-IDs – der empfohlene Standard), einfaches m3u, die Typen für Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive und einfache Listentypen. Wählen Sie einen im Dialog Generate play link.

Xtream-Apps holen ihn selbst. Für eine M3U-App nutzen Sie den XMLTV-Link der Line (eine m3u_plus-Playlist enthält die EPG-Adresse bereits).

Ja, auf den Kanälen, für die der Admin die Archivierung aktiviert hat; Apps zeigen bei diesen Kanälen ein Catch-up-Symbol.

Unter /player/ auf dem API-Server (der Link web_player). Melden Sie sich mit Benutzername / Passwort der Line oder mit einem Aktivierungscode an.

Nein. Das Passwort ist Teil des Links und in der App gespeichert; nach einer Passwortänderung muss der Kunde es erneut eingeben / einen neuen Link erhalten. So sperren Sie auch jemanden aus, der eine Line unbefugt nutzt.

Ja: Setzen Sie Your own play address auf der API-Schlüssel-Seite (oder mit der API-Aktion set_play_base). Sie richten den DNS der Domain auf den API-Server des Panels, und der Betreiber muss seine Seite konfigurieren; informieren Sie den Admin, bevor Sie sie nutzen. Die Adresse gilt für die Links, die die API an Ihr System zurückgibt.

Technisch teilen sie sich eine Line, also auch deren Anzahl der Verbindungen (SEC-01), und stoßen womöglich auf die Regel für die zweite IP (SEC-03). Jeder Kunde sollte eine eigene Line haben.

Devices → Add MAG / Add Enigma: MAC eingeben, Paket wählen. Das System verkauft eine neue Line und verknüpft das Gerät in einem Schritt; das Gerät meldet sich über seine MAC an, niemand muss Benutzername / Passwort eintippen. Die Credits werden genau wie bei einer normalen Line belastet.

Wählen Sie im Gerätformular statt eines Pakets die bestehende Line des Kunden: Das Gerät wird kostenlos mit dieser Line gekoppelt. Der Kunde nutzt die Line weiter in der App; die Box folgt Paket, Ablaufdatum, Bouquets und Status der Line.

Sie teilen sich das Verbindungslimit: App und Box sind ein Abonnent.

Verlängern Sie ihre Line (der Link steht im Gerätformular). Bei einem gekoppelten Gerät verlängern Sie die Line des Kunden – die Box folgt von selbst.

Bearbeiten Sie die MAC am Gerät. Ist bei der Line die Gerätesperre aktiv, löschen Sie die gespeicherte Seriennummer / Geräte-ID, damit sich die neue Box registrieren kann.

Ja. Das Löschen eines Geräts löscht auch seine Line (mit Verbindungsverlauf und ausstehenden Ereignissen). Um eine bezahlte Line zu behalten, nutzen Sie den Button Convert to line: Das Gerät wird entfernt und die Line wird zu einer normalen Line. Löschen Sie die Line eines Kunden, besteht ein gekoppeltes Gerät eigenständig mit einer eigenen Line weiter.

Seine eigenen MAG-Boxen ja: eine Nachricht an den Fernseher senden, einen Kanal abspielen, das Portal neu laden, neu starten, die Verbindungen der Line schließen (die Gruppe benötigt die Berechtigung, die Verbindungsprotokolle der Kunden einzusehen), den gespeicherten ISP zurücksetzen und die STB-Sperre zurücksetzen. X-Plugin-Befehle und Screenshots von Enigma-Boxen, das Sperren eines Geräts und das Verschieben eines Geräts auf eine andere Line sind nur dem Admin vorbehalten. Das Aktivieren / Deaktivieren des Geräts eines Resellers aktiviert / deaktiviert seine Line; ein Reseller kann Banned bei einem Gerät nicht aufheben.

Zugang als Code verkaufen (eine Rubbelkarte, ein per Nachricht gesendeter Code): Der Kunde gibt den Code in einer App oder im Web-Player ein und kann schauen, ohne Benutzername / Passwort. Die Laufzeit beginnt erst, wenn der Kunde den Code zum ersten Mal aktiviert.

Active Codes → New: Wählen Sie das Paket, die Menge (1–500 pro Batch), die Codelänge (6–24), die Option nur Ziffern (leicht mit einer TV-Fernbedienung einzugeben) und die Trial-Option. Die Credits werden bei der Erstellung belastet = Paketpreis × Anzahl der Codes. Zu jedem Code gehört eine eigene Line, die bis zur Aktivierung gesperrt ist.

Großbuchstaben und Ziffern ohne leicht zu verwechselnde Zeichen (0, O, 1, I); oder nur Ziffern. Gibt ein Kunde Kleinbuchstaben ein, wird das trotzdem akzeptiert.

Auf einem. Der Code ist an das erste Gerät gebunden, das ihn aktiviert; ein anderes Gerät, das denselben Code eingibt, wird abgewiesen. Dieses Gerät darf den Code beliebig oft eingeben, die Anmeldedaten der Line ändern sich nicht.

Reset device bei diesem Code; danach kann das neue Gerät ihn aktivieren. Es wird keine Zeit zur Laufzeit hinzugefügt.

Wer mehrmals hintereinander verschiedene falsche Codes eingibt, dessen IP-Adresse wird für eine Weile gesperrt (SEC-08).

Haken Sie auf der Seite Active Codes den Code an, wählen Sie die Aktion Extend (days) und geben Sie die Anzahl der Tage ein. Nur ein aktivierter Code bekommt Tage hinzugefügt (ein ungenutzter Code hat seine Laufzeit noch nicht begonnen); ein noch gültiger Code wird ab seinem aktuellen Ablaufdatum verlängert, ein abgelaufener ab jetzt. Diese Aktion belastet keine Credits, deshalb darf sie nur ein Admin nutzen: Ein Reseller verlängert die Line des Codes wie jede Line, mit einem Paket und dessen Preis (Lines → Renew, oder renew_line in der Reseller API). Eine falsche Abbuchung korrigiert der Support mit einer Credit-Anpassung, nie mit einer kostenlosen Verlängerung. Admin API: extend_active_code.

Ein ungenutzter Code, den der Reseller erstellt hat: vollständig erstattet, mit einer Zeile im Credit-Hauptbuch. Ein aktivierter Code: keine Erstattung.

Die Seite Batches zeigt für jeden Batch gesamt / bereit / aktiviert / deaktiviert und exportiert eine TXT-Datei (ein Code pro Zeile). Sammelaktionen: aktivieren, deaktivieren, Gerät zurücksetzen, löschen.

Ja, wie jede mit diesem Paket verkaufte Line: Anzahl der Verbindungen, Ausgabeformate, Bouquets, Gerätesperre, Restreamer und auch das erzwungene Land des Pakets (SEC-07). Ein Kunde, der einen Code aus einem Land außerhalb der erlaubten Liste aktiviert, kann ihn aktivieren, wird aber bei der Wiedergabe abgewiesen.

Es ist die Anzahl der Geräte, die mit einer Line gleichzeitig schauen. 0 = unbegrenzt. Den Kanal, den Sie schon schauen, vom selben Gerät erneut zu öffnen, zählt nicht als weitere Verbindung.

Standardmäßig: Die neue Verbindung kommt hinein und die älteste wird geschlossen (bevorzugt eine Verbindung vom selben Gerät, dann von derselben IP). Der geschlossene Player stoppt innerhalb von etwa 30 Sekunden. Der Admin kann umstellen, sodass die neue Verbindung abgelehnt wird, statt eine alte zu schließen.

Wenn der Admin sie aktiviert hat: Während eine Line von einer IP aus geschaut wird, wird eine Live-Verbindung von einer anderen IP abgelehnt. Die Regel lässt sich auf Lines mit wenigen Verbindungen beschränken (zum Beispiel Lines mit 1 Verbindung; eine Line mit unbegrenzten Verbindungen ist nur gebunden, wenn der Schwellenwert 0 ist). Mit aktiviertem Match The Address By Network zählen Adressen desselben /24-Netzes (IPv6: /64) als ein Zuschauer. Das ist ein Mittel gegen Account-Sharing.

Wenn bei der Gruppe Allow Line Restrictions aktiviert ist: das Feld Allowed IPs (eine IP, ein CIDR-Bereich oder ein Domainname, einer pro Zeile; eine Domain wird beim Verbindungsaufbau aufgelöst, sodass auch eine dynamische IP funktioniert) und Allowed User-Agents. Leer = alles erlaubt. Hinweis: Diese Einschränkungen blockieren bei der Wiedergabe; die App meldet sich weiterhin an und zeigt die Kanalliste.

Die Line merkt sich den Internetanbieter ihrer ersten Verbindung und lehnt die Nutzung über einen anderen Anbieter ab. Wechselt der Kunde den Anbieter, schalten Sie die ISP-Sperre aus und wieder ein, um den neuen zu erfassen. Sie gilt nicht für MAG-Boxen.

Sie bindet die Line an die erste Set-Top-Box, die sich anmeldet (Seriennummer, Geräte-ID); eine andere Box wird abgewiesen. Wird vom Paket bestimmt.

Eine Line kann sich nur aus ihrem erzwungenen Land verbinden (ALL = von überall). Ist es leer, gilt die allgemeine Liste der erlaubten Länder des Panels. Ein Kunde, der ins Ausland reist oder ein VPN nutzt, kann aus diesem Grund abgewiesen werden.

• Automatisch: fehlgeschlagene Anmeldungen von einer IP mit vielen verschiedenen Benutzernamen / Aktivierungscodes in kurzer Zeit oder eine Flut von Anfragen. Eine automatische Sperre hebt sich nach der vom Admin konfigurierten Zeit selbst auf (standardmäßig 60 Minuten).
• Manuell: Der Admin hat die IP / den IP-Bereich gesperrt; das läuft nicht ab.

Solange eine IP gesperrt ist, kann sich von ihr keine Line verbinden. Wiederholtes Vertippen beim selben Benutzernamen führt nicht zu einer Sperre.

Der Admin kann nach User-Agent (App), nach Internetanbieter (ISP) und nach ASN (zum Beispiel Hosting- / VPN-Bereiche) blockieren. Eine Line, bei der der Admin "bypass UA" aktiviert hat, überspringt die Sperrliste für Apps.

Eine Line für einen Partner, der die Streams abruft, um sie weiterzuverteilen. Sie ist vom Verbindungslimit, von der Regel der zweiten IP, vom automatischen Beenden langer Sitzungen und von der ASN-Sperre ausgenommen. Wird vom Paket / vom Admin bestimmt; nicht für normale Zuschauer gedacht.

Der Admin kann eine Höchstdauer für eine ununterbrochene Sitzung festlegen; danach wird die Sitzung geschlossen und der Kunde drückt Play, um fortzufahren. Eine Sitzung, die etwa 90 Sekunden lang das Signal verliert, gilt ebenfalls als geschlossen.

• Die Seite Theft Detection (wenn die Gruppe die Berechtigung hat): reiht Lines nach der Anzahl der verschiedenen Filme / Folgen, die in 1 Stunde / 24 Stunden / 7 Tagen geschaut wurden, mit der Anzahl verschiedener IPs – eine auffällig hohe Line ist verdächtig.
• Die Aktivitätsseite der Line: zeigt die verwendeten IPs und Geräte.
• Was zu tun ist: das Passwort der Line ändern (PLAY-08), die IP-Beschränkung / ISP-Sperre aktivieren oder die Line deaktivieren.

Wenn bei Ihrer Gruppe Can Create Sub-Resellers aktiviert ist und mindestens eine Gruppe unter Groups for sub-resellers steht. Jede Erstellung belastet die in der Gruppe festgelegte Erstellungsgebühr (Credits). Ein Reseller-Baum ist höchstens 5 Ebenen tief.

Sie wählen eine Gruppe aus der Liste, die der Admin erlaubt; diese Gruppe bestimmt die Berechtigungen, die verkaufbaren Pakete und das Trial-Kontingent des Sub-Resellers.

E-Mail, Name, Passwort, Status, Gruppe (aus der Liste), Notizen, Credits übertragen / zurückholen und jede Line unter ihm. Sie können seine Rolle oder seinen Besitzer nicht ändern.

Nichts: Jedes Konto sieht nur, was unter ihm liegt, nie die Ebenen darüber oder andere Zweige.

Die Gruppe braucht Can Delete Users aktiviert. Die restlichen Credits, die Lines und die untergeordneten Konten gehen an das Konto, das löscht. Die Lines der Kunden funktionieren weiter. Die personenbezogenen Daten des gelöschten Kontos (Benutzername, E-Mail, Name, Passwort, API-Schlüssel, Notizen) werden gelöscht; dieser Benutzername und diese E-Mail können wieder verwendet werden.

Wenn der Admin die Willkommens-E-Mail aktiviert hat: Das neue Konto erhält seinen Anmeldenamen und einen Anmeldelink. Die E-Mail enthält nie das Passwort – das senden Sie ihm selbst.

Um die Kategorien (Live, Filme, Serien, Radio), die ein Kunde in der App sieht, umzusortieren, umzubenennen oder auszublenden – pro Line, ohne die eigenen Kategorien des Panels anzutasten.

Alle Inhalte dieser Kategorie werden ebenfalls in der App und in der Playlist der Lines ausgeblendet, die die Vorlage verwenden.

Ja, sofort für jede Line, der die Vorlage zugewiesen ist. Wird eine Vorlage gelöscht, kehren ihre Lines zum Standardlayout zurück.

Sehen: Ihre eigenen und die der Konten unter Ihnen, Systemvorlagen und von den Ebenen darüber geteilte Vorlagen. Bearbeiten: nur Ihre eigenen und die darunter. Um eine Systemvorlage anzupassen, duplizieren Sie sie und bearbeiten die Kopie.

Die benutzerdefinierte Kategoriereihenfolge gilt nicht für den Film- / Serienteil einer M3U-Playlist (Namen und Ausblenden gelten weiterhin). Apps, die die Xtream API nutzen, erhalten alles.

Damit Ihr eigenes System (Webshop, Abrechnung, Bot) Lines / Sub-Reseller verkaufen und verwalten kann, ohne das Dashboard zu öffnen. Adresse: {API}/reseller/v1, authentifiziert mit dem Header X-API-Key. Die vollständige Dokumentation finden Sie unter /docs/ auf dem API-Server.

Auf der Seite API Key. Ein Schlüssel wird einmal angezeigt, wenn er erstellt wird – kopieren Sie ihn sofort. Wenn Sie ihn verlieren, erstellen Sie einen neuen Schlüssel (der alte funktioniert dann nicht mehr).

Besser nicht. Erstellen Sie pro System einen zusätzlichen Schlüssel: Geben Sie ihm einen Namen, begrenzen Sie die IPs / CIDRs, die ihn nutzen dürfen, machen Sie ihn optional schreibgeschützt (nur auflisten und ansehen) und widerrufen Sie ihn einzeln, ohne die anderen Schlüssel zu beeinflussen.

Jede Regel des Dashboards (Gruppe, eigener Preis, Trial-Kontingent, Baumbereich) gilt über die API auf genau dieselbe Weise.

Nein, solange Sie für dieselbe Transaktion dieselbe request_id senden: Das System gibt das frühere Ergebnis zurück. Die request_id einer Verlängerung ist an diese Line gebunden: Sie für eine andere Line wiederzuverwenden, liefert einen Konfliktfehler (HTTP 409) und die andere Line ändert sich nicht – erzeugen Sie für jede Transaktion eine neue request_id.

Die Seite API Key hat eine Tabelle der letzten API-Aufrufe (30 Tage): Aktion, Ergebnis, Fehlercode, aufrufende Adresse, Connector-Name. Parameter werden nie aufgezeichnet.

Das Panel benachrichtigt Ihr System, wenn etwas passiert, sodass Sie nicht ständig nachfragen müssen. Ereignisse: line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring (3 Tage vorher), line.expired, credits.low (unter dem von Ihnen gesetzten Schwellenwert). Die Empfangsadresse muss https sein und aus dem Internet erreichbar.

Jede Benachrichtigung trägt die Signatur X-Xtream-Signature: sha256=HMAC(secret, timestamp.body); das Secret wird einmal angezeigt, wenn der Endpunkt erstellt wird. Ein Webhook enthält nie ein Passwort.

Jede Benachrichtigung wird 3-mal versucht; ein Endpunkt, bei dem 20 Zustellungen in Folge fehlschlagen, wird abgeschaltet. Beheben Sie das Problem auf Ihrer Seite, nutzen Sie Send test und erstellen Sie den Endpunkt dann erneut, falls er abgeschaltet wurde.

Ja, aber nur an den Besitzer der Line (Sie und die Ebenen über Ihnen im Baum). Speichern Sie Line-Passwörter nicht in Logs und senden Sie sie nicht über einen unsicheren Kanal.

Ja, wenn Sie package_id mitsenden (der alte Name package wird ebenfalls akzeptiert): Neben der Bearbeitung verkauft die Aktion eine offizielle Laufzeit dieses Pakets genau wie change_package – gleicher Preis, gleiche request_id, und die Antwort enthält credits_charged. Bearbeitung und Verlängerung sind eine Transaktion: Wird sie abgelehnt (zu wenig Credits, ungültiges Paket, trial mitgesendet), ändert sich nichts. edit_line ohne Paket bearbeitet nur Benutzername, Passwort, Kontakt und Notizen und berührt weder Paket noch Ablaufdatum.

Nicht unverändert. Die API behält die vertrauten Aktionsnamen, ist aber eine neue Schnittstelle: die Adresse /reseller/v1, ein in diesem Panel erstellter API-Schlüssel, Schreibaktionen per POST, Fehler als HTTP-Status mit einem Feld error und das Ergebnis des Erstellens einer Line in data.line. Nutzen Sie die Dokumentation unter /docs/ oder einen fertigen Connector (CON-02).

Mit Ihrem eigenen System und Zahlungs-Gateway. Das Panel wickelt keine Zahlungen ab. Ein Connector verbindet Ihr Shopsystem mit dem Panel: Der Kunde zahlt bei Ihnen → der Connector ruft die Reseller API auf, um die Line zu erstellen / zu verlängern.

WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress (WooCommerce / Easy Digital Downloads), Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext und eine "Webhook-Bridge" für Shopify, Upmind und Invoice Ninja.

Im Panel: Seitenleiste Resources → All Connectors – jeder Connector mit seinen Verbindungsdaten, den Installationsschritten, einem Button Download und der SHA-256 der Datei zur Überprüfung.

Dieselben Connectors mit Installationsschritten und Prüfsummen sind unter https://plugins.xtream-ui.pro veröffentlicht; den Quellcode finden Sie unter https://github.com/xtreamui-pro/plugins.

Das ist je Connector verschieden, und die Seite jedes Connectors sagt es: Manche liefen in der echten Plattform (zum Beispiel WordPress + WooCommerce, Odoo, FOSSBilling, Paymenter), bei anderen wurde nur der Kern geprüft. Lesen Sie die Zeile "how it was tested" und probieren Sie es in einer Testumgebung aus, bevor Sie wirklich verkaufen.

Ein Connector ruft nur die Reseller API mit Ihrem API-Schlüssel auf – er kann genau das, was Sie können, nicht mehr. Der Quellcode ist offen, damit Sie ihn lesen und prüfen können. Geben Sie jedem Connector einen eigenen Schlüssel mit IP-Limit (API-03).

Lines (erstellen, verlängern, Paket wechseln, aussetzen, löschen) und Sub-Reseller-Konten mit Credits.

Binden Sie sie selbst mit der Reseller API (API-01) und Webhooks an, oder senden Sie eine Anfrage über den Support-Kanal.

Nein. Gelöscht ist weg: die Daten der Line (Benutzername, Passwort, Kontakt, Notizen), ihr Verbindungsverlauf (IPs, Geräte, was geschaut wurde), die mit der Line verknüpften Set-Top-Boxen und ihr Aktivierungscode. Es gibt keinen Papierkorb und keine Wiederherstellungsfunktion oder API. Kommt der Kunde zurück, erstellen Sie eine neue Line.

Nur einen anonymen statistischen Eintrag für den Betreiber (neuer oder wiederkehrender Kunde, welche Pakete beliebt sind). Er enthält nichts Lesbares über den Kunden und kein Reseller, Connector oder keine API kann darauf zugreifen.

Nein. Datenbank-Backups dienen nur dazu, das System nach einem Vorfall wiederherzustellen, und liegen beim Betreiber; sie werden nicht verwendet, um eine Löschung rückgängig zu machen. Alte Backups werden rotiert, sodass gelöschte Daten auch daraus verschwinden.

Ein Line-Passwort muss in Apps eingegeben werden und ist Teil des Playlist-Links, daher hält das Panel es für den Besitzer der Line lesbar. Passwörter von Panel-Konten werden nur als Hash gespeichert.

Sie, die Konten über Ihnen in Ihrem Baum und der Admin. Andere Reseller und die Ebenen unter Ihnen nicht.

Nie. Die Kunden einer Line gehören dem Reseller; Sie kontaktieren sie über Ihr eigenes System.

Auf zwei Wegen: eine tägliche Zusammenfassungs-E-Mail der bald ablaufenden Lines (wenn der Admin sie aktiviert hat; standardmäßig 3 Tage vorher) und die Webhooks line.expiring / line.expired für Ihr System.

Meist eine der Wiedergabesperren (Zeilen 5–9 von FIX-01): Anmeldung und Kanalliste prüfen weder IP noch App, nur die Wiedergabe tut es. Fällt nur ein Kanal bei jeder Line aus → der Quellkanal hat ein Problem; nennen Sie dem Admin den Kanalnamen und die Uhrzeit.

Prüfen Sie die Bouquets der Line (PKG-04, PKG-05) und die ihr zugewiesene Kategorie-Vorlage (CAT-02). Bitten Sie den Kunden nach einer Änderung, die Liste in der App neu zu laden. Ein vom Admin gerade hinzugefügter Kanal erscheint nach etwa einer halben Minute; ist ein Kanal im Bouquet und keine Line sieht ihn, hat der Admin diesen Kanal möglicherweise offline genommen.

Probieren Sie der Reihe nach: einen anderen Kanal (ein Kanal oder alle?) → ein anderes Netzwerk → ein anderes Format (HLS statt MPEG-TS) → eine andere App. Fällt jeder Kanal in jedem Netzwerk aus → nennen Sie dem Support den Benutzernamen, die Uhrzeit und den Kanal.

Eine M3U-App braucht den hinzugefügten XMLTV-Link (PLAY-05). Ein Kanal ohne EPG an der Quelle zeigt keinen Zeitplan.

Der Reihe nach: kein Paket gewählt · das Paket ist nicht für Ihre Gruppe (PKG-02) · nicht genug Credits (CRD-05) · der Benutzername ist vergeben oder kürzer als das Minimum (LINE-02) · das Trial-Kontingent ist aufgebraucht (TRI-01).

429: Die Line lädt zu viele Playlists / EPG-Dateien gleichzeitig herunter – warten und erneut versuchen. 404-Seite: Das System antwortet bei jeder Ablehnung (falsche Daten, abgelaufen, gesperrt, Limit überschritten) mit 404, damit der Grund Fremden nicht verraten wird; prüfen Sie mit FIX-01.

Ihre Gruppe hat keine Berechtigung für diese Seite (ACC-02). Live Connections erfordert zusätzlich, dass der Admin für die Gruppe die Option zum Einsehen der Verbindungen der Kunden aktiviert (LINE-15).

E-Mails werden nur gesendet, wenn der Admin einen Mailserver konfiguriert und diese Art von Nachricht aktiviert hat; das Konto muss eine echte E-Mail-Adresse haben. Prüfen Sie den Spam-Ordner.