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.item.added (throttled background enrichment) and phlix.playback.stopped (episode progress sync).

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	Tier	Required	Default	Description
enabled	bool	standard	no	false	Master on/off for AniList sync/matching.
access_token	string (secret)	standard	no	—	Personal AniList API access token, pasted in by hand. Create one at anilist.co/settings/developer. Phlix does not run an AniList OAuth flow. Required for list sync and writing progress back.
username	string	standard	no	—	Your AniList username, used to pull your lists during sync.
sync_enabled	bool	advanced	no	true	Sync watched/progress with your AniList list.
sync_interval_minutes	int	advanced	no	60	How often to sync with AniList.
auto_match	bool	advanced	no	true	Auto-match anime to AniList entries using external IDs.

Development

composer install
vendor/bin/phpunit
vendor/bin/phpstan analyse src --level=9
vendor/bin/phpcs src --standard=PSR12

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

License

MIT — see LICENSE.