Xtream Code API implementation

[JUL1EN094]

Hello everyone,

It would be very useful for me to have the Xtream code api implemented into this wonderful app I'm using everyday. I know a lot of users who will be very happy to have it as well and I already saw the request in other threads (like #202 (comment))

On my side I don't have the required skills to add it myself and so it would be great if a dev could work with me on this new feature. It is not so easy to find documentation and so on on the web, but I'm able to explain how it works and provide all required informations.

Is there any developper interested ?

============================================
Please find below the idea of Xtream code :

• User has to provide these informations : username, password and base_url. He needs as well to define a name for this xtream connection

• With these informations, we can get a full list of Lives, Serie and Movie streams. It can provide as well EPG and Replay, depending on the code provider.

============================================
2 possible ways to work with it

1. We can download directly an m3u file with all streams in it. It downloads all streams ordered by type (Live, Serie or Movie) and subcategories.

2. Or we can manage the browsing ourself by creating Lives, Series, Movies and Replays sub-folder for each xtream connection created. Then we are able to download the list of categories and related streams to each one. In this case we don't obtain the results with a m3u but in json format.

How I'm currently working with it and Fermata

Currently I do that MANUALLY to be able to use my xtream code in the app. I don't know if it's the best way but at least it works :

1. I download the full m3u file
2. Then I split it into three m3u file : Live, Serie and Movie --> Why : because the whole file is sometimes too big and can cause a memory issue on my mobile when I import it to the app
3. Then I check and remove/replace no ASCII characters in these 3 files.
4. At the end, I'm able to import these 3 m3u files in Fermata, either in the 'Folders' or in the 'TV' tab. Both works well.

The difficulty is lists can be updated everyday and so I have to repeat these steps each time I want to have updated playlist files in Fermata.

============================================
Please find below documentation

PARAMETERS :

• username --> <user> | ex: Mike
• password --> <pwd> | ex: 1234
• base_url --> <url> | ex: http://xtreamcode.ex

GET WHOLE STREAMS M3U (get.php) :

• Request : <url>/get.php?username=<user>&password=<pwd>&type=m3u_plus&output=ts
• Exemple : http://xtreamcode.ex/get.php?username=Mike&password=1234&type=m3u_plus&output=ts

LIVES (player_api.php) :

Get All live streams list :

• Request : <url>/player_api.php?username=<user>&password=<pwd>&action=get_live_streams
• Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_live_streams

Get live categories list :

• Request : <url>/player_api.php?username=<user>&password=<pwd>&action=get_live_categories
• Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_live_categories

Get streams list of a specific live category :

• Request : <url>/player_api.php?username=<user>&password=<pwd>&action=get_live_streams&category_id=<X>
• Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_live_streams&category_id=25

MOVIES (VOD) (player_api.php) :

Get All VOD streams list :

• Request : <url>/player_api.php?username=<user>&password=<pwd>&action=get_vod_streams
• Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_vod_streams

Get VOD categories list :

• Request : <url>/player_api.php?username=<user>&password=<pwd>&action=get_vod_categories
• Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_vod_categories

Get stream list of a specific VOD category :

• Request : <url>/player_api.php?username=<user>&password=<pwd>&action=get_vod_streams&category_id=<X>
• Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_vod_streams&category_id=4526

Get VOD stream infos :

• Request : <url>/player_api.php?username=<user>&password=c&action=get_vod_info&vod_id=<X>
• Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_vod_info&vod_id=999

SERIES (player_api.php) :

Get All serie streams list :

• Request : <url>/player_api.php?username=<user>&password=<pwd>&action=get_series
• Exemple : <http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_series

Get serie categories list :

• Request : <url>/player_api.php?username=<user>&password=<pwd>&action=get_series_categories
• Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_series_categories

Get streams list of a specific series category :

• Request : <url>/player_api.php?username=<user>&password=<pwd>&action=get_series&category_id=<X>
• Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_series&category_id=214>

Get a serie infos :

• Request : '/player_api.php?username=&password=&action=get_series_info&series_id='
• Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_series_info&series_id=865421

EPG (xmltv.php or player_api.php) :

Get full EPG list for ALL Streams :

• Request : <url>/xmltv.php?username=<user>&password=<pwd>
• Exemple : http://xtreamcode.ex/xmltv.php?username=Mike&password=1234

Get short EPG for a dedicated live streams :

• Request : <url>/player_api.php?username=<user>&password=<pwd>&action=get_short_epg&stream_id=36475

• can add &limit=<X> param (default=4)

• Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_short_epg&stream_id=55555

Get full EPG for a dedicated live stream :

• Request : <url>/player_api.php?username=<user>&password=<pwd>&action=get_simple_data_table&stream_id=<X>
• Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_simple_data_table&stream_id=55555

[AndreyPavlenko]

Thanks for the doc. It seems doable, but requires some time for development and a server for testing.

[AndreyPavlenko]

The cache is already implemented.

[jkc567]

Hello, can I help implement this requirement (Xtream Api), do you still need it? If so, contact me

[dtregobov]

I can also help with this and have a server for testing

[X-Morenzo]

hello, can you help me implement this Xtream Api please ? my goal is to create a proxy (getV2.php) between my xtream server and players (like Smartes Pro..) and I need to understand how it work
Thanks in advance

[jmylchreest]

I came across your post @X-Morenzo and although it doesnt support all the client specific filtering, or expose an XC code API to its own clients, I released made https://github.com/jmylchreest/m3u-proxy public recently. It works a bit like threadfin, and it's designed to consolidate and if desired transcode/support cyclic buffered streams to clients from external stream sources.

