detain/phlix-plugin-musicbrainz
Composer 安装命令：
composer require detain/phlix-plugin-musicbrainz
包简介
MusicBrainz metadata provider for Phlix — artist/album/track metadata, album art, and AcoustID integration.
关键字：
README 文档
README
MusicBrainz metadata provider for Phlix — enriches your music library with artist/album/track metadata, album art from the Cover Art Archive, and AcoustID fingerprint integration.
Overview
Connects a Phlix server to MusicBrainz to enrich music items with comprehensive metadata:
- Artist metadata — names, aliases, country,begin/end dates, genres, tags
- Album metadata — release date, label, catalog number, barcode, genres
- Track metadata — track number, disc number, duration, ISRC codes
- Album artwork — fetched from the Cover Art Archive API
- AcoustID fingerprints — acoustic identification for tracks
It subscribes to phlix.media.metadata_enrich and phlix.library.scan_complete
to enrich music items during library operations.
Install
From the Phlix admin Plugins section, paste this repo's URL:
https://github.com/detain/phlix-plugin-musicbrainz
…or from the CLI:
php bin/phlix plugin:install https://github.com/detain/phlix-plugin-musicbrainz
Settings
| Setting | Type | Description |
|---|---|---|
enabled |
bool | Enable MusicBrainz metadata enrichment. |
user_agent |
string | MusicBrainz API user agent (must include contact email). |
rate_limit_delay |
int | Milliseconds between API requests (default 1100, respects 1 req/s limit). |
auto_enrich |
bool | Automatically enrich music items during library scans. |
fetch_album_art |
bool | Fetch album artwork from Cover Art Archive. |
fetch_acoustid |
bool | Calculate and fetch AcoustID fingerprints. |
search_depth |
string | Search depth: fast, normal, or deep. |
Development
composer install vendor/bin/phpunit
The entry class is Phlix\Plugin\MusicBrainz\MusicBrainzPlugin (implements
Phlix\Shared\Plugin\LifecycleInterface). It runs inside a Phlix server host,
which provides the library services at runtime.
API Rate Limiting
MusicBrainz requires no more than 1 request per second. This plugin enforces
a configurable delay (default 1100ms) between all API calls. Please configure
a valid user_agent with contact information so MusicBrainz can reach you if
there are issues.
License
MIT — see LICENSE.
统计信息
- 总下载量： 0
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 0
- 点击次数： 2
- 依赖项目数： 0
- 推荐数： 0
其他信息
- 授权协议： MIT
- 更新时间： 2026-07-10