Metadata-Version: 2.4
Name: librelyrics-applemusic
Version: 1.0.0
Summary: Apple Music lyrics provider plugin for LibreLyrics
Author-email: libre-lyrics <libre-lyrics@users.noreply.github.com>
License: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/libre-lyrics/librelyrics-applemusic
Project-URL: Repository, https://github.com/libre-lyrics/librelyrics-applemusic
Project-URL: Issues, https://github.com/libre-lyrics/librelyrics-applemusic/issues
Keywords: lyrics,apple-music,lrc,synced-lyrics,librelyrics,plugin
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: librelyrics>=1.0.0
Requires-Dist: requests>=2.28.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: lxml>=4.9.0
Dynamic: license-file

# librelyrics-applemusic

Apple Music lyrics provider plugin for [LibreLyrics](https://github.com/libre-lyrics/librelyrics).

## Features

- Fetch plain, synced, and rich synced (word-level) lyrics from Apple Music
- Support for track and album URLs
- Karaoke-style Enhanced LRC output

## Installation

```bash
pip install librelyrics-applemusic
```

## Configuration

Requires `media_user_token` from Apple Music. Set it up via:

```bash
librelyrics config edit
```

### Getting your token

1. Open [Apple Music Web Player](https://music.apple.com) in your browser
2. Log in to your account
3. Open Developer Tools (F12) → Application/Storage → Cookies
4. Copy the `media-user-token` cookie value (`media_user_token`)

## Supported URLs

- `https://music.apple.com/<region>/album/<name>/<id>?i=<track_id>`
- `https://music.apple.com/<region>/album/<name>/<id>`

## Usage

Once installed, the plugin is automatically discovered by LibreLyrics:

```bash
librelyrics "https://music.apple.com/us/album/some-album/123456789?i=987654321"
```

## License

GPL-3.0-or-later
