jellyfin-plugin-lyrics/README.md

# Jellyfin Lyrics Plugin

A plugin for Jellyfin that automatically downloads and applies the lyrics for the songs in your music library from [lrclib.net](https://lrclib.net).

## 🎵 Features

- Automatic lyrics download for your entire music library
- Integrates seamlessly with Jellyfin's music player
- Downloads Lyrics directly from lrclib.net
- Real-time lyrics display during playback

## 🚀 Installation

1. Ensure your Jellyfin server is updated to version 10.9.11 or above
2. Add the plugin repository to Jellyfin:

   ```text
   https://raw.githubusercontent.com/Felitendo/jellyfin-plugin-lyrics/master/manifest.json
3. Navigate to the Plugin Catalog in your Jellyfin dashboard
4. Find "Lyrics" under the "Notifications" category and install it
5. Go to Scheduled Tasks and run "Download missing lyrics"
6. Scan all libraries to complete the integration

## 📝 Manual Refresh

If lyrics aren't appearing for specific albums:
1. Navigate to the album
2. Right-click
3. Select "Refresh metadata"

## 🔍 Troubleshooting

- **Plugin not appearing?** Verify your Jellyfin version is 10.9.11 or above
- **Lyrics not showing up?** Make sure you've completed all installation steps and refreshed metadata
- **Missing lyrics for specific songs?** Try manually refreshing the metadata for those items

## 💡 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

## 📞 Support

- Create an [Issue](https://github.com/Felitendo/jellyfin-lyrics-plugin/issues)
- Write an [E-Mail](mailto:support@felo.gg)
- Join my [Discord Server](https://felo.gg/felocord)