Beat Saber plugin for displaying floating lyrics while playing the game.
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
BeatSinger Updated for Beat Saber v0.12.2. Jan 12, 2019
Website Fixed response for get_tokens. Sep 2, 2018
.gitignore Created extremely basic website. Aug 26, 2018
BeatSinger.sln Initial release. May 25, 2018
Procfile Created extremely basic website. Aug 26, 2018 Updated README. Aug 25, 2018
Video.gif Optimized .gif preview. Jun 16, 2018
requirements.txt Fixed requirements.txt. Sep 2, 2018

Beat Singer


Displays song lyrics in-game.

Note: Some songs loaded using BeatSaver Downloader have invalid metadata, and thus won't be recognized.
If you want to use them anyway, you'll have to edit their metadata manually so that the song and artist names are valid.


After installing the custom song loader, drop BeatSinger.dll into the Beat Saber/Plugins directory.


  • When lyrics for a song can be found, the message "lyrics found" will be shown at the beginning of the level song.
  • Lyrics are automatically looked up using musixmatch; you do not need to add them yourself.
  • You can press the Right Thumbstick (or trackpad on the Vive) to toggle lyrics in-game. The key can be changed in Beat Saber\UserData\modprefs.ini, by setting ToggleKeyCode to a valid KeyCode value.

Custom lyrics

Even though lyrics can be looked up automatically, it can be interesting to have custom lyrics either for quality, or for offline access.

BeatSinger will thus load lyrics in the following order:

  1. File named lyrics.json in the directory of the song.
  2. File named in the directory of the song.
  3. Online resolution.

JSON files must have the following format:

  { "text": "Never gonna give you up", "time": 10.00, "end": 11.10 },
  { "text": "Never gonna let you down", "time": 11.24 },

SRT files must have the following format:

00:00:22,791 --> 00:00:26,229
Never gonna give you up.
Never gonna let you down.

00:00:30,023 --> 00:00:32,272
Never gonna run away...
And desert you.