rhythmgame-tools 2.0.0

Rhythm Game Toolset for VSRG - Modernized fork of reamberPy

Rhythm Game Tools (vsrg_tools)

A modernized fork of reamberPy

:blue_book: Original Wiki & Getting Started

pip install rhythmgame-tools

---

VSRG Toolbox for data extraction, manipulation & analysis.

What's New in 2.0

• ✅ Updated dependencies: numpy 2.x, pandas 3.x, Python 3.14 support
• ✅ Modern packaging: Migrated from Poetry to native pyproject.toml with uv support
• ✅ Bug fixes: Fixed compatibility issues with latest Python and libraries

Features

• Game Support: osu!mania, StepMania, BMS and partially O2Jam files.
• Algorithms: Map IO, Conversion, Map Image Generation, Pattern Extraction
• Data Architecture: Pandas DataFrame Integration

This is built on pandas DataFrame, thus, if you need more control, you can retrieve the underlying DataFrame via the .df property on many vsrg_tools classes.

Migration from reamber

Simply replace reamber with vsrg_tools in your imports:

# Old
from reamber.osu import OsuMap

# New
from vsrg_tools.osu import OsuMap

For Developers, By Developers

A growing amount of osu!mania players are interested in programming. The best way to learn is to relate it to something that you're familiar with.

That's why this library allows you to tamper with your favorite games, and learn on the way.

Credits

Original library by Evening (Eve-ning). This is a community-maintained fork to keep the project alive and up-to-date.