Better Lyrics upgrades your YouTube Music experience by providing beautiful time-synced lyrics for your favorite songs.

• Features
• Download
• Usage
• Options
• Styling
• Extension Permissions
• Manual Installation
• FAQ
• Funding
• Discord Community
• Contributing
• License
• Privacy
• Contributors ✨

🎵 Displays beautiful time-synced lyrics on YouTube Music
📦 Requires no external dependencies or configurations
⏩ Lets you seek by clicking on any line
🌏 Supports multiple languages
🪶 Runs lightweight and fast
🖥️ Includes full-screen mode
✨ And much more!

1. Open YouTube Music and start playing a song.
2. Click on the lyrics tab to view time-synced lyrics. (This might take a few seconds to load)
3. Click on a specific line to seek to that part of the song.

Custom styling for lyrics is available from Better Lyrics v1.7.0 onwards. This allows you to personalize the appearance of both lyrics and the entire YouTube Music interface. For detailed instructions on customizing styles, importing/exporting themes, and using pre-made themes, please consult our Styling Guide.

Better Lyrics does not collect any personal data or track your browsing activity. The extension is open-source and thoroughly reviewed by the community to ensure that your privacy is protected.

1. Clone this repository or download the ZIP file from releases page.
2. Open Google Chrome and go to chrome://extensions.
3. Enable "Developer mode" by toggling the switch in top right corner.
4. Click on "Load unpacked" and select the folder where you cloned/downloaded this repository.
5. Better Lyrics should now be installed and ready to use!

1. Clone this repository or download the ZIP file from releases page.
2. Open Firefox and go to about:debugging#/runtime/this-firefox.
3. Copy the contents of manifest.firefox.json and paste it in manifest.json.
4. Click on "Load Temporary Add-on" and select the manifest.json file in the cloned/downloaded folder.
5. Better Lyrics should now be installed and ready to use!

Make sure the extension is enabled and you're on https://music.youtube.com. The extension won't work on https://youtube.com.

Click the Better Lyrics icon in your extensions toolbar to access settings. Changes apply immediately without needing to refresh the page. However, in some cases, for example, after updating the extension, you might need to refresh for settings or CSS updates to take effect.

Try refreshing the page, especially if you recently updated the extension. Your CSS changes are saved either way. If that doesn't work, try disabling and re-enabling the extension.

Press F on your keyboard (with the window in focus) or hover over the player bar and click the full-screen icon (⛶). Make sure "Disable fullscreen mode" option isn't checked in extension settings.

Enable the "Translations" option in extension settings and select your desired language from the dropdown.

Yes you can! Please follow the contributing guidelines below.

If you find any issues with lyrics, you now have two options:

1. Toggle or reorder providers in extension settings
2. Contribute your own lyrics using LRCLIBup

LRCLIBup allows you to submit correct, properly synchronized lyrics that will be available to all users who use the LRCLib provider. This is a community-driven approach to improving and adding lyrics, so please be mindful of quality.

You can contribute lyrics using LRCLIBup, our LRCLib upload tool:

1. Visit https://lrclibup.boidu.dev
2. Follow the tool's interface to upload lyrics
3. Submit your contribution

This helps improve the lyrics database for all Better Lyrics users who use the LRCLib provider.

Open an issue here with as much detail as possible. Alternatively, join our Discord community and report it under #bug-reports.

Yes! Follow the manual installation instructions above to install an older version of the extension. Keep in mind that older versions probably won't be maintained or get new features.

Better Lyrics is free and open-source. The easiest way to support it is by leaving positive feedback on the Chrome Web Store, Firefox Add-ons, or Microsoft Edge Add-ons so more people can discover it.

If you want to support the project further, consider making a donation to help cover hosting and development costs. You can donate via GitHub Sponsors.

No. Better Lyrics will always be free and open-source for everyone.

Yes, Better Lyrics should work with most extensions. If you encounter issues, report them under #bug-reports in our Discord Server or open an issue here.

Better Lyrics is currently only available for desktop browsers. However, if you use a browser that supports extensions on mobile (such as Kiwi Browser on Android), you should be able to use it since the extension is responsive and has feature parity across platforms.

Yes! Better Lyrics supports switching between different providers. You can reorder or toggle providers via extension settings:

1. Click the Better Lyrics icon in the extensions toolbar
2. Go to "Sources" tab
3. Reorder or toggle providers as per your needs

Adding custom providers isn't currently supported.

Right now, Better Lyrics is available for Chrome, Firefox, and Edge (and other Chromium-based browsers like Brave, Opera, Arc, etc.). If there's enough demand, I might consider porting it to other browsers.

No, Better Lyrics is specifically designed for YouTube Music. If you want something similar for other streaming services, check out these extensions. If you have suggestions for others, open a PR to add them to this list:

• Beautiful Lyrics - Spotify

Join our Discord community to discuss Better Lyrics and get support from developers and other users:

https://discord.gg/UsHE3d5fWF

Contributions are welcome! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request.

This project is licensed under the GNU GPLv3 License. As long as you attribute me or Better Lyrics as the original creator and comply with the rest of the license terms, you can use this project for personal or commercial purposes.

We take your privacy very seriously. Better Lyrics is built to be privacy-conscious by design.

• We only collect the absolute minimum standard data needed for the extension to work (e.g., song metadata to fetch lyrics, and your IP address for security, authentication and service delivery).
• API request logs are kept for a maximum of 7 days for debugging purposes.
• We never have and never will sell or monetize your personal data.

For a complete overview, please read our full Privacy Policy.

Thanks goes to these wonderful people (emoji key):

Oleh 💻

VINAY CHAURASIYA 💻

Yvon 💻

NMPro 💻

Adalie Ahuja 💻

Gustavo Steinmetz 💻

Kirolos ☃️ 💻

cschot 💻

This project follows the all-contributors specification. Contributions of any kind welcome!