piccoli-occhi/tv-fr-api-php

Lib to use the tv-fr API based on xml-tv-fr

Maintainers

Package info

github.com/piccoli-occhi/tv-fr-api-php

pkg:composer/piccoli-occhi/tv-fr-api-php

Statistics

Installs: 5

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

1.0.0 2026-06-24 14:40 UTC

This package is auto-updated.

Last update: 2026-06-24 14:41:02 UTC


README

API for French TV channels and programs based on racacax/XML-TV-Fr

Installation & Usage

Requirements

PHP 8.1 and later.

Composer

composer require piccoli-occhi/tv-fr-api-php

Manual Installation

Download the files and include autoload.php:

<?php
require_once('/path/to/piccoli-occhi/tv-fr-api-php/vendor/autoload.php');

Getting Started

Please follow the installation procedure and then run the following:

<?php
require_once(__DIR__ . '/vendor/autoload.php');




$apiInstance = new PiccoliOcchi\TvFrApi\Api\ChannelsApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client()
);
$id = 'id_example'; // string | Channel UUID or xmlId
$day = 20/05/2026; // string | DD/MM/YYYY (Europe/Paris)

try {
    $result = $apiInstance->getChannelDetails($id, $day);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling ChannelsApi->getChannelDetails: ', $e->getMessage(), PHP_EOL;
}

API Endpoints

All URIs are relative to https://tv-api.miceli.click

Class Method HTTP request Description
ChannelsApi getChannelDetails GET /api/channel/{id} Get a channel with its current and daily programs
ChannelsApi getChannels GET /api/channels List channels
ChannelsApi getTntChannels GET /api/channels/tnt List TNT free channels in broadcast order
ChannelsApi searchChannels GET /api/channels/search Search channels by name
ProgramsApi getCurrentPrograms GET /api/programs/now List currently airing programs
ProgramsApi getProgram GET /api/program/{id} Get a program by id
ProgramsApi getProgramsByDay GET /api/programs/{day} List programs for a specific day
SearXNGApi syncPosters GET /api/searxng/sync Sync poster images from SearXNG for programs without poster
StatusApi status GET /api/status Health check
TMDBApi handleNewPrograms GET /api/tmdb/init Initialize TMDB details for all programs
TMDBApi syncProgramScores GET /api/tmdb/sync Sync TMDB scores for current programs
XmlTvApi startJob GET /api/xml-tv/run Start cront to download new xml and update database

Models

Authorization

Endpoints do not require authorization.

Author

About this package

This PHP package is automatically generated by the OpenAPI Generator project:

  • API version: 1.0
    • Generator version: 7.24.0-SNAPSHOT
  • Build package: org.openapitools.codegen.languages.PhpClientCodegen