detain/phlix-plugin-anilist

AniList metadata provider for Phlix — anime/manga metadata, watchlist sync, and GraphQL integration.

v0.2.0 2026-07-11 00:59 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

• metadata
• watchlist
• anime
• graphql
• manga
• phlix
• phlix-plugin
• anilist

Published on Packagist.org on 2026-07-11 01:02 UTC

README

AniList metadata provider for Phlix — anime/manga metadata, watchlist sync, and GraphQL integration.

Overview

Connects a Phlix server to AniList to enrich your media library with anime and manga metadata:

• Metadata enrichment — fetches titles, descriptions, genres, average scores, and cover images via the AniList GraphQL API.
• Watchlist sync — synchronizes your AniList watching/watched/plantowatch status back to Phlix.
• Episode progress — tracks which episodes you've completed for series.
• Average score & favorites — surfaces AniList scores and favourite status.

It subscribes to phlix.library.scan.completed and phlix.playback.stopped.

Install

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

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

…or from the CLI:

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

Settings

Configure these in the Phlix admin Plugins → Configure dialog.

Setting	Type	Required	Default	Description
enabled	bool	no	false	Master on/off for AniList sync/matching.
access_token	string (secret)	no	—	Set automatically when you authorize Phlix with AniList — not entered by hand. Register a client at anilist.co/settings/developer only if you self-host credentials.
username	string	no	—	Display-only: the AniList account Phlix is linked to.
sync_enabled	bool	no	true	Sync watched/progress with your AniList list.
sync_interval_minutes	int	no	60	How often to sync with AniList.
auto_match	bool	no	true	Auto-match anime to AniList entries using external IDs.

Development

composer install
vendor/bin/phpunit

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

License

MIT — see LICENSE.