vsbviewer

a chart viewer for the rhythm game vivid/stasis - view chart notes with varying scroll speeds, inspect chart mods, and solve bumper notes.

part of vsbtool - tools for viewing, inspecting, and converting vivid/stasis .vsb chart files

vsbviewer (and the underlying vsblib) is tested to ensure compatibility with all .vsb files included with vivid/stasis. if you find anything that doesn't work, file an issue on Codeberg!

FAQs

How to open a chart?

Click the big "open game folder and pick chart" button, then select the folder containing your vivid/stasis game install. This is the folder that has the data.win file and a Charts folder. You'll then see a list of all the charts; click one, then choose a difficulty.

Alternatively, you can choose "open .vsb file"; this allows you to manually select a .vsb file instead of loading the entire game install folder and parsing the song metadata. A .vsb file contains the chart for one difficulty of one song - they can be found in the Charts folder of the game install.

Some shatter/backstage charts aren't showing up!

vivid/stasis stores shatter and backstage chart metadata in the game code (instead of the song_information.bin file, which is used for the rest of the songs). This means that I have to manually extract it for every update; if I haven't gotten around to doing that yet, you might need to manually select the .vsb file instead of using the chart picker.

Who made this?

I'm some random college student who decided one day to reverse engineer the vivid/stasis binary formats - I'm not associated with Hajimeli in any way, and I'm similarly not associated with anyone who's made similar tools before (like BlockOG, who made another chart viewer that works a bit differently but is an awesome project and has been a major inspiration for this).

This viewer started out as a debugging tool for vsbtool/vsblib (to fix file parsing issues and to allow me to more easily analyze the vsb format), but has since grown to be a very useful app in its own right!

How does it work/how is this different?

vsbviewer does everything in your browser (instead of relying on prerendered image files like that other chart viewer). It uses `vsblib`, a parser library I wrote by reverse engineering the vivid/stasis binary formats (chart format/vsb and song metadata/vsd); through the power of transpilation, we can directly load the actual chart files and display them entirely client-side :)

This allows for implementing more rendering options (like displaying chart mods and fractional scroll speeds) and selecting charts from your local install (so you don't have to wait for the owner of the site to update a database when game updates release).

Bumper solver? I hardly know er!

The bumper solver is a novel algorithm that replaces bumper notes with chip notes in a manner that maximizes alternating patterns/trills and minimizes jack frequency. Its results are particularly useful if you're struggling to figure out how to play a bumper-heavy section of a chart.

There are some minor edge cases where the result it gives isn't quite optimal (mostly in the case of middle bumpers, which only seem to appear in calming patterns?) but in the vast majority of cases it works great and produces very playable charts!


vsbtool version 1.4.2 (......), compiled with ocaml 5.3.0

or drop a .vsb file here!