Henkan - About The reliable VSRG converter

Henkan 変換

A converter for osu!mania and Etterna / StepMania charts.

After trying pretty much every converter I could find, I noticed they all had the same problems: timing drifting, broken holds, missing BPM changes, or weird edge cases that made the output unusable.

So I made my own.

Henkan focuses on doing one thing properly: converting charts without changing how the original map plays.

What it does

  • Convert osu!mania (.osu / .osz) ↔ Etterna / StepMania (.sm)
  • Preserve BPM changes
  • Convert hold notes correctly
  • Keep metadata (title, artist, creator, difficulty, preview point)
  • Preserve background references
  • Fetch osu! avatars for cdtitle images in .sm files

A note about SV

SVs are not converted when exporting from osu!mania to .sm.

This isn’t a limitation of Henkan—StepMania’s .sm format simply doesn’t have an equivalent to osu!'s inherited timing points (green lines).

Screenshots

Main Interface

Pack Conversion

Etterna Conversion

osu! Conversion

Preview

Downloads

Source Code

GitHub Repository: GitHub - kaanreal/henkan: The reliable VSRG converter you asked for. · GitHub

Feedback, bug reports, and weird edge-case maps are always welcome.

3 Likes

While I’ve yet to check the tool, I want to mention that while .sm is incapable of doing arbitrary scroll changes, .ssc can. If osu maps allow for arbitrary map speed based on a multiplier of the BPM at any specific time (e.g. 0.6, 2, 0.31415), these should have a direct coorelation via our .ssc format.

1 Like

actually peak, this is beyond helpful and insanely easy

1 Like

I haven’t tried the program, but if it’s as good as they say, it would be great if this conversion system were used in Arrow Vortex. In addition to FoxFire’s suggestion about the scroll changes in .ssc

Arrow Vortex repo GitHub - uvcat7/ArrowVortex: Stepmania .sm/.ssc file development tool · GitHub

open website, upload nbjs 5 future dominators to convert to osu, download the result and instantly try to reupload the .osu, error

1 Like

I just tested the exact same file. There isn’t actually an error. When you upload a .sm file from a folder to the web version, it only receives the .sm file, so it can’t find the audio or any of the other required files. If you got the red error, it’s probably because you uploaded the .osu directly from the ZIP archive.

In the desktop version, converting from the song folder works because it has access to all the files automatically. I could probably add support for uploading ZIP files in the future, which would solve this.

i will look into it , ty