Tidal Web Lyrics Overlay

WHAT IT DOES

Tidal Web Lyrics Overlay reads the current song title and artist from the Tidal web player and displays a floating lyrics overlay directly on top of the player interface. The overlay shows synchronized lyrics that highlight the current line during playback, making it easy to follow along. You can drag the overlay anywhere on the screen, resize it, and adjust the font size to your preference. A sync offset setting lets you fine-tune the timing of the lyrics display if they are slightly ahead or behind the music. The overlay caches lyrics per song, so once loaded, they appear instantly on subsequent plays. A close button hides the overlay, and a panel toggle lets you show or hide it at any time.

WHERE IT RUNS

This extension works on all Tidal web pages at tidal.com and its subdomains, specifically on the web player pages where music is playing. It runs on the main playback page, the now-playing view, and any page with an active audio player. The extension operates entirely within your browser and does not access Tidal's servers directly—it reads only what is visible on the page you are viewing. It works alongside the free BotGentz extension, which provides the necessary scripting environment.

HOW TO USE

Install the extension, then navigate to tidal.com and start playing any track. The extension automatically detects the current song and attempts to load lyrics. A floating overlay appears on the player, showing the lyrics with the current line highlighted as the song plays. Click the extension's icon in your browser toolbar to open the settings panel. Use the "Show Overlay" / "Hide Overlay" button to toggle visibility. Adjust the font size using the dropdown menu. If the lyrics timing feels off, enter an offset value in milliseconds and click "Apply Offset"—positive values delay the lyrics, negative values advance them. Drag the overlay by clicking and holding anywhere inside it. Resize it by dragging the bottom-right corner. The "Refresh Lyrics" button forces a reload of the lyrics for the current track.

UNIFIED LYRICS ACQUISITION WITH FALLBACK CHAIN

Unlike simple lyrics scrapers that rely on a single method, this extension uses a multi-stage acquisition engine. It first attempts to extract lyrics from the Tidal page itself by searching for common lyric containers and data-testid attributes. If that fails, it scans the page text for patterns that resemble lyrics—short lines with a typical structure. The detection algorithm uses a scoring system that considers line length, repetition patterns, and position relative to the player controls. Additionally, a simple timestamp parser supports the standard [MM:SS.cc] format for synchronized lyrics. The acquired lyrics are cached per track using a normalized cache key derived from the artist and song title, reducing load times on subsequent plays. This fallback chain approach ensures lyrics are displayed reliably across different Tidal page layouts and updates.

THE PANEL

The panel supports drag-to-move anywhere on the page. It remembers its position per site, so it stays where you placed it on tidal.com. Click the panel header to collapse it down to just the minimized bubble, or click the expand handle to show the full panel. The panel can be resized by dragging the bottom-right corner. Press the Escape key to close the expanded panel and return to the minimized state. All panel settings, including position, size, collapsed state, font size, and sync offset, are saved per site and persist across browsing sessions.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and active, as it provides the underlying DOM injection and script execution environment. Tidal's website changes periodically, and page structures, class names, and data attributes may be updated. When that happens, the extension may stop detecting songs or lyrics until an update is released. The extension stores lyrics cache, overlay position, size, font size, sync offset, and visibility settings locally in your browser's storage using GM_setValue. Lyrics are cached per song to improve performance. No data is ever sent to any server, and no personal information is collected. The extension does not read or store your Tidal login credentials, email, or any identifying information. It only reads the current song title and artist information and visible lyrics from the page. You can clear all stored settings and cache at any time by clearing your browser data for tidal.com.