/BeatSinger

Beat Saber plugin for displaying floating lyrics while playing the game.

Primary LanguageC#

Beat Singer

Video

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.

Installation

After installing any other mod for Beat Saber, drop BeatSinger.dll into the Beat Saber/Plugins directory.

Usage

  • 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 S key to toggle lyrics in-game.

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 lyrics.srt in the directory of the song.
  3. File named [song file name without .ogg].srt in the directory of the song.
  4. 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:

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

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

...