[Release] Semi-Auto Stepper (Python) - Syncs perfectly via ArrowVortex

Hi everyone!

I've been working on a prototype tool to help create simfiles faster without sacrificing quality, and I decided to release it as Open Source on GitHub today.

THE PROBLEM:
We all know that fully automatic chart generators often fail at the most important thing: Sync and BPM. If the algorithm guesses the BPM wrong, the chart is unplayable.

MY SOLUTION:
I created a Semi-Auto Stepper. It uses a hybrid workflow:
[*] Manual Sync: The script launches ArrowVortex for you. You use it to find the exact BPM and align the Downbeat (which ArrowVortex does perfectly). You save the empty .sm file.
[*] Auto Generation: My Python script reads that perfectly synced file and generates the patterns for Easy, Medium, and Hard difficulties based on the music flow.

FEATURES:
[*] Works with StepMania 5 and Project OutFox.
[*] Generates Dance-Single (4-panel) charts.
[*] No off-sync mess: Since you define the timing manually, the arrows are always on beat.
[*] Open Source: You can modify the algorithm or contribute on GitHub.

It is still a prototype, so the patterns might not be perfect for competitive play, but it's great for quickly playing songs that don't have a simfile yet.

DOWNLOAD & SOURCE CODE:
GitHub Repository

HOW TO USE:
There is a full guide in the README, but basically: put your mp3 in the folder, run the script, sync in ArrowVortex, and let Python do the rest!

I'd love to hear your feedback or suggestions. Happy stepping!

Please release in GUI, idk from python

---

Don't worry, you don't need to know Python or write any code!
It works with simple double-clicks:
1. Run setup_venv.bat (only the first time, to install everything).
2. Run menu.bat to open the tool.
From there, it's just a numbered menu: type '1' and press Enter. Give it a try!

Im very new to making these, so im not entirely sure if something like this has existed in the past. Wow this tool is awesome. I made Zangief's theme from sf6 into a test song and it came out pretty good! So far this all seems much farther on the easier difficulty, but I think this is a plus! I have such a hard time finding stepfiles for songs I like that aren't intended for someone with thousands of hours of step game experience. And it makes for a great head start on making sim files, and adjusting afterwards. 10/10

Thanks, I'm glad you liked it.
Keep in mind that for each difficulty level you create, you can always increase or decrease the arrow density by 20% as many times as you like, until you reach the level you like. You can do this from the 3 menu button.

Awesome! This is the kind of thing that if it were built into the sim games would help maintain players.

I'm getting these errors when installing and when creating a SM file. Help!


============================================================
1. APRI IN ARROWVORTEX
============================================================

El sistema no puede encontrar la ruta especificada.

←[95m--- APRI CON ARROWVORTEX ---←[0m
←[94mSeleziona un brano da aprire o creare:←[0m
1. Dayz - My Ailas.mp3←[92m [Nuovo]←[0m
--------------------------------------------------
0. Annulla / Esci

←[94mInserisci il numero: ←[0m