[asar-s]

Thanks for the help.
This worked for me.

[zimotech10]

I can't add my device with api. Help me.

[kevmax1]

Hi @AndreyPavlenko,
Please did you know how i can get the link for specific live, vod, series for my player ?

[AndreyPavlenko]

The Xtream code api examples, but I can't check.

[aguilarcarboni]

I am interested, is there anyway we can create a library for this? Doesn't seem too hard

[AndreyPavlenko]

Sorry, but currently I don't have time for that.

[zimotech10]

yes

[wlmirand]

@AndreyPavlenko Are you available to provide information about Xstream Api?
I have a personal goal which is to implement a working proxy, but for that id like to have a basic knowledge about what is Xtream Api and how it works... Maybe get access to some documentation.

[bLightZP]

I am actually implementing the Xtream Codes API into Zoom Player.

The original post includes all the information you need to write a proxy.

From my testing at the moment, there are some incompatibility between different providers and portions of the API are not supported by all providers.

When using this entry point, some providers ignore the "&limit" parameter:
/player_api.php?username=&password=&action=get_short_epg&stream_id=36475&limit=

And the returned JSON is not identical between providers, requiring workarounds and additional safety checks.

Not all providers support the get/xmltv entry points:
/xmltv.php?username=&password=
/get.php?username=&password=&type=m3u_plus&output=ts

[AndreyPavlenko]

@AndreyPavlenko Are you available to provide information about Xstream Api? I have a personal goal which is to implement a working proxy, but for that id like to have a basic knowledge about what is Xtream Api and how it works... Maybe get access to some documentation.

Sorry, I'm not an expert in this, but the description above seems very good and clear.

[fankloano]

I am actually implementing the Xtream Codes API into Zoom Player.

The original post includes all the information you need to write a proxy.

From my testing at the moment, there are some incompatibility between different providers and portions of the API are not supported by all providers.

When using this entry point, some providers ignore the "&limit" parameter: /player_api.php?username=&password=&action=get_short_epg&stream_id=36475&limit=

And the returned JSON is not identical between providers, requiring workarounds and additional safety checks.

Not all providers support the get/xmltv entry points: /xmltv.php?username=&password= /get.php?username=&password=&type=m3u_plus&output=ts

There are other was to get the EPG for a channel. Eventually I can help you?

[bLightZP]

There is a typo here:
Request : /player_api.php?username=&password=&action=get_simple_date_table&stream_id=
Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_simple_date_table&stream_id=55555

It's not "date", it's "data" 🤦‍♂️

[fankloano]

There is a typo here: Request : /player_api.php?username=&password=&action=get_simple_date_table&stream_id= Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_simple_date_table&stream_id=55555

It's not "date", it's "data" 🤦‍♂️

Just saw that you already know how to get the EPG :-) werde you successful in implementing the xtream api into your Player?

[bLightZP]

Yes, Zoom Player now supports the Xtream Codes API, but the EPG is a bit messy, is there no way to request EPG for multiple streams in one action?

[masterchief-417]

View the api i made https://github.com/masterchief-417/xtreme_codes_api_server

[masterchief-417]

Ill add documentation to the API but it's very basic, working on the search feature using cron to update json search files on a daily basis then using ss-search to search through json for requested data

[masterchief-417]

In the meantime use the insomnia json file to view routes. You need to install Insomnia

File: https://github.com/masterchief-417/xtreme_codes_api_server/blob/master/assets/Insomnia_2024-12-03.json

[masterchief-417]

Scratch that you can view documentation here https://9tzx6f0ozj.apidog.io

[lanangej]

I downloaded my m3u from panel, but the category and icon not include in it, i am already added and checked multiple times, but nothing change, how to solve this sir? Thanks

[Stem-LG]

any idea how to get an account's info ?

the official app from my provided display's the expiry date and n° of connected devices

edit:

for anyone looking here's how
<url>/player_api.php?username=X&password=X

[BadrtSoft]

Serie Infos wrong request query

Fix: Get a serie infos :

Get a serie infos :
Request : <url>/player_api.php?username=<user>&password=<pwd>&action=get_series_info&series_id=<X>
Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_series_info&series_id=865421

[lojadiegoinformatica]

Vou deixar um exemplo para vocês. Espero que ajude!

Esse método está funcionando com XCIPTV, Smarters e Windows IPTV 3.0.0.0 através do DNS. Ou seja, seu painel entregará os canais sem depender totalmente do Xtream XUI.

Você poderá configurar para que os dados sejam obtidos de um banco de dados ou de uma lista já existente. O objetivo é ter um servidor funcional utilizando apenas Apache, PHP e um código PHP convencional para:
✅ Controlar clientes
✅ Gerenciar conexões
✅ Manipular listas
✅ Adicionar arquivos diretamente

Com isso, tudo funcionará de forma automática!

Sabe aquela lista que você já tem, mas não consegue gerenciar os filmes caso seu cliente solicite? Com esse sistema, você poderá renomear títulos e adicionar novos filmes sem precisar de um servidor robusto, pois os conteúdos fonte serão carregados diretamente do servidor de origem (source) e você será o intermediário fazendo um by-pass porem entregando as modificações ou incrementos como canais próprios etc poderá até ser usado para fazer um sistema de tv interno ou externo ótimo para hotéis ou para exibir camêras etc as possibilidade são infinita.

