negamartin / osu-db

Reading and writing of osu! binary files: `osu!.db`, `collection.db`, `scores.db` and `.osr` replay files.

osu-db

osu-db is an osu! binary file format encoder/decoder, providing support for loading, modifying and saving the following osu! file formats:

• osu!.db: The main beatmap information cache osu! uses.
• collection.db: A list of collections and the beatmaps they contain.
• scores.db: Overview of all user scores.
• .osr files: Individual in-depth score data of a single replay.

To use, simply add this line to your Cargo.toml:

osu-db = "0.2"

After that you will want to use the different load/save functions on the Listing (cached beatmap database), ScoreList (summary of all player scores), CollectionList (in-game beatmap collections) or Replay (a single in-depth standalone replay file).

For example, to change all of your osu!mania grades to SS+:

use osu_db::listing::{Listing, Grade};

// Load the listing to memory
let mut listing = Listing::from_file("osu!.db").unwrap();

// Modify listing in-place
for beatmap in listing.beatmaps.iter_mut() {
    beatmap.mania_grade = Grade::SSPlus;
}

// Save back to disk
listing.save("osu!.db").unwrap();

More details in the crate documentation.

osu-db has been tested to work with osu!stable binaries of at least version 20201017.

osu-db's Issues

Hitcount documentation incorrect for mania

Specifically for count_100 -> these are 100s in mania, not 200s.
The correct comment is already there for count_katsu which is the actual value for 200s in mania.

So in summary:

let count_max = f32::from(replay.count_geki);
let count_300 = f32::from(replay.count_300);
let count_200 = f32::from(replay.count_katsu);
let count_100 = f32::from(replay.count_100);
let count_50 = f32::from(replay.count_50);
let count_miss = f32::from(replay.count_miss);