explaingit

mallydev2/discordlyrics

Analysis updated 2026-05-18

71TypeScriptAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A Discord client plugin that turns your custom status into live, line-synced lyrics of the song you are playing on Spotify.

Mindmap

mindmap
  root((repo))
    What it does
      Read Spotify activity
      Look up lyrics on LRCLIB
      Update status line by line
    Tech stack
      TypeScript
      BetterDiscord
      Vencord
    Use cases
      Show synced lyrics as Discord status
      Auto install on Windows
      Fallback to track name when paused
    Audience
      Discord users
    Setup
      Run Windows installer
      Or manual package install

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Display the current lyric line of your playing Spotify track as your Discord status.

USE CASE 2

Automatically install the right plugin build for BetterDiscord, Vencord, or Equicord using the Windows installer.

USE CASE 3

Fall back to showing the last detected track name and artist when playback is paused.

What is it built with?

TypeScriptBetterDiscordVencord

How does it compare?

mallydev2/discordlyricszhaojingru-ai/multimodal-interview-systemmidudev/subvid.app
Stars717172
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencegeneralresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires a modified Discord client (BetterDiscord or Vencord) and violates Discord's terms of service as self-botting.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

DiscordLyrics is a plugin for modified Discord clients that shows the current lyrics of whatever you are playing on Spotify as your Discord custom status. As a song plays, the status updates line by line in sync with the lyrics. When Spotify is paused, it falls back to showing the last detected track name and artist. The plugin works by reading your Spotify activity from Discord (which Discord shows publicly as your activity status) and then looking up the matching lyrics from LRCLIB, a public lyrics database. When the active lyric line changes, it sends a status update to Discord. The plugin is designed to avoid hitting Discord's rate limits by updating only when the lyric actually changes rather than on a fixed timer. The project supports two flavors of modified Discord client: BetterDiscord and Vencord (including Equicord and Dorian-style source clients). A Windows installer script is available that detects which client you have installed and puts the plugin in the right place automatically. If you prefer to set things up manually, a complete package with both builds is also available from the releases page. The README is straightforward about one important point: using this plugin counts as self-botting, which violates Discord's terms of service. The author notes it should be used responsibly. To get lyrics working, Spotify needs to be connected to Discord and visible as your activity. The track title and artist name also need to match the LRCLIB database. The project is written in TypeScript and released under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through running the Windows installer script for this plugin.
Prompt 2
Explain how this plugin matches a Spotify track to lyrics on LRCLIB.
Prompt 3
How do I manually install the plugin on Vencord instead of using the auto installer?
Prompt 4
What should I check if lyrics are not showing up in my Discord status?

Frequently asked questions

What is discordlyrics?

A Discord client plugin that turns your custom status into live, line-synced lyrics of the song you are playing on Spotify.

What language is discordlyrics written in?

Mainly TypeScript. The stack also includes TypeScript, BetterDiscord, Vencord.

What license does discordlyrics use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is discordlyrics to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is discordlyrics for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.