detain/phlix-plugin-trakt

Trakt scrobbler plugin for Phlix — scrobbles playback to Trakt.tv and syncs watch history over the Trakt OAuth API.

v1.2.0 2026-07-11 00:58 UTC

Requires

• php: >=8.3
• detain/phlix-shared: ^0.18.0
• psr/container: ^1.1 || ^2.0
• psr/log: ^1.0 || ^2.0 || ^3.0

Requires (Dev)

• phpstan/phpstan: ^2.2
• phpunit/phpunit: ^10.0
• squizlabs/php_codesniffer: ^4.0

MIT

• scrobbling
• trakt
• scrobbler
• phlix
• phlix-plugin
• watch-history

Published on Packagist.org on 2026-07-11 00:59 UTC

README

Trakt scrobbler plugin for Phlix — scrobbles playback to Trakt.tv and syncs your watch history over the Trakt OAuth API.

Overview

Connects a Phlix server to your Trakt.tv account:

• Scrobbles playback (start / pause / stop) so Trakt shows what you're watching in real time and marks items watched at the end.
• Two-way history sync — pulls your Trakt watch history into Phlix and pushes Phlix completions back to Trakt on a configurable interval.
• Authenticates via OAuth, refreshing tokens automatically.

It subscribes to phlix.playback.started, phlix.playback.stopped, and phlix.playback.progress.

Install

From the Phlix admin Plugins section, paste this repo's URL:

https://github.com/detain/phlix-plugin-trakt

…or from the CLI:

php bin/phlix plugin:install https://github.com/detain/phlix-plugin-trakt

Settings

Setting	Type	Required	Secret	Default	Description
enabled	boolean	No	No	false	Master on/off for Trakt scrobbling and sync. Optional; default off.
username	string	No	No	""	Display-only: the Trakt account Phlix is linked to (set during authorization).
access_token	string	No	Yes	null	Obtained automatically when you authorize Phlix with Trakt — you do not enter this by hand. Create an API app only if you self-host credentials.
refresh_token	string	No	Yes	null	Set automatically during authorization; used to renew the access token. Not entered by hand.
expires_at	integer	No	Yes	null	Unix timestamp when the access token expires. Managed automatically.
sync_enabled	boolean	No	No	true	Sync watched state with Trakt. Optional; default on.
sync_interval_minutes	integer	No	No	30	How often to sync with Trakt. Optional; default 30.
scrobble_enabled	boolean	No	No	true	Report play/pause/stop to Trakt as you watch. Optional; default on.

access_token / refresh_token / expires_at are set automatically via the Trakt authorization (OAuth) flow — you never enter them by hand. Create an API application at https://trakt.tv/oauth/applications only if you self-host your own Trakt credentials.

Development

composer install
vendor/bin/phpunit

The entry class is Phlix\Plugins\Scrobbler\Trakt\TraktPlugin (implements Phlix\Shared\Plugin\LifecycleInterface). It runs inside a Phlix server host, which provides the playback/library services at runtime.

License

MIT — see LICENSE.