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?
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.