https://github.com/mallydev2/discordlyrics
Spotify synced lyrics status plugin for BetterDiscord and Vencord.
https://github.com/mallydev2/discordlyrics
alpha betterdiscord development discord discordlyrics discordplugin fun interactive javascript lyrics meow music shell songs spotify spotify-connect status typescript vencord
Last synced: about 3 hours ago
JSON representation
Spotify synced lyrics status plugin for BetterDiscord and Vencord.
- Host: GitHub
- URL: https://github.com/mallydev2/discordlyrics
- Owner: MallyDev2
- License: gpl-3.0
- Created: 2026-05-27T04:10:47.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-05T06:55:30.000Z (about 1 month ago)
- Last Synced: 2026-06-05T08:14:17.744Z (about 1 month ago)
- Topics: alpha, betterdiscord, development, discord, discordlyrics, discordplugin, fun, interactive, javascript, lyrics, meow, music, shell, songs, spotify, spotify-connect, status, typescript, vencord
- Language: TypeScript
- Homepage: https://mallydev.xyz
- Size: 1.6 MB
- Stars: 165
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
DiscordLyrics
Just another Spotify lyric status changer
DiscordLyrics syncs Spotify lyrics from currently playing song to your custom status. By doing this it is a breach of discord tos for self botting so please use responsibly.
## Highlights
- Live lyric status from Spotify playback.
- LRCLIB synced lyric lookup.
- Rate-conscious status updates.
## Download
| Client | Release file | Setup |
| --- | --- | --- |
| Auto installer | [DiscordLyrics-Installer.cmd](https://github.com/MallyDev2/DiscordLyrics/releases/latest/download/DiscordLyrics-Installer.cmd) | Runs the Windows installer for BetterDiscord, Vencord, Equicord, or Dorian-style source clients. |
| Complete package | [DiscordLyrics-release.zip](https://github.com/MallyDev2/DiscordLyrics/releases/latest/download/DiscordLyrics-release.zip) | Includes both client builds, README, license, and changelog. |
## One-Click Windows Setup
Download `DiscordLyrics-Installer.cmd`, run it, and let it install the correct build.
The installer:
- Installs the BetterDiscord plugin when BetterDiscord is detected.
- Installs the source userplugin for Vencord, Equicord, and Dorian-style clients.
- Builds the source client with `pnpm build`.
- Runs `pnpm inject` when that client exposes an inject script.
## How It Works
DiscordLyrics reads your Spotify activity from Discord, matches the current track through LRCLIB, and updates your custom status when the active lyric line changes.
Fallback format:
```text
Song - Artist
```
## Troubleshooting
If lyrics do not appear right away, check these first:
- Spotify must be connected to Discord and visible as your activity.
- The track title and artist should match the public LRCLIB listing.
- Reload Discord after enabling or updating the plugin.
- Wait a few seconds after changing songs so the lyric lookup can refresh.
- For source clients, rebuild and inject after every plugin update.
## Repository Layout
```text
DiscordLyrics/
SpotifyLyricsStatus.plugin.js
vencord-userplugin/spotifyLyricsStatus/
scripts/build-release.js
dist/
assets/
```
## Support
If you enjoy discordlyrics, you can support me through GitHub Sponsors:
https://github.com/sponsors/MallyDev2
## License
Released under the [GPL-3.0 License](LICENSE).