No meu caso, utilizei:
🔹 VPS da Vultr
🔹 Domínio próprio
🔹 Porta 80
🔹 PHP 7.4
🔹 Memória do PHP aumentada para 512MB

Esse setup garante um funcionamento otimizado e eficiente!
Este com logs utilize com maneira de estudar os processos ao implementar🚀

<?php
header('Content-Type: application/json');
date_default_timezone_set('UTC');

ini_set("memory_limit", -1);
error_reporting(E_ALL);
ini_set('display_errors', 1);

// Função para logging
function writeLog($message, $type = 'INFO') {
    $logFile = __DIR__ . '/stream_errors.log';
    $timestamp = date('Y-m-d H:i:s');
    $logMessage = "[$timestamp][$type] $message" . PHP_EOL;
    file_put_contents($logFile, $logMessage, FILE_APPEND);
}

// Credenciais de teste
$TEST_USERNAME = "teste";
$TEST_PASSWORD = "123456";

// Categorias padrão
$default_categories = array(
    array(
        "category_id" => "1",
        "category_name" => "Canais Abertos",
        "parent_id" => 0
    ),
    array(
        "category_id" => "2",
        "category_name" => "Filmes",
        "parent_id" => 0
    ),
    array(
        "category_id" => "3",
        "category_name" => "Séries",
        "parent_id" => 0
    ),
    array(
        "category_id" => "4",
        "category_name" => "Documentários",
        "parent_id" => 0
    )
);

// Combinar POST e GET parameters
$params = array_merge($_GET, $_POST);

writeLog("Request received - Method: " . $_SERVER['REQUEST_METHOD'] . ", Parameters: " . json_encode($params));

// Primeira verificação - autenticação simples
if (isset($params['username']) && isset($params['password'])) {
    $output = array();
    
    if ($params['username'] === $TEST_USERNAME && $params['password'] === $TEST_PASSWORD) {
        writeLog("Authentication successful for user: {$params['username']}");
        $timestamp_now = time();
        
        if (!isset($params['action'])) {
            writeLog("No action specified, returning user info");
            $output["user_info"] = [
                'username' => $TEST_USERNAME,
                'password' => $TEST_PASSWORD,
                'message' => "",
                'auth' => 1,
                'status' => "Active",
                'exp_date' => strval($timestamp_now + 86400),
                'is_trial' => "1",
                'active_cons' => "0",
                'created_at' => strval($timestamp_now - 3600),
                'max_connections' => "1",
                'allowed_output_formats' => ["m3u8", "ts"]
            ];
            
            $output["server_info"] = [
                'url' => $_SERVER['HTTP_HOST'],
                'port' => "80",
                'https_port' => "0",
                'server_protocol' => "http",
                'rtmp_port' => "0",
                'timezone' => "UTC",
                'timestamp_now' => $timestamp_now,
                'time_now' => date('Y-m-d H:i:s'),
                'process' => true
            ];
        } 
        else if ($params['action'] === 'get_live_categories') {
            writeLog("Returning live categories");
            $output = $default_categories;
        }
        else if ($params['action'] === 'get_live_streams') {
            writeLog("Requesting live streams");
            
            // Filtrar por categoria se especificado
            $category_id = isset($params['category_id']) ? $params['category_id'] : null;
            $stream_id = isset($params['stream_id']) ? $params['stream_id'] : null;
            
            writeLog("Category filter: " . ($category_id ? $category_id : "none") . ", Stream ID: " . ($stream_id ? $stream_id : "none"));
            
            // Base URL para as streams
            $base_url = "http://sogra.top:80";
            $user_token = "531385733";
            $pass_token = "390432313";
            
            // Canais de exemplo
            $channels = array(
                array(
                    "num" => 1,
                    "name" => "Canal Exemplo 1",
                    "stream_type" => "live",
                    "stream_id" => "424177",
                    "stream_icon" => "",
                    "epg_channel_id" => "",
                    "added" => date('Y-m-d H:i:s'),
                    "category_id" => "1",
                    "tv_archive" => 0,
                    "direct_source" => "{$base_url}/{$user_token}/{$pass_token}/424177.ts",
                    "tv_archive_duration" => 0,
                    "ext" => "ts",
                    "token" => $pass_token,
                    "user_token" => $user_token,
                    "container_extension" => "ts",
                    "custom_sid" => "",
                    "tv_archive_duration" => 0,
                    "channel_type" => "live",
                    "status" => "1",
                    "url" => "{$base_url}/{$user_token}/{$pass_token}/424177",
                    "server_id" => "1",
                    "stream_status" => "1"
                ),
                array(
                    "num" => 2,
                    "name" => "SBT HD",
                    "stream_type" => "live",
                    "stream_id" => "44736",
                    "stream_icon" => "https://img.re/imagens/canais/SBT.png",
                    "epg_channel_id" => "",
                    "added" => date('Y-m-d H:i:s'),
                    "category_id" => "1",
                    "tv_archive" => 0,
                    "direct_source" => "{$base_url}/{$user_token}/{$pass_token}/44736.ts",
                    "tv_archive_duration" => 0,
                    "ext" => "ts",
                    "token" => $pass_token,
                    "user_token" => $user_token,
                    "container_extension" => "ts",
                    "custom_sid" => "",
                    "tv_archive_duration" => 0,
                    "channel_type" => "live",
                    "status" => "1",
                    "url" => "{$base_url}/{$user_token}/{$pass_token}/44736",
                    "server_id" => "1",
                    "stream_status" => "1"
                ),
                array(
                    "num" => 3,
                    "name" => "SBT Int SP HD",
                    "stream_type" => "live",
                    "stream_id" => "44737",
                    "stream_icon" => "https://img.re/imagens/canais/SBT.png",
                    "epg_channel_id" => "",
                    "added" => date('Y-m-d H:i:s'),
                    "category_id" => "1",
                    "tv_archive" => 0,
                    "direct_source" => "{$base_url}/{$user_token}/{$pass_token}/44737.ts",
                    "tv_archive_duration" => 0,
                    "ext" => "ts",
                    "token" => $pass_token,
                    "user_token" => $user_token,
                    "container_extension" => "ts",
                    "custom_sid" => "",
                    "tv_archive_duration" => 0,
                    "channel_type" => "live",
                    "status" => "1",
                    "url" => "{$base_url}/{$user_token}/{$pass_token}/44737",
                    "server_id" => "1",
                    "stream_status" => "1"
                )
            );

            // Se um stream_id específico foi solicitado
            if ($stream_id !== null) {
                writeLog("Filtering by stream_id: $stream_id");
                $filtered_channels = array_filter($channels, function($channel) use ($stream_id) {
                    return $channel['stream_id'] === $stream_id;
                });
                
                if (empty($filtered_channels)) {
                    writeLog("Stream ID $stream_id not found", 'ERROR');
                    $output = array();
                } else {
                    $output = array_values($filtered_channels);
                    writeLog("Stream found: " . $output[0]['name']);
                }
            }
            // Filtrar canais por categoria se necessário
            else if ($category_id !== null) {
                writeLog("Filtering channels by category_id: $category_id");
                $filtered_channels = array_filter($channels, function($channel) use ($category_id) {
                    return $channel['category_id'] === $category_id;
                });
                $output = array_values($filtered_channels);
            } else {
                $output = $channels;
            }

            writeLog("Returning " . count($output) . " channels");
            
            // Adicionar informações do servidor para cada canal
            foreach ($output as &$channel) {
                $channel['server_info'] = array(
                    'url' => $base_url,
                    'port' => "80",
                    'server_protocol' => "http",
                    'rtmp_port' => "0",
                    'https_port' => "0",
                    'server_type' => "live",
                    'time_now' => date('Y-m-d H:i:s'),
                    'timezone' => 'UTC',
                    'timestamp_now' => time(),
                    'process' => true
                );
            }
        }
        
        writeLog("Sending response: " . substr(json_encode($output), 0, 500) . "...");
        echo json_encode($output);
        exit;
    } else {
        writeLog("Authentication failed for user: {$params['username']}", 'ERROR');
        $output["user_info"]["auth"] = 0;
        echo json_encode($output);
        exit;
    }
}

