Join TestFlight to get the latest beta version of AsoBMaShow for iOS.
AsoBMaShow [asobimashou: Let's play] is a crossplatform BMS player which depends on open source libraries only
You can download AsoBMaShow from Releases
git clone https://github.com/SNURhythm/AsoBMaShow.git
cd AsoBMaShow
git submodule update --init --recursive
./scripts/ios_init.sh # initialize bgfx xcodeproj & cocoapods for iOS
./scripts/macos_init.shgit clone https://github.com/SNURhythm/AsoBMaShow.git
cd AsoBMaShow
git submodule update --init --recursive
./scripts/windows_init.ps1 -BuildType release
cmake --build --preset release-windows --target main --parallel 6The release-windows build preset selects Release in
cmake-build-release-visual-studio; debug-windows selects Debug in
cmake-build-debug-visual-studio. Use -BuildType debug to configure the latter.
Plain cmake --build <directory> does not use these presets and still requires
--config Release for an MSVC release build, regardless of the directory name.
Generated user presets also provide user-release-windows and
user-debug-windows build presets with the same configuration defaults.
For a custom release directory, add a configure preset inheriting
release-windows with its own binaryDir, then a build preset inheriting
release-windows whose configurePreset points to that custom preset.
- BGA playback
- Gameplay
- Course mode
- Integrate Bokutachi IR
- Chart viewer
- Support PMS
- Portrait mode (mobile)
- Support skin (Lua gameplay skins are enabled on desktop builds)
- Use responsive layouts for menus and dialogs based on available window space and density-independent sizing. Keep text and touch targets readable, adapt columns to screen size and orientation, and preserve the fixed gameplay canvas.
See the repository guide for the current codebase map and feature documentation for subsystem intent, ownership, and focused test locations.
- SDL3 + bgfx
- FFmpeg (for BGA rendering)
- SQLite3
- PortAudio (for desktop) + miniaudio (for mobile)
- libsndfile
- 7-Zip SDK (archive reading; see third-party notices)
- bms-parser-cpp for fast BMS parsing
Copyright (C) 2024-2026 VioletXF. AsoBMaShow is licensed under the GNU General Public License version 3. See COPYRIGHT for the application notice and third-party notices for bundled components.