src | ||
.gitignore | ||
batch_convert.sh | ||
Cargo.lock | ||
Cargo.toml | ||
LICENSE | ||
README.md |
BRD
BRD is a tool for working with Dance Dance Revolution step charts and wave banks. It currently supports conversion to osu!mania beatmaps and extraction of sounds from wave banks.
Installation
Currently this is not published as a crate so you either have to clone the
repository manually and run cargo build --release
or you can use cargo install --git https://github.com/sbruder/brd
to install the binary without
cloning.
Modes
ddr2osu
This converts DDR step charts (.ssq files) and the corresponding audio (from .xwb files) to osu beatmaps (in an .osz container).
Basic usage:
brd ddr2osu -s file.ssq -x file.xwb -o file.osz --title "Song Title" --artist "Song Artist"
To learn more about supported options run brd ddr2osu --help
Batch conversion is possible with the included shell script batch_convert.sh
(usage guide at the top of the script).
Known Problems
- Since osu!mania does not support shock arrows, it either ignores them or
(by default) replaces them with a two-key combination (↑↓ or ←→); you can
change this with the (
--shock-action
option) - Freezes do not work (I do not know how to get the start time yet) and
therefore are disabled in code (
ddr::ssq::FREEZE
)
unxwb
This can list and extract sounds from XWB wave banks. It currently only supports ADPCM sounds. Basic Usage:
brd unxwb file.xwb
brd unxwb -l file.xwb
Known Problems
If you want to extract sounds that are stored in other formats, you can use Luigi Auriemma’s unxwb (Ctrl+F unxwb).
About this project
This is my first rust project. Don’t expect too much from the code in terms of quality, robustness or idiomacity (especially regarding error handling). There currently are no tests.
Large portions of this tool would not have been possible without the following resources:
- SaxxonPike’s scharfrichter which implements SSQ and XWB (1, 2) and their documentation about SSQ
- The official osu! file format documentation
- MonoGame’s XWB implementation
- Luigi Auriemma’s unxwb (especially the ADPCM header part)
License
This project is not affiliated with ppy or Konami.