// Segunda verificação - sistema existente
if (!empty(ipTV_lib::$request["username"]) && !empty(ipTV_lib::$request["password"])) {
    $valid_actions = array("get_live_categories", "get_vod_categories", "get_live_streams", "get_short_epg", "get_simple_data_table", "get_vod_streams", "get_vod_info");
    $username = ipTV_lib::$request["username"];
    $password = ipTV_lib::$request["password"];
    $action = (!empty(ipTV_lib::$request["action"]) && in_array(ipTV_lib::$request["action"], $valid_actions) ? ipTV_lib::$request["action"] : "");
    $output = array();

    if ($result = ipTV_Stream::GetUserInfo(NULL, $username, $password, true, true, true)) {
        // Adicionar canais de exemplo
        $sample_channels = [
            [
                "stream_id" => "424177",
                "name" => "Canal Exemplo 1",
                "stream_type" => "live",
                "stream_url" => "http://sogra.ok:80/531385733/390432313/424177.ts"
            ],
            [
                "stream_id" => "44736",
                "name" => "SBT HD CSLUXU",
                "stream_type" => "live",
                "stream_url" => "http://sogra.ok:80/531385733/390432313/44736.ts",
                "stream_icon" => "https://img.slim.re/imagens/canais/SBT.png"
            ],
            [
                "stream_id" => "44737",
                "name" => "SBT Int SP HD",
                "stream_type" => "live",
                "stream_url" => "http://sogra.ok:80/531385733/390432313/44737.ts",
                "stream_icon" => "https://img.slim.re/imagens/canais/SBT.png"
            ]
        ];

        switch ($action) {
            case "get_live_categories":
                $categories = GetCategories("live");
                foreach ($categories as $category) {
                    $output[] = Array("category_id" => $category["id"], "category_name" => $category["category_name"], "parent_id" => 0);
                }
                
                break;

            case "get_vod_categories":
                $categories = GetCategories("movie");
                foreach ($categories as $category) {
                    $output[] = Array("category_id" => $category["id"], "category_name" => $category["category_name"], "parent_id" => 0);
                }
                
                break;

            case "get_live_streams":
                $streams = ipTV_Stream::GetChannelsByBouquet($result["bouquet"]);
                $i = 0;
                foreach ($streams as $stream) {
                    $i ++;
                    if ((((isset($_GET["category_id"])) && ($stream["category_id"] == $_GET["category_id"])) OR (!isset($_GET["category_id"]))) && ($stream["type"] == 1)) {
                        $output[] = Array("num" => $i, "name" => $stream["stream_display_name"], "stream_type" => "live", "stream_id" => $stream["id"], "stream_icon" => $stream["stream_icon"], "epg_channel_id" => $stream["channel_id"], "added" => $stream["added"], "category_id" => $stream["category_id"], "tv_archive" => 0, "direct_source" => "", "tv_archive_duration" => 0);
                    }
                }
                // Adicionar canais de exemplo
                foreach ($sample_channels as $channel) {
                    $output[] = Array("num" => $i + 1, "name" => $channel["name"], "stream_type" => $channel["stream_type"], "stream_id" => $channel["stream_id"], "stream_icon" => $channel["stream_icon"], "epg_channel_id" => "", "added" => "", "category_id" => "", "tv_archive" => 0, "direct_source" => $channel["stream_url"], "tv_archive_duration" => 0);
                }
                break;

            case "get_vod_streams":
                $containers = Array();
                foreach (ipTV_Stream::GetContainers() as $container) {
                    $containers[$container["container_id"]] = $container["container_extension"];
                }
                $streams = ipTV_Stream::GetChannelsByBouquet($result["bouquet"]);
                $i = 0;
                foreach ($streams as $stream) {
                    $i ++;
                    if ((((isset($_GET["category_id"])) && ($stream["category_id"] == $_GET["category_id"])) OR (!isset($_GET["category_id"]))) && ($stream["type"] > 1)) {
                        $movie_properties = json_decode($stream["movie_propeties"], True);
                        if (isset($movie_properties["rating"])) {
                            $rating = floatval($movie_properties["rating"]);
                            $rating_5 = ceil($rating / 2.0);
                        } else {
                            $rating = null;
                            $rating_5 = 0;
                        }
                        $output[] = Array("num" => $i, "name" => $stream["stream_display_name"], "stream_type" => "movie", "stream_id" => $stream["id"], "stream_icon" => $movie_properties["movie_image"], "added" => $stream["added"], "category_id" => $stream["category_id"], "direct_source" => "", "rating" => $rating, "rating_5based" => $rating_5, "custom_sid" => null, "container_extension" => $containers[$stream["target_container_id"]]);
                    }
                }
                break;
                
            case "get_vod_info":
                $containers = Array();
                foreach (ipTV_Stream::GetContainers() as $container) {
                    $containers[$container["container_id"]] = $container["container_extension"];
                }
                if (isset(ipTV_lib::$request["vod_id"])) {
                    $vod = ipTV_Stream::GetMovieDetails(ipTV_lib::$request["vod_id"]);
                    $stream = ipTV_Stream::GetStream(ipTV_lib::$request["vod_id"]);
                    $movie_properties = json_decode($vod["movie_propeties"], True);
                    if (isset($movie_properties["rating"])) {
                        $rating = floatval($movie_properties["rating"]);
                    } else {
                        $rating = null;
                    }
                    $stream_info = $stream["stream_info"];
                    $audio = Array(); $video = Array();
                    $output["info"] = Array("imdb_id" => "", "movie_image" => $movie_properties["movie_image"], "genre" => $movie_properties["genre"], "plot" => $movie_properties["plot"], "cast" => $movie_properties["cast"], "director" => $movie_properties["director"], "rating" => $rating, "releasedate" => $movie_properties["releasedate"], "duration_secs" => $movie_properties["duration_secs"], "duration" => $movie_properties["duration"], "bitrate" => $stream["bitrate"], "kinopoisk_url" => "", "episode_run_time" => "", "youtube_trailer" => "", "actors" => $movie_properties["cast"], "name" => $vod["stream_display_name"], "name_o" => $vod["stream_display_name"], "cover_big" => $movie_properties["movie_image"], "description" => $movie_properties["plot"], "age" => "", "rating_mpaa" => "", "rating_count_kinopoisk" => 0, "country" => "", "backdrop_path" => [], "audio" => $audio, "video" => $video);
                    $output["movie_data"] = Array("stream_id" => $vod["id"], "name" => $vod["stream_display_name"], "added" => $vod["added"], "category_id" => $vod["category_id"], "container_extension" => $containers[$vod["target_container_id"]], "custom_sid" => "", "direct_source" => "");
                }
                break;

            case "get_short_epg" || "get_simple_data_table":
                if (isset(ipTV_lib::$request["stream_id"])) {
                    $stream_id = intval(ipTV_lib::$request["stream_id"]);
                    if ($action == "get_simple_data_table") {
                        $limit = 1000;
                    } else {
                        if (isset($_GET["limit"])) {
                            $limit = $_GET["limit"];
                        } else {
                            $limit = 4;
                        }
                    }
                    $EPGs = GetEPGStreamPlayer($stream_id, $limit);
                    $return = Array();
                    $i = 0;
                    foreach ($EPGs as $EPG) {
                        $i ++;
                        if ($action == "get_simple_data_table") {
                            if ($i == 1) {
                                $EPG["now_playing"] = 1;
                            } else {
                                $EPG["now_playing"] = 0;
                            }
                            $EPG["has_archive"] = 0;
                        }
                        $EPG["title"] = base64_encode($EPG["title"]);
                        $EPG["description"] = base64_encode($EPG["description"]);
                        $EPG["start_timestamp"] = $EPG["start"];
                        $EPG["stop_timestamp"] = $EPG["end"];
                        $EPG["start"] = date("Y-m-d H:i:s", $EPG["start"]);
                        $EPG["end"] = date("Y-m-d H:i:s", $EPG["end"]);
                        $return[] = $EPG;
                    }
                    echo json_encode(Array("epg_listings" => $return));
                    exit();
                }
                else {
                    echo json_encode(array());
                    exit();
                }
                break;

            default:
                $output["user_info"] = array();
                $url = (empty(ipTV_lib::$StreamingServers[SERVER_ID]["domain_name"]) ? ipTV_lib::$StreamingServers[SERVER_ID]["server_ip"] : ipTV_lib::$StreamingServers[SERVER_ID]["domain_name"]);
                $output["server_info"] = array("url" => $url, "port" => $_SERVER["SERVER_PORT"], "server_protocol" => "http", "timezone" => date_default_timezone_get(), "timestamp_now" => time(), "time_now" => date("Y-m-d H:i:s"), "rtmp_port" => "", "https_port" => "");
                $output["user_info"]["username"] = $result["username"];
                $output["user_info"]["password"] = $result["password"];
                $output["user_info"]["auth"] = 1;
                $output["user_info"]["message"] = "";

                if ($result["admin_enabled"] == 0) {
                    $output["user_info"]["status"] = "Banned";
                }
                else if ($result["enabled"] == 0) {
                    $output["user_info"]["status"] = "Disabled";
                }
                else {
                    if (is_null($result["exp_date"]) || (time() < $result["exp_date"])) {
                        $output["user_info"]["status"] = "Active";
                    }
                    else {
                        $output["user_info"]["status"] = "Expired";
                    }
                }
                $output["user_info"]["exp_date"] = $result["exp_date"];
                $output["user_info"]["is_trial"] = $result["is_trial"];
                $output["user_info"]["active_cons"] = $result["active_cons"];
                $output["user_info"]["created_at"] = $result["created_at"];
                $output["user_info"]["max_connections"] = $result["max_connections"];
                $output["user_info"]["allowed_output_formats"] = array_keys($result["output_formats"]);
        }
    }
    else {
        $output["user_info"]["auth"] = 0;
    }
    echo json_encode($output);
}
?>

