Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Extension that adds word-by-word/syllable lyrics feature to YouTube Music and Tidal (experimental), it's lightweight & good, this extension also fix apple music web lyrics

License

Notifications You must be signed in to change notification settings

ibratabian17/YouLyPlus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

YouLy+

Elevate Your YouTube Music, Tidal & Apple Music Experience with Dynamic, Karaoke-Style Lyrics.

License Latest Version GitHub Stars GitHub Forks

The Screenshot


🌟 Why YouLy+?

Streaming services offer great libraries, but their web interfaces so trash, with this extension, it replace streaming shitty lyrics player to Apple Music-like lyrics

  • YouTube Music: Transforms the default static or plain text lyrics into a rich, timed, karaoke-style experience.
  • Tidal Web (Experimental): While Tidal Web offers synced lyrics, they are limited to line-by-line synchronization. YouLy+ make them to word-by-word.
  • Apple Music Web (Experimental): The native web player attempts word-by-word sync, but the implementation is flawed:
    • Precision Issues: Native AM Web uses setTimeout and their musickit uses timeupdate which is inaccurate, causing lyrics became offsync and hard to read.
    • Performance Hog: Heavy JavaScript-based animations spike CPU usage, causing lag on single-threaded or older devices.
    • Broken Layout: Frequent visual bugs occur with pronunciation guides and word breaks on syllable-synced song lmao.
    • Inferior Animation: The web animations feels so broken, idk how to tell it, but it's a pain.

YouLy+ trying to replaces these broken implementations with a lightweight, precise (idts), and visually faithful rendering engine.

✨ Features

YouLy+ is come with a features that designed to fix and enhance your lyrics experience:

🎀 Core Lyrics Experience

  • Advanced Synchronized Lyrics: Enjoy real-time, accurately synced lyrics with line-by-line highlighting. (cuz it uses apple ttml)
  • Word-by-Word Highlighting:
    • YouTube Music: Adds syncing where none exists.
    • Tidal: Upgrades line-sync to word-sync.
    • Apple Music: Replaces the buggy native engine with a high-performance alternative.
  • Apple Music Engine Overhaul: Replaces the resource-heavy native UI. YouLy+ solves the setTimeout drift issues and layout bugs while significantly lowering CPU usage. It also expands the lyric sourcesβ€”if AM lacks synced lyrics, YouLy+ finds them elsewhere!
  • Official Subtitle Fallback: Automatically uses official subtitles if synced lyrics aren't available.
  • Multiple Providers: Choose where your lyrics come from! Works seamlessly across all three platforms.
  • Native Integration: Replaces default lyrics panels with custom, interactive elements. Click-to-seek, scroll to find lines, and more!

🌐 Translation & Romanization

  • Instant Translation: Translate lyrics on the fly using Google Translate or the powerful Gemini AI (API Key required).
  • Romanization: See lyrics written in the familiar English alphabet, even for languages that use different writing systems (like Japanese, Korean, or Russian).
  • Full Gemini AI Control: For advanced users, connect your own Gemini AI account to customize translation instructions and AI settings.

🎨 Appearance & Customization

  • Dynamic Theming: Lyrics and backgrounds automatically adapt to the song's color palette.
  • Visual Effects: Enable an Apple Music-style blur for inactive lines to improve focus.
  • Custom CSS: Full control for web designers to inject custom CSS and style the lyrics exactly how they want.

βš™οΈ Performance & Integration

  • Optimized Renderer: Unlike the native Apple Music Web player, YouLy+ is designed to run smoothly on older hardware (e.g., dual-core CPUs) without freezing the browser.
  • Performance Modes: Utilize Lightweight Mode or Compatibility Mode to ensure 60 FPS animations on any machine.
  • SponsorBlock Integration: Automatically skip non-music segments like intros, outros, and sponsor messages (YouTube Music).
  • Smart Caching: YouLy+ remembers lyrics it has found, reducing data usage and loading times.

