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).
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:
To directly preview a BeatSaver ZIP file, use the
?zip parameter in the URL:
Note the ZIP must be served with CORS header. An easy way to do this is to
https://cors-anywhere.herokuapp.com/ to your ZIP URL:
To directly link to a seeked time, use the
?time parameter in the URL (seconds):
- Safari support (BeatSaver currently serves OGGs which are not supported)
- Custom saber viewer
The BeatSaver viewer is an unofficial community project and not officially affiliated with Beat Saber.
It is adopted officially by the community on the Discord though, used as the official tool for sharing maps online and featured on BeastSaber:
npm install npm run start
Then head to
localhost:9999 in your browser.