Synced lyrics in your Visual Studio Code sidebar powered by Windows System Media Transport Controls (SMTC) and LRCLIB.
Lyricode is a Visual Studio Code extension for Windows (10/11 x64) that detects the currently playing track in your system and renders synchronized lyrics directly in your sidebar.
Features
No Login or Account Required: No Spotify Developer App, Client ID, OAuth tokens, or premium accounts needed.
Audio Source Selection: Follows the active Windows media session automatically, or can be locked to a specific application.
Immersive Presentation: Dynamic album artwork background with heavy blur and dark overlay. The active lyrics line is highlighted while inactive lines gently fade.
Smooth Auto-Scroll: Keeps the active lyric line visible in the upper viewport. Manual scrolling pauses auto-scroll for 3 seconds before automatically resuming.
Playback Controls: Play/pause, next, and previous buttons to control your player directly from the sidebar, along with an interactive progress bar for seeking.
Offset Adjustment: Quick keyboard commands and menu actions to shift lyrics timing earlier or later (-500ms / +500ms).
Status Bar Integration: Displays the current track in the VS Code status bar.
Requirements
Windows 10 or Windows 11 (x64), macOS 12+ (Apple Silicon / Intel), or Linux (x64 / arm64)
On Linux: playerctl installed (e.g. sudo apt install playerctl or sudo pacman -S playerctl)
Visual Studio Code version 1.85.0 or higher
Audio Sources
Windows: Tested with Spotify (desktop). Other players and browsers that register with Windows media controls may work, but behavior varies.
macOS: Tested with Spotify (desktop) and Apple Music via AppleScript. On first use, macOS will show a standard one-time permission prompt to allow VS Code to control the media player.
Linux: Supports all MPRIS-enabled applications via D-Bus and playerctl (Spotify, Firefox, Chrome, VLC, Rhythmbox, and more).
Quick Start
Install the extension in Visual Studio Code.
Ensure a media player such as Spotify (desktop) is open and playing audio.
Click the Lyricode icon in the Activity Bar.
Synced lyrics will appear automatically as the song plays.
Commands
Command
Description
Lyricode: Select Audio Source
Open Quick Pick to choose an audio playback source
Lyricode: Shift Lyrics Earlier (-500ms)
Shift lyrics timing earlier by 500 ms
Lyricode: Shift Lyrics Later (+500ms)
Shift lyrics timing later by 500 ms
Lyricode: Refresh Media State
Re-sync media sessions and restart helper if needed
Lyricode: Open Settings
Open Lyricode configuration settings
Settings
Configure these settings in VS Code settings (settings.json):
lyricode.source (default: "auto"): Audio source mode. Set to "auto" to follow the current Windows active session, or specify an application identifier.
lyricode.source.fallback (default: "wait"): Fallback behavior when the selected audio source is inactive ("wait" or "auto").
lyricode.lyrics.enabled (default: true): Enable or disable online lyrics lookup via LRCLIB.
lyricode.lyrics.offsetMs (default: 0): Manual timing offset for synced lyrics in milliseconds.
lyricode.statusBar.enabled (default: true): Show currently playing track in the VS Code status bar.
Privacy
Lyricode respects your privacy:
The only outbound network requests are made to LRCLIB (https://lrclib.net) to fetch lyrics for the detected track.
The request payload includes only basic track metadata: track title, artist name, album name, and duration.
Online lyrics lookup can be completely disabled by setting lyricode.lyrics.enabled to false.
Lyricode contains zero telemetry and does not collect or transmit any analytics or personal data.
Lyrics Caching
Lyrics fetched during the current session are kept in an in-memory runtime cache to minimize redundant network requests. Lyricode does not store lyrics on local disk.
Known Limitations
On Windows, depends on Windows Runtime System Media Transport Controls (SMTC) APIs.
On macOS, currently supports Spotify and Apple Music via AppleScript automation.
Synced lyrics availability depends on LRCLIB database coverage.