- Read other rhythm game's charts
- Play keysounds
- Support osu's storyboard
- Capable with osu's skin
- Can Read / Write / Edit osu! replay files [*.osr]
- Beatmania IIDX [*.1]
- Be-Music Script [*.bms]
- DJMAX RESPECT [*.bytes]
- DJMAX ONLINE [*.pt]
- Malody [*.mc]
- MUSYNX/MUSYNC [*.txt]
- osu!mania [*.osu] ([EXPERIMENTAL]support standard converted maps)
- O2Jam [*.ojn]
- EZ2DJ/EZ2ON
- Stepmania
- More...
Tutorial: How to add songs?
This project uses the following third-party libraries:
| Library | Version | License | Description |
|---|---|---|---|
| SDL3 | 3.2.30 | zlib | Window, graphics, input handling |
| SDL3_ttf | 3.2.0 | zlib | TrueType font rendering |
| BASS | 2.4 | Commercial/Free | Audio playback |
| BASS_FX | 2.4 | Commercial/Free | Audio effects (tempo change) |
| ICU | 78.2 | Unicode License | Unicode collation |
| FFmpeg | 8.0.1 | LGPL | Video decoding |
| Library | License | Description |
|---|---|---|
| LZMA SDK | Public Domain | LZMA compression |
| minilzo | GPL | LZO compression |
| Library | License | Description |
|---|---|---|
| stb_image | MIT/Public Domain | Image loading |
| stb_vorbis | MIT/Public Domain | Vorbis audio decoding |
- 新增支持读取osu!的谱面
- 新增支持使用osu!的皮肤
- 新增AutoPlay,IgnoreSV(原创),Hidden,FadeIn Mod
- 新增自定义判定区间功能
- 新增osu!的回放导入导出功能
- 修复部分特殊BGM的歌曲，歌曲和谱面播放速度不一致的问题。
- 修复当miss长条时，note不会变灰的问题
- 修复当miss note时，note不会变灰继续下落而是直接消失的问题
- 调整打击偏移条显示为osu!stable同款
- 调整打歌界面判定显示，combo显示更接近osu!stable的风格。
- 新增选歌界面
- 新增血量系统
- 新增Death(原创),Sudden Death Mod
- 新增支持读取谱面key音并播放
- 新增osu storyboard读取并基本显示
- 新增DJMAX RESPECT谱面，key音读取
- 新增O2Jam谱面，key音读取
- 重构皮肤读取系统，现在不会出现keyimage图片偏移的问题
- 修复FallBack皮肤显示异常的问题
- 修复轨道之间始终有无视skin.ini内设置的黑线的问题
- 修复miss越多游戏越卡的问题
- 修复key音同时播放过多爆音的问题
- 修复note，combo，打击动画效果播放，现在skin.ini可以像原版osu!那样控制部分动画速率了
- 修复设置中无法输入自定义下落速度的问题
- 修复设置中启用的Mod错误地对回放模式起作用的问题
- 新增设置界面上下滚动，为以后增加设置留足空间
- 新增背景暗化功能
- 新增信息缓存系统
- 新增回放与谱面自动匹配功能
- 新增osu!同款星数算法(现在实现了b20260101和b20220101的逻辑，以后还能拓展)
- 新增实时PP计算(算法来自rosu-pp)
- 为了防止回放作弊，现在强制AutoPlay模式导出的Replay玩家名为"Mr.AutoPlay"
- 修复由于延迟导致暂停前后时间不一致的问题
- 修复空按时不会出现key音的问题
- 新增Storyboard T(rigger)命令支持，同时也引入了新bug，(不)一定会修复
- 新增DJMAX ONLINE谱面，key音读取(由于版权原因，我不会告诉你如何下载谱面文件)
- 新增Be-Music Script (BMS)谱面，key音读取
- 新增视频BGA支持
- 新增性能Debug输出
- 修复了导出回放到osu!时，一些mod启用状态信息没有被包含进回放文件的问题
- 修复了启用Double Time时key音会被错误升调
- 新增 Replay Factory 功能
- 新增 Replay Mod 信息修改
- 新增 Replay 元信息修改
- 新增 Replay Analyze 功能 (实现了 Press Distribution 和 Realtime Press 图表显示，基于 Transcendence 的 VSRG_Total_Analyzer )
- 新增 Replay 可视化视频输出 (基于 kuit 的 Mania-Replay-Master )
- 修复了长条断掉时 tick 也仍然在计算的问题
- 修复了长条即使不按也会出现按住的特效的问题
- 修复了设置中 Username 无法输入的问题
- 修复了 Replay Factory 读取 KeyCount 异常的问题
- 修复了启用 Mirror Input 多次进行回放导出后回放出现异常的问题
- 修复了每次打开程序后第一次游戏开头会出现幽灵按键的问题
- 修复了准备时间时暂停游戏后判定出现异常的问题
- 新增 Malody 谱面读取
- 新增 O2Jam 判定模式 (overlap-based)
- 修复了osu!皮肤部分元件的错误拉伸，显示异常问题
- 修复了自定义判定窗口无法保存的问题
- 修复了自定义判定窗口无法禁用某一个判定等级的问题
- 修复了自定义判定窗口使用过于离谱的值的时候无法正确应用的问题
- 修复了长条断开时头尾落速不一致的问题
- 修复了当游玩 DJMAX RESPECT 谱面时，点击跳过键会导致背景音乐消失的问题
- 修复了歌曲选择界面谱面来源标签在一些特殊情况下会被窗口截断的问题
- 修复了一些谱面打开DT/NC/HT效果对背景音乐无效的问题
- 修复了 BMS 谱面元信息解析异常的问题
- 修复了 BMS 图片 BGA 播放异常的问题
- 新增加载界面，支持在加载过程中使用esc打断加载
- 新增 osu! 皮肤高分辨率图片资源(*@2x)读取
- 新增 MUSYNX 谱面，key音读取
- 修复特殊情况下KeyImage被按下无法自动恢复的问题
- 修复 DJMAX RESPECT, DJMAX ONLINE, O2Jam, MUSYNX, BMS key 音无法正常加载的问题
- 修复 osu! 皮肤高分辨率图片资源读取时比例出现异常的问题
- 修复 osu! 皮肤部分元件动画速率异常的问题
- 修复 Replay Factory 回放导出功能失效的问题
- 修复对无背景音乐的谱面进行 Replay 可视化视频输出时报错的问题
- 新增 Beatmania IIDX 谱面，key音读取 (由于版权原因，我不会告诉你如何下载谱面文件)
- 构建系统转向cmake，现在支持linux平台。
- 修改了 Fix Beatmap Hash 的逻辑。现在对于包含多难度的单文件，会弹出难度选择窗口。
- 修复选歌界面更换难度时背景图片和背景音乐不会跟着换的问题
- 修复部分谱面导出回放后再用游戏播放提示无法正确找到谱面的问题
- 修复部分谱面游玩时没有背景图片的问题
- 修复 Generate Video 无法读取除了 *.osu 以外的谱面的问题
- 修复打击偏移条上方三角形不会移动的问题
Create lib/x64/ directory and download the following libraries:
| Library | Download | Files Needed |
|---|---|---|
| SDL3 | GitHub Releases | SDL3.lib, SDL3.dll |
| SDL3_ttf | GitHub Releases | SDL3_ttf.lib, SDL3_ttf.dll |
| BASS | un4seen.com | bass.lib, bass.dll |
| BASS_FX | un4seen.com | bass_fx.lib, bass_fx.dll |
| ICU | GitHub Releases or build from source | icuuc.lib, icuin.lib, icuuc*.dll, icuin*.dll, icudt*.dll |
| FFmpeg | gyan.dev (shared build) | avcodec.lib, avformat.lib, avutil.lib, swscale.lib + DLLs |
Place .lib files in lib/x64/ and .dll files in the output directory (or system PATH).
# Using build.bat (Visual Studio 2022+)
build.bat
# Or using CMake
mkdir build && cd build
cmake .. -G "Visual Studio 17 2022" -A x64
cmake --build . --config ReleaseInstall dependencies first:
# Ubuntu/Debian
sudo apt install build-essential cmake pkg-config
sudo apt install libicu-dev libffmpeg-dev
# SDL3 and SDL3_ttf (build from source)
# See: https://github.com/libsdl-org/SDL
# See: https://github.com/libsdl-org/SDL_ttf
# BASS
# Place libbass.so and libbass_fx.so in /usr/local/lib or use LD_LIBRARY_PATHBuild:
mkdir build && cd build
cmake ..
make -j$(nproc)macOS support is experimental. You'll need to install dependencies via Homebrew or build from source.
This project is for educational and personal use only. The developers are not responsible for any misuse of this software. All game assets and charts belong to their respective owners.
This project is licensed under the GPL-3.0 License - see the LICENSE file for details.
Note: BASS/BASS_FX are commercial libraries and must be downloaded separately.