Skip to main content

A theme is a complete UI overhaul. It changes everything from the title screen and song selection menu to the results screen, scoring displays, and even in‑game judgment graphics. Themes can also alter gameplay mechanics (like timing windows or judgment placement) through Lua scripting.

Themes are stored in the Themes/ folder of your StepMania 5.1 installation. Each theme has its own subfolder containing:

If you download a theme from DeviantArt or GitHub and StepMania crashes immediately upon loading it, here is why:

  • Missing Assets: Some themes are "add-ons" that rely on the Default theme's assets. If the theme author deleted the BGAnimations or Graphics folders to save space, it might break on specific screens.
  • Aspect Ratios: StepMania 5.1 had a harder time handling 4:3 themes on 16:9 monitors compared to modern builds. Check if the theme supports your resolution (Widescreen vs. Standard).

  • Want your PC to look exactly like the latest Dance Dance Revolution arcade cabinet? The DDR A20+ recreation for 5.1 is stunningly accurate.

    Unlike 5.0.x, where the results screen was rigid, 5.1 allows complete rebuilding of the grade screen. Themes can display:

    StepMania 5.1 themes range from minimalist to hyper-ornate. Popular design patterns include:

    | Style | Characteristics | Example Themes | |-------|----------------|----------------| | Arcade Faithful | Neon arrows, large combo meters, retro CRT filters | DDR A20, ITGmania Default | | Modern Minimalist | Flat design, pastel colors, subtle particle effects | Simply Love, Cycling ’74 | | Data-Heavy | Graphs, detailed stats, small note sizes for high-density charts | Etterna, Starlight | | Immersive/Story | Custom background animations, character dialogue, stage transitions | Project Outfox, Beats of Rage |

    CyberiaStyle was the king of 5.0. The 5.1 remaster fixes the broken multiplayer screen and adds hue-shifting backgrounds.

    Since official StepMania 5.1 development ended around 2018, themes are now hosted in community archives:

    Using BitmapFonts (generated from .ini + .png) or system fonts via Font, themes can achieve pixel-perfect typography. The RageTextureFont system also supports Unicode and dynamic resizing.