[abdelilahelomari]

how to get stream vod subtitles and sounds

[BadrtSoft]

It's not possible you can't get that via API

[shahbaz4783]

how to get playable video url? whats the format of that please tell that too.
i tried this but not working

<url>/movie/<username>/<password>/1306018.mp4

[fankloano]

Are you sure that .mp4 is the correct container Format?

[miece]

Has the get.php been removed from the api request? It doesn't load when called and throws a 884 http code in the browser?

I'm trying to figure out now how to download the m3u playlist

[kramsram]

get.php will be avail if the service supports m3u files ... or they may only support xtreme codes

[zohaibcodes9642]

Hi. so the issue about 884 has been teasing me a lot but I found a solution for it.

So instead of you calling the m3u playlist.
we need to call the relevant apis to get the stream id

for example i have
const url = ${playlist.canonical_url.split("/player_api.php")[0]}/player_api.php?username=${username}&password=${password}&action=get_live_streams;

const url = ${playlist.canonical_url.split("/player_api.php")[0]}/player_api.php?username=${username}&password=${password}&action=get_vod_streams;

const url = ${playlist.canonical_url.split("/player_api.php")[0]}/player_api.php?username=${username}&password=${password}&action=get_series;

these do give us the stream id with all the objects.

adn then we simply need to call
http://cdnpro.marovis.xyz:80/live/<Usename>/<Password>/<stream_id>.m3u8

