Skip to content
Live game status over web sockets.
Branch: master
Clone or download
opl- Release v1.5.0
-  (#21, by @monkeymanboy)

- The year in the copyright notice xD
Latest commit 54f1459 Apr 21, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
BeatSaberHTTPStatus Release v1.5.0 Apr 21, 2019
libs Initial commit Aug 19, 2018
.gitignore Use .csproj.user, Improve README. Closes #9 Mar 9, 2019
.gitmodules Initial commit Aug 19, 2018
BeatSaberHTTPStatusPlugin.sln Initial commit Aug 19, 2018
LICENSE Initial commit Aug 19, 2018 Fix game.mode. Fixes #12 (#18) Mar 9, 2019 Expose timeToNextBasicNote in noteCut event (#21) Apr 21, 2019

Beat Saber HTTP Status

This plugin exposes information about the current game status, live over a WebSocket and over HTTP. It can be used to build custom stream overlays or track player performance by third party programs.


Recommended (ModSaber Installer)

To install Beat Saber HTTP Status use ModSaber Installer where it's listed as "HTTP Status". This will automatically install all required plugins and keep all of them up to date.

Next you will need to get additional software that uses this plugin. This plugin does nothing useful on its own; it simply exposes information for other programs to use.


  1. Download the latest release from the releases page.

  2. Extract the zip into your Beat Saber directory.

  3. Download and extract the following plugins and their dependencies:

  4. Get additional software that makes use of this plugin. This mod does nothing on its own; it simply exposes information for other programs to use.


Using HTTP Status

Protocol documentation can be found in

Contributing to HTTP Status

This project uses the websocket-sharp library included as a git submodule. To download it, use git submodule update --init or clone the repository with the --recursive flag.

To build this project you will need to create a BeatSaberHTTPStatus/BeatSaberHTTPStatusPlugin.csproj.user file specifying where the game is located on your disk:

<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="">
    <!-- Change this path if necessary. Make sure it ends with a backslash. -->
    <GameDirPath>C:\Program Files\Steam\steamapps\common\Beat Saber\</GameDirPath>

Alternatively you can provide the game DLLs in the libs/beatsaber directory using the standard Beat Saber directory structure. For a full list see the project file.


xyonico for the Beat Saber Discord Presence plugin, on which this plugin was initially based.

sta for the websocket-sharp library.

Maxaxik for testing and helping with research.

You can’t perform that action at this time.