{"id":20623411,"url":"https://github.com/opl-/beatsaber-http-status","last_synced_at":"2025-04-15T12:42:47.599Z","repository":{"id":43269666,"uuid":"145014337","full_name":"opl-/beatsaber-http-status","owner":"opl-","description":"Live game status over web sockets.","archived":false,"fork":false,"pushed_at":"2022-03-17T21:57:45.000Z","size":334,"stargazers_count":105,"open_issues_count":7,"forks_count":36,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-03-28T20:21:19.576Z","etag":null,"topics":["hacktoberfest"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opl-.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-16T16:35:26.000Z","updated_at":"2025-01-04T04:51:50.000Z","dependencies_parsed_at":"2022-07-09T07:30:51.030Z","dependency_job_id":null,"html_url":"https://github.com/opl-/beatsaber-http-status","commit_stats":null,"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opl-%2Fbeatsaber-http-status","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opl-%2Fbeatsaber-http-status/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opl-%2Fbeatsaber-http-status/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opl-%2Fbeatsaber-http-status/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opl-","download_url":"https://codeload.github.com/opl-/beatsaber-http-status/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249073487,"owners_count":21208370,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest"],"created_at":"2024-11-16T12:27:04.868Z","updated_at":"2025-04-15T12:42:47.580Z","avatar_url":"https://github.com/opl-.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Beat Saber HTTP Status\n\nThis plugin exposes information about the current game status, live over a WebSocket and over HTTP. It can be used to build [custom stream overlays](https://github.com/opl-/beatsaber-http-status/wiki/Software-using-this-plugin#overlays) or track player performance by third party programs.\n\n\n## Installation\n\n### Recommended (using a mod manager)\n\nYou can install Beat Saber HTTP Status by using [one of the mod installers listed here](https://bsmg.wiki/pc-modding.html). Follow the steps required to run the program of your choice, then in the mods section find \"HTTP Status\" and install it. This will automatically install and keep everything you need up to date.\n\nNext you will need to [get additional software](https://github.com/opl-/beatsaber-http-status/wiki/Software-using-this-plugin) that uses this plugin. **This plugin does nothing useful on its own; it simply exposes information for other programs to use.**\n\n### Manual\n\n1. Install [BSIPA](https://bsmg.github.io/BeatSaber-IPA-Reloaded/) [(BSMG guide)](https://bsmg.wiki/pc-modding.html#manual-installation).\n\n2. Download the latest release from the [releases page](https://github.com/opl-/beatsaber-http-status/releases).\n\n3. Extract the zip into your Beat Saber directory.\n\n4. Download and extract the following plugins and their dependencies:\n\n\t- BS Utils from [BeatMods](https://beatmods.com/#/mods)\n\n\t- websocket-sharp from [BeatMods](https://beatmods.com/#/mods)\n\n5. [Get additional software](https://github.com/opl-/beatsaber-http-status/wiki/Software-using-this-plugin) that makes use of this plugin. This mod does nothing on its own; it simply exposes information for other programs to use.\n\n\n## Developers\n\n### Using HTTP Status\n\nProtocol documentation can be found in [protocol.md](protocol.md).\n\n### Contributing to HTTP Status\n\nBefore opening a pull request, please read the [contributing guide](CONTRIBUTING.md).\n\nTo build this project you will need to create a `BeatSaberHTTPStatus/BeatSaberHTTPStatusPlugin.csproj.user` file specifying where the game is located on your disk:\n\n```xml\n\u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n\u003cProject xmlns=\"http://schemas.microsoft.com/developer/msbuild/2003\"\u003e\n  \u003cPropertyGroup\u003e\n    \u003c!-- Change this path if necessary. Make sure it ends with a backslash. --\u003e\n    \u003cGameDirPath\u003eC:\\Program Files\\Steam\\steamapps\\common\\Beat Saber\\\u003c/GameDirPath\u003e\n  \u003c/PropertyGroup\u003e\n\u003c/Project\u003e\n```\n\nAlternatively 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](BeatSaberHTTPStatus/BeatSaberHTTPStatusPlugin.csproj).\n\nThe following properties can be specified either in the `.csproj.user` file or through the command line (`/p:\u003cname\u003e=\u003cvalue\u003e`):\n\n- `GameDirPath`: Path ending with a backslash pointing to the Beat Saber directory. Used to locate required game DLLs.\n\n- `OutputZip` = `true`/`false`: Enable/disable generating the .zip file. Can be used to get a zip for the `Debug` configuration.\n\n- `CopyToPlugins` = `true`/`false`: Enable/disable copying of HTTP Status DLLs to the Beat Saber installation. Depends on `GameDirPath`.\n\n\n## Credits\n\n**xyonico** for the [Beat Saber Discord Presence](https://github.com/xyonico/BeatSaberDiscordPresence) plugin, on which this plugin was initially based.\n\n**sta** for the [websocket-sharp](https://github.com/sta/websocket-sharp) library.\n\n**Maxaxik** for testing and helping with research.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopl-%2Fbeatsaber-http-status","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopl-%2Fbeatsaber-http-status","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopl-%2Fbeatsaber-http-status/lists"}