TS flavor if needed:

http://cdnpro.marovis.xyz:80/live/<Usename>/<Password>/<stream_id>.ts

So when you need to call the m3u playlist to get the streaming URLs, and getting 884 error. Have a fallback for it to use this instead. So that you don't need to save the playlist URLs at all and can fetch them in real-time.

[jojoeric]

Hello, I'm trying to download the whole m3u playlist from get.php, it connects to the server and spits out the server-side 884 error. Anybody knows what this error code is supposed to mean? I gotta mention it did work 5 months ago, I just haven't checked it since.

I did try vpn's, different accounts, browsers, outputs, cdn's, same scenario every time. My bet is that the endpoint is disabled for some reason.

[zohaibcodes9642]

Hi. so the issue about 884 has been teasing me a lot but I found a solution for it.

So instead of you calling the m3u playlist.
we need to call the relevant apis to get the stream id

for example i have
const url = ${playlist.canonical_url.split("/player_api.php")[0]}/player_api.php?username=${username}&password=${password}&action=get_live_streams;

const url = ${playlist.canonical_url.split("/player_api.php")[0]}/player_api.php?username=${username}&password=${password}&action=get_vod_streams;

const url = ${playlist.canonical_url.split("/player_api.php")[0]}/player_api.php?username=${username}&password=${password}&action=get_series;

these do give us the stream id with all the objects.

adn then we simply need to call
http://cdnpro.marovis.xyz:80/live/<Usename>/<Password>/<stream_id>.m3u8

TS flavor if needed:

http://cdnpro.marovis.xyz:80/live/<Usename>/<Password>/<stream_id>.ts

So when you need to call the m3u playlist to get the streaming URLs, and getting 884 error. Have a fallback for it to use this instead. So that you don't need to save the playlist URLs at all and can fetch them in real-time.

[zohaibcodes9642]

Hi. so the issue about 884 has been teasing me a lot but I found a solution for it.

So instead of you calling the m3u playlist.
we need to call the relevant apis to get the stream id

for example i have
const url = ${playlist.canonical_url.split("/player_api.php")[0]}/player_api.php?username=${username}&password=${password}&action=get_live_streams;

const url = ${playlist.canonical_url.split("/player_api.php")[0]}/player_api.php?username=${username}&password=${password}&action=get_vod_streams;

