⚔️ Web-based viewer for BeatSaver maps, built with A-Frame and JavaScript.
Branch: master
Clone or download
Latest commit 30fe834 Feb 17, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets volume controls Feb 16, 2019
src fix diff select Feb 18, 2019
vendor initial commit, stage and foundation for viewing beats / playing audio Dec 15, 2018
.babelrc search Feb 13, 2019
.gitignore remove generated index.html Dec 20, 2018
LICENSE initial commit, stage and foundation for viewing beats / playing audio Dec 15, 2018
README.md update readme Feb 14, 2019
package-lock.json search Feb 13, 2019
package.json restore port Feb 14, 2019
webpack.config.js stylus Dec 19, 2018

README.md

beatsaver-viewer

Web-based viewer for BeatSaver maps, built with A-Frame and JavaScript.

CLICK TO VIEW

https://supermedium.com/beatsaver-viewer/?id=811-535&difficulty=Expert

The viewer works within a normal web browser and can be embedded on any webpage. It can also be previewed within VR headsets on browsers that support VR (e.g., Supermedium).

Featured on BeastSaber and the unofficial Beat Saber Songs site!

Usage

You can visit or link the viewer directly.

Or if you have a site, you can I-Frame the viewer and pass a query parameter containing the song ID and difficulty:

<iframe src="https://supermedium.com/beatsaver-viewer/?id=811-535&difficulty=Expert">

To directly preview a BeatSaver ZIP file, use the ?zip parameter in the URL:

https://supermedium.com/beatsaver-viewer/?zip={zipURL}

Note the ZIP must be served with CORS header. An easy way to do this is to prepend https://cors-anywhere.herokuapp.com/ to your ZIP URL:

https://supermedium.com/beatsaver-viewer/?zip=https://cors-anywhere.herokuapp.com/{YOUR_FULL_ZIP_URL}

To directly link to a seeked time, use the ?time parameter in the URL (seconds):

https://supermedium.com/beatsaver-viewer/?time=15

Roadmap

  • Safari support (BeatSaver currently serves OGGs which is not supported)
  • Custom saber viewer

Community

The BeatSaver viewer is an unofficial community project and not officially affiliated with Beat Saber.

Development

Built with A-Frame, a web framework that we created for building VR experiences. And JavaScript.

npm install
npm run start

Then head to localhost:9999 in your browser.