FAQ

Questions, answered.

If something isn't covered here, ask on Discord or open an issue on GitHub.

The basics

What is StepForge?
A free desktop app that turns a song into playable dance charts for StepMania and ITGmania: Beginner, Easy, Medium, Hard and Challenge, for the 4-panel (dance-single) layout. You give it an audio file, it writes the charts, you preview them in the app, and one click installs the song into your game.
Is it free?
Yes. The app is free to download and use, and its source code is open (MIT license). The model's weights are under CC BY-NC-SA 4.0, which means non-commercial use. Charts you make with StepForge are yours.
What do I need?
A computer running macOS 12.3 or later (Apple silicon or Intel), Windows 10 or 11 (64-bit) or Linux (64-bit), a song file (WAV, MP3, FLAC or OGG; other formats if ffmpeg is installed), and ITGmania or StepMania 5 to play the charts. No graphics card needed. Everything else ships inside the download.
Does it need the internet, an account or an API key?
No. The charting model runs on your own computer, on the CPU. There's no account, no sign-in, no API key, and your songs are never uploaded anywhere.
How long does it take?
Seconds. On a recent laptop, all five difficulties for a typical song take a few seconds. Longer songs and Challenge charts take a little longer.
Why does it say “beta”?
Because it's new and still changing. It works, and people are playing its charts, but expect rough edges, and expect things to change between versions. Bugs and ideas are very welcome on Discord or in GitHub Issues.

The charts

Are the charts any good?
Honest answer: good, not perfect. On 180 songs it never saw, StepForge places its steps about as well as the best open-source auto-charter we tested, and its charts are noticeably cleaner to play. Almost no awkward double-steps, and every step is physically playable. Beginner is its weakest difficulty; Easy is next. It doesn't replace a skilled step artist. It gives you a solid chart in seconds that you can play, tweak or build on. The full numbers are on How it works.
Can I change how the charts feel?
Yes. Pick a style preset, or set sliders for density, streams, jumps, freezes, crossovers, jacks, footswitches and mines, or leave them for the model to decide. You can re-roll any section you don't like and preview everything in the built-in player before installing.
Doubles? Gimmicks? Songs that change tempo?
Not yet. StepForge writes 4-panel (dance-single) charts in 4/4 time, at one constant tempo per song. Songs with big tempo changes won't sync well today.
Can I share or upload charts I make?
The charts are yours. Every chart StepForge writes is credited “StepForge (AI-generated)”. If you share them, please keep that credit or say they were made with StepForge. The song itself still belongs to whoever owns it, so make sure you're allowed to share the audio.
Can I use StepForge commercially?
The app's code is MIT, but the model weights are non-commercial (CC BY-NC-SA 4.0), because some of the songs they learned from carry non-commercial terms. So you can't build a paid product or service on the model. Charts you make for yourself, your community or your events are yours.

Training data, opt-outs and opt-ins

What was the model trained on?
254 songs and their charts from community sources: the StepMix 1–5 contest packs, OutFox Serenity and the StepMania 5 default songs. Every song, its musicians and step artists, and its license is listed in CREDITS.csv. Licenses vary by song; they were checked for redistribution, and most don't say anything either way about machine learning. None of StepForge's own charts were used to train it.
Does it just copy the charts it learned from?
No, and we tested for it. On its own training songs it doesn't match the human charts any more closely than on songs it never trained on, and its longest exact copy of a training chart is 9 steps. On new songs, it reuses fewer training patterns than human step artists do. Details in the model card.
My song or chart is in the training data. Can I get it removed?
Yes. If you made a song or chart in the credits list and want it left out of future models, follow the opt-out steps: open an issue or reach out, and it will be removed.
I want my songs or charts to help train StepForge. How?
Thank you! For now, please get in touch directly through any of the contact options: Discord is quickest. A proper submission form is on the way.

Downloads and setup

Which Mac download do I need?
Open the Apple menu → About This Mac. If it says Chip: Apple M…, get the Apple silicon download. If it says Processor: Intel…, get the Intel one. Both need macOS 12.3 or later.
Is the download safe?
The macOS app is signed and notarized by Apple. The Windows installer is signed with a Microsoft-issued certificate, and Windows shows the publisher as Forrester Terry. Every release lists SHA-256 checksums, and the whole app is open source. Linux builds are not signed.
How do the charts get into ITGmania?
StepForge finds your game's Songs folder (or you point it there in Settings), and “Install to game” copies the song and its charts into a pack. Restart or reload songs in ITGmania and it's there. You can also export a plain song folder.
How do I update?
Download the new version and install it over the old one. Your songs and charts are kept; StepForge updates its engine and model the next time it starts. New versions are announced on the News page and on Discord.
Where does StepForge keep my files?
In a workspace folder in your user account: ~/Library/Application Support/StepForge/workspace on macOS, %APPDATA%\StepForge\workspace on Windows and ~/.local/share/StepForge/workspace on Linux. Songs you install into your game are copied into the game's own Songs folder.
Can I run it from source?
Yes: you need Node 22, Rust and Python 3.10+. See Build from source in the README.

About the project

Who makes StepForge?
Forrester Terry (“SweetPapa”) at Sweet Papa Technologies. More of his work is at fofo.dev.
Is this affiliated with StepMania, ITGmania or a game company?
No. StepForge is an independent project. It writes charts in the open StepMania file formats and isn't affiliated with StepMania, ITGmania, OutFox or any game publisher.
What’s next?
Honestly, a lot is still being figured out. Better Beginner and Easy charts, a way for artists and step artists to opt their work in, and polish all over are all on the list. Official updates go on the News page; the day-to-day conversation is on Discord.
Does this website track me?
No cookies, no analytics. The download buttons ask GitHub's public API which version is newest, and the files themselves come from GitHub.
I found a bug. Where do I report it?
Open an issue on GitHub (there's a template), or post in Discord. Your OS, the StepForge version and the song's format help a lot.