const url = ${playlist.canonical_url.split("/player_api.php")[0]}/player_api.php?username=${username}&password=${password}&action=get_series;

these do give us the stream id with all the objects.

adn then we simply need to call
http://cdnpro.marovis.xyz:80/live/<Usename>/<Password>/<stream_id>.m3u8

TS flavor if needed:

http://cdnpro.marovis.xyz:80/live/<Usename>/<Password>/<stream_id>.ts

So when you need to call the m3u playlist to get the streaming URLs, and getting 884 error. Have a fallback for it to use this instead. So that you don't need to save the playlist URLs at all and can fetch them in real-time.

[LineRunner17]

That's my man! Awesome! Thank you, that's exactly what I needed! Out of curiosity, how did you figure it out? I needed it to reverse engineer the m3u8 list that I usually was able to download directly.
EDIT:
I also figured out one way how to get to the stream_id of single episodes: query parameter action and series_id in this combination works for me. a bit inconvient, but better than nothing.
&action=get_series_info&series_id={series_id}

[zohaibcodes9642]

Actually what I did was pretty simple, just took some trial and error.
The 884 error usually happens when the playlist you're trying to load isn’t valid for your region. So I grabbed a playlist that does work in my region and checked how the stream URL was being built from there.

From that working playlist, I noticed the final URL included three things:

1. my username
2. my password
3. a unique stream_id

So I went back to the data we already get from
get_live_streams, get_vod_streams, and get_series,
and I realized that every item already contains the exact stream_id.
I started testing different stream IDs for live channels, movies, and series — and the pattern worked every single time. That’s when I realized we don’t need to rely on the M3U playlist at all. We can just fetch the metadata via API, grab the stream_id, and build the URL ourselves.

Since the app is for our clients, this approach is much more reliable and avoids the entire region-lock issue. And I figured sharing it might help others running into the same 884 problem.

If you find any other hidden endpoints, keep me posted — this backend clearly has more tricks up its sleeve. 😄

But I do need a way to get the playlists of other regions to work for my region. Either using some proxy or Multi region deployment on AWS. @LineRunner17 But if you have any suggestions on it, Do let me know buddy.

[atualizarinicial]

My name is Luiz Felipe. I am from Brazil.
well, i don't know how to program, i made using IA.

Thanku - after a little bit of work, i made my player, and u guys can test it if u want:

assistirtv.top

[zohaibcodes9642]

@atualizarinicial If you need help in coding. do let me know.
my email is
zohaibmalik964242@gmail.com

[jamestapping]

my iOS IPTV app - "playr" is testable here

https://testflight.apple.com/join/GMnd6gA6

Let me know what you think :)

edit: added to the appStore now

https://apps.apple.com/fr/app/playr-iptv-player/id6449495747

[dadixon]

How did you get the movie videos to play? What was your url?

[jamestapping]

How did you get the movie videos to play? What was your url?

Do you still need to know ? Happy to answer but I need to check :)

[zohaibcodes9642]

Thats easy @dadixon

It depends on if u r trying to play a livestream or a movie or a series.

For a livestream its gonna be

http://<host>:<port>/live/<Usename>/<Password>/<stream_id>.ts
meanwhile for the movies or series. the format is similar but with a small variation which even claudecode or codex might help you with.

[hamzenis]

It got mentioned a couple of times here in the thread, but the following part needs to be corrected:

Get a serie infos :

• Request : <url>/player_api.php?username=<user>&password=<pwd>&action=get_series_info&series=<X>
• Exemple : http://xtreamcode.ex/player_api.php?username=Mike&password=1234&action=get_series_info&series=865421

The parameter should be series_id
<url>/player_api.php?username=<user>&password=<pwd>&action=get_series_info&series_id=<X>

[jamestapping]

Hello,

does anybody have an example link for replay /catchup ? I'm having trouble finding any information about how it works.

Thanks

[enterprisemk]

Late to the party....

The Catchup facility depends on whether the provider has that facility enabled, it can be seen in these JSON values:

"tv_archive": 1,
"tv_archive_duration": "7"

"tv_archive": 1 means Catch-Up TV is Active for this channel.
"tv_archive_duration": "7" means you can scroll back in the EPG and watch shows from up to 7 days ago.

The API call to actually play a past show is very similar to playing a live stream, but involves appending the timeshift timestamp parameters to the streaming URL.

I hope this helps someone

[jamestapping]

Thanks a lot, I did manage to use Charles(proxy) on a working app and understand a bit more about how it works too. When I dp eventually implement it, I'll put the info here.

[malebuffy]

Guys I made Xtream integration for anyone interested:

#727

[victorvjho-debug]

Cómo seria la API para crear usuario y para eliminar usuario

[ninjadarkgo]

Bueno, es que player_api.php es la API pública de autenticación de XtreamCodes, la API para crear - eliminar o editar un usuario corresponde a la API de reseller o admin.

Y esa es otra completamente diferente

[araaryazid4-alt]

xtreamcode.ex

[Panavidia]

Hola,

Finally, I've released my first IPTV app which I first started after stumbling across this repo 12 months ago.

Android phone/tablet - Downloader code: 1205176
Fire TV / Google TV / Android TV Cast Client: Downloader code: 5919666

