omnifilm / trakt

1.x-dev 2026-10-24 05:08 UTC

Requires

• php: >=8.2
• omniscient/omnifilm: ^1.0@dev
• symfony/http-client: ^6.4|^7.0|^8.0

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.0

MIT

• Marco Meyer

• tv
• movie
• episode
• trakt
• series
• framework-agnostic
• film
• omnifilm

Published on Packagist.org on 2026-10-24 05:09 UTC

README

omniscient/omnifilm's Trakt, under any PHP host, through Trakt's public API with an application's client id (no user signed in): search, a film's or a show's record (extended=full) and its people, a work or an episode by its Trakt, IMDb, TMDB or TheTVDB number (/search/{id_type}/{id}), a season's episodes. Trakt serves no pictures: its records carry the TMDB and TheTVDB numbers that lead to them (Registry::work() with omnifilm/tmdb).

$trakt = (new TraktFactory($httpClient))->create([
    'client_id' => getenv('TRAKT_CLIENT_ID'),
    'user_agent' => 'MySite/1.0 (+https://example.org)',
]);

Options: client_id and user_agent (required), api ("https://api.trakt.tv"), cast (20). Every request sends trakt-api-version: 2, trakt-api-key and the User-Agent.

Written on Symfony's HTTP client contracts, like the family: no client known that takes the application's client without a framework.

Trakt's terms

Trakt's API reference documents a limit of 1,000 GET calls every 5 minutes for an application, and asks every application to send a User-Agent naming it; its terms govern the data. The reference did not render for a re-reading on 2026-10-24: read both before going live.

Verified, and not

• Verified (the core's harness, PHP 8.4): search with the application's headers, a film by its IMDb number with its people, an episode, a season, not found, a refusal; BareTest; PHPStan max. The answers are shaped after Trakt's API reference and written by hand: no client id was used.
• Not verified live: no client id.

Responsibility

An independent, unofficial client, affiliated with, endorsed by or sponsored by none of the services it reaches. The MIT licence covers this code only and grants no right to the service or its data: whoever runs it complies with the terms above and obtains what they require. The authors publish it free of charge, make no commercial use of it and accept no liability for its use.

Licence

MIT.