⚑ Performance Reference

The benchmark machine used to develop this project is older hardware (AMD FX-6300 + GT 620 from ~2012). YouLy+ is optimized to run where native web players fail.

GPU Performance (Targeting 60 FPS):

  • 768p (1366x768): Stable 60 FPS on NVIDIA GT 620 (1GB) or equivalent integrated graphics.
  • 1080p (1920x1080): GTX 650 / GT 1030 or above recommended for a locked 60 FPS.
    • Note: Legacy cards (GT 620) can still achieve 45-60 FPS at 1080p with minor jitter.

⬇️ Installation

⭐ Recommended: Install from Official Stores

For the safest and easiest experience, install YouLy+ directly from your browser's web store. This ensures you get automatic updates and a verified version of the extension.

Firefox Add-ons Microsoft Edge Extensions

For Chrome Users, Developers & Advanced Users: Install from Source

For Chrome (Manifest V3)

  1. Clone or Download the Repository:
    git clone [https://github.com/ibratabian17/YouLyPlus.git](https://github.com/ibratabian17/YouLyPlus.git)
  2. Alternatively, you can download the latest release from Github Releases and extract them.
  3. Open Chrome Extensions Page: Navigate to chrome://extensions/.
  4. Enable Developer Mode: Toggle the "Developer mode" switch in the top right corner.
  5. Load Unpacked Extension: Click on "Load unpacked" and select the cloned repository folder.

For Firefox

  1. Clone or Download the Repository:
    git clone [https://github.com/ibratabian17/YouLyPlus.git](https://github.com/ibratabian17/YouLyPlus.git)
  2. Alternatively, you can download the latest release from Github Releases.
  3. Open Firefox Debugging Page: Navigate to about:debugging#/runtime/this-firefox.
  4. Load Temporary Add-on: Click on "Load Temporary Add-on" and choose the manifest.json file from the repository folder.

πŸš€ Usage

Once installed, simply open one of the supported players:

Play any song, and the lyrics panel will automatically be enhanced by YouLy+.

  • Quick Settings: Access quick toggles by clicking the YouLy+ icon in your browser's toolbar.
  • Full Settings: For comprehensive customization, click "More Settings" from the popup.

☁️ Self-Hosting & Open Source

YouLy+ is proudly open-source, offering full transparency and control to its users.

  • Client (The Extension): The code for the YouLy+ extension itself is completely open for anyone to look at and change.
  • Server (Lyrics+ Provider): The main source for lyrics (Lyrics+) is also open for anyone to see its code. You can even set up your own version of it if you want! Find the server code here:

πŸ§‘β€πŸ’» Development

If you're interested in contributing to or modifying YouLy+:

  1. Clone the Repository:
    git clone [https://github.com/ibratabian17/YouLyPlus.git](https://github.com/ibratabian17/YouLyPlus.git)
  2. Load the Extension: Use your browser’s "Load unpacked" feature (as described in the Installation section) to test your changes in real-time.

πŸ“¦ Packaging

To create distributable .zip files for various browsers:

  1. Prerequisites: Ensure you have jq and a zip utility (zip or 7z) installed on your system.
  2. Run the Script:
    • On Linux/macOS: ./bundle.sh
    • On Windows (PowerShell): ./bundle.ps1

These scripts will generate optimized packages for different browsers within the dist/ folder.

🀝 Contributing

Contributions are highly welcome! Please feel free to fork this repository and submit a pull request. For significant changes or new features, it's recommended to open an issue first to discuss your ideas.

This project is a dedicated effort covering both the client extension and the server backend. If YouLy+ enhances your music experience, please consider supporting its continued development:

About

Extension that adds word-by-word/syllable lyrics feature to YouTube Music and Tidal (experimental), it's lightweight & good, this extension also fix apple music web lyrics

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Contributors 3

  •  
  •  
  •