benrucker / PySaberDecoder

A Score Saber replay decoder written in Python

PySaberDecoder

A Score Saber replay decoder written in Python.

⚠ very WIP! ⚠

Planned features

• Full decode support for Score Saber replay files
• CSV & JSON support
• Super easy usage & configuration A ScoreSaber replay decoder written in Python.

Usage

1. Download this project
   • You can do this by clicking the green "Code" button in the top right and clicking "Download ZIP"
   • Or (recommended) use git

git clone https://github.com/benrucker/PySaberDecoder.git

2. cd into the project directory

cd PySaberDecoder

3. Run the program

python main.py -i path/to/your/input.dat -i path/to/the/output.csv

GUI Usage

1.cd into the project directory

cd PySaberDecoder

2a. If you would like to use the GUI for a sinlge file use the

python GUI_SCORESABER_File.py

Once ran, you will have the option to select the .dat replay file and the output folder. Hit start once you have selected both.

2b.If you would like to use the GUI for a batch of files use

python GUI_SCORESABER_Folder.py

Before running the program, put all .dat files into a folder on your computer. Now you can run the program to select the folder you created then press start. All files will be processed accordingly

Maintaining this project

This project was written initially to support ScoreSaber replay files V2 and then updated to work exclusively with V3.

Whenever ScoreSaber updates how replay files are saved, you'll need to add or remove any fields that were changed in this file (if the link is broken, look for ReplayFile.cs in the scoresaber-plugin repo).

Feel free to make the change yourself and then open a pull request to add it to the project! I'd appreciate it 😉