Windows 10/11: https://downloads.panavidiatechlabsltd.com/apps/PanavidiaProSetup.exe
MacOS (Intel): https://downloads.panavidiatechlabsltd.com/apps/panavidiapro_x64.dmg
MacOS: (Apple Silicon): https://downloads.panavidiatechlabsltd.com/apps/panavidiapro_arm64.dmg
iOS / iPad: waiting for App Store approval :(

Enjoy

[Panavidia]

On your Mac, go to: Security -> Privacy & Security and on the right-hand-side scroll down to: Settings / Allow applications from, and select Panavidia Pro (after you tried installing it).

This is the usual scenario for side-loading unverified apps on macOS.

100% works as I just downloaded the .DMG file on a no-dev macbook pro and followed that process

[KittyBua]

Hola,

Finally, I've released my first IPTV app which I first started after stumbling across this repo 12 months ago.

Android phone/tablet - Downloader code: 1205176 Fire TV / Google TV / Android TV Cast Client: Downloader code: 5919666

Windows 10/11: https://downloads.panavidiatechlabsltd.com/apps/PanavidiaProSetup.exe MacOS (Intel): https://downloads.panavidiatechlabsltd.com/apps/panavidiapro_x64.dmg MacOS: (Apple Silicon): https://downloads.panavidiatechlabsltd.com/apps/panavidiapro_arm64.dmg iOS / iPad: waiting for App Store approval :(

Enjoy

No find the Codes in Downloader Android

1205176

5919666

Send Apk please

Found

Ready

[enterprisemk]

Fire TV cast client:
https://downloads.panavidiatechlabsltd.com/apps/panavidiapro_castrx.apk

Android tablet/phone:
https://downloads.panavidiatechlabsltd.com/apps/panavidiapro64.apk

[zohaibcodes9642]

No Option here

[Panavidia]

email the issue to: support at panavidia.com

[KittyBua]

Hey, this is an old thread! But I have a few lines where I can only use Xtream codes (XCI Xtream) because the standard URL doesn't load—so it has to be Xtream. However, there is a way to get an M3U file out of Xtream!

Of course, you can also use the player_api method, but it downloads the file as playlist.php.json, which no player can play—not even the player_api URLs themselves!

With IPTV Extreme, there is a utility to convert Xtream to a local M3U file (resulting in something like playlist.m3u.m3u8), and that file works in any player!

https://m3ufy.com/downloader.html

IPTV Extreme can also perform this conversion from XCI to an M3U playlist file!

My question is: how can I manually download a playlist.m3u file using that kind of URL—instead of using player_api or a converter? In other words, how can I do it myself directly in the browser?

http://xtreamcode.ex/get.php?username=1234&password=1234&type=m3u_plus&output=ts

To playlist.m3u

[hsoon-2171]

لقد قمت بالاشتراك ولا كني لم أحصل على اشتراكي ولم احصل على اسم المستخدم وكلمة المرور والرابط.ارجو الرد

[hsoon-2171]

أي اشتراكي

[zohaibcodes9642]

Subscribed where?

[hsoon-2171]

Xtream

[hsoon-2171]

شكرًا جزيلاً
لقد اشتريت اشتراكًا من "Nguyen Thi Linh" على Google Play. سيتجدّد الاشتراك تلقائيًّا يوم 29‏/08‏/2027 ما لم يتم إلغاؤه قبل هذا التاريخ. ويُرجى العلم أنّه يمكنك إلغاء الاشتراك في أيّ وقت. إدارة الاشتراكات

رقم الطلب: GPA.3365-7130-0247-81903
تاريخ الطلب: 29‏/08‏/2026 10:14:33 م غرينتش+3
حسابك: hsoon.21712030@gmail.com
العنصر السعر
iptv_sub_year_promo (IPTV Smart Player: Live TV) ‏٤٢٫٩٩ ر.س.‏/سنة
تجديد تلقائي للاشتراك
الإجمالي: ‏٤٢٫٩٩ ر.س.‏/سنة
(تتضمن ضريبة القيمة المضافة بمبلغ ‏٥٫٦١ ر.س.‏).

[zohaibcodes9642]

I don't own it, you can get it from better providers. I am building an IPTV App myself for my customers and clients that will have many features instead of only generic ones

[hsoon-2171]

اين الاشتراك الخاص بي لقد قمت بالاشتراك ولم احصل على اسم المستخدم وكلمة المرور والرابط في الأحد، ٣٠ أغسطس، ٢٠٢٦، ١٢:٥٠ م Zohaib ***@***.***> كتب:

…

Image: image (view on web) <https://github.com/user-attachments/assets/65637985-649c-4a05-ab37-a806c67d80b3> No Option here — Reply to this email directly, view it on GitHub <#434?email_source=notifications&email_token=CM6KVYE3Y44V4W2IQMFR35D5MP2F5A5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBSGA2TONBWUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSWGM33PORSXEX3DNRUWG2Y#discussioncomment-18205746>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/CM6KVYAZRTH7KQMWYMBG4K35MP2F5AVCNFSNUABHKJSXA33TNF2G64TZHMZDEOJYGA4TKMZYHNCGS43DOVZXG2LPNY5TMMZUGYYDIMVBOYBA> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/CM6KVYEXUOMI2BDABDRHBXD5MP2F5A5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBSGA2TONBWUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSVGM33PORSXEX3JN5ZQ> and Android <https://github.com/notifications/mobile/android/CM6KVYFHVPJAZC4POFBRK7D5MP2F5A5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBSGA2TONBWUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSXGM33PORSXEX3BNZSHE33JMQ>. Download it today! You are receiving this because you commented.Message ID: ***@***.***>

[ahdkhwaji33-afk]

Please ineed extreme code