Apple Music Web Lyrics Overlay

WHAT IT DOES

Apple Music Web Lyrics Overlay extracts the lyrics of the currently playing song from the Apple Music web player and displays them in a dedicated, movable overlay panel. The tool automatically detects when a new song starts playing, retrieves the lyrics from the page's data structures, and presents them in a clean, readable format. The overlay includes auto-scrolling functionality that highlights and scrolls to each line in sequence, adjustable font sizes for comfortable reading, and background transparency controls to reduce visual distraction. The panel is completely independent of Apple Music's native interface, allowing you to position it anywhere on the screen while keeping the player controls fully accessible.

WHERE IT RUNS

This extension works exclusively on Apple Music web player pages at music.apple.com. It functions on album pages, artist pages, playlist views, and the now-playing view. The tool integrates with Apple Music's single-page application architecture, detecting song changes and lyrics updates without requiring page refreshes. It supports all Apple Music regions and languages, handling lyrics in any script or character set.

HOW TO USE

Install the extension and navigate to music.apple.com. Start playing any song with available lyrics. The overlay panel will appear with the lyrics displayed automatically. Use the "Font Size" controls to increase or decrease the text size for comfortable reading. Adjust the "Bg Opacity" slider to control the panel background transparency, making the lyrics easier to read against the page behind them. Toggle "Auto-Scroll" on or off — when enabled, the lyrics scroll line by line, with the current line highlighted in red. Use the "Pause Scrolling" button to freeze the auto-scroll position, and "Reset View" to jump back to the top of the lyrics. Click "Copy Lyrics" to copy the entire lyrics text to your clipboard for use in other applications.

TECHNICAL SECTION — MULTI-STRATEGY LYRICS EXTRACTION

Unlike simple text scrapers, this extension employs a layered approach to locate lyrics within Apple Music's complex React-based DOM. It first queries known lyrics container selectors such as [data-testid="lyrics"], .lyrics-container, and .song-lyrics. If these yield no results, it scans script tags containing JSON data structures, searching for "lyrics" properties in the page's client-side state. The engine handles both plain text lyrics and escaped JSON strings, properly unescaping newline characters and preserving line breaks. It then constructs a line array, filtering out empty lines, and renders each line as a separate DOM element for precise auto-scrolling control. The auto-scroll mechanism advances to the next line every 4 seconds, providing a karaoke-style experience without requiring audio time synchronization — perfect for reading along at a comfortable pace.

THE PANEL — DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The overlay panel is fully interactive and designed for seamless multitasking. Drag it anywhere on the screen using the handle at the top of the panel; the position is saved per site so it stays where you left it across sessions. The panel includes a snap-to-edge feature that gently anchors the overlay to the nearest screen edge when released. Click the collapse button to minimize the panel to a compact pill showing only the current song title; expand it again with a single click. Resize the panel vertically by dragging the bottom-right corner to view more or fewer lyrics lines. Press the Escape key at any time to instantly close the overlay; it reappears on the next page navigation or refresh.

PLEASE NOTE

This extension requires the free BotGentz companion extension to function, as it provides the underlying content script injection and cross-origin communication framework. No personal data, browsing history, Apple Music activity, or lyrics content is stored, transmitted, or shared. All data extraction occurs entirely locally in your browser; no information is sent to any external server. The extension does not access or store login credentials, financial data, or personally identifiable information. Apple Music may update its page structure and lyrics delivery mechanisms; the extension's detection patterns are designed to adapt to common variations, but major redesigns may temporarily affect functionality. Lyrics are the property of their respective copyright holders and are displayed solely for personal use while listening to the corresponding track.