Menu Files

Button

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
button-left.png All X X Multiplicative Top Right -
  • Use same height as other button pieces.

  • Tinting varies by button state.

Default skin: button-left.png
button-middle.png All X X Multiplicative Top -
  • This element is stretched to fit the needed width.

  • Use same height as other button pieces.

  • Tinting varies by button state.

Default skin: button-middle.png
button-right.png All X X Multiplicative Top Left -
  • Use same height as other button pieces.

  • Tinting varies by button state.

Default skin: button-right.png
menu-back.png All X normal Bottom Left 200x214
  • Animation name: menu-back-{n}.png.

  • The native back button is not skinnable.

    • If this element is skinned, it will override the new one everywhere, except for the options.
Default skin: menu-back.png

Mod Icons

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
selection-mod-autoplay.png All X normal Centre 64x64
Default skin: selection-mod-autoplay.png
selection-mod-cinema.png All X normal Centre 64x64
  • Click the Auto mod icon to see this icon.

Default skin: selection-mod-cinema.png
selection-mod-doubletime.png All X normal Centre 64x64
Default skin: selection-mod-doubletime.png
selection-mod-easy.png All X normal Centre 64x64
Default skin: selection-mod-easy.png
selection-mod-fadein.png All X normal Centre 64x64
Default skin: selection-mod-fadein.png
selection-mod-flashlight.png All X normal Centre 64x64
Default skin: selection-mod-flashlight.png
selection-mod-halftime.png All X normal Centre 64x64
Default skin: selection-mod-halftime.png
selection-mod-hardrock.png All X normal Centre 64x64
Default skin: selection-mod-hardrock.png
selection-mod-hidden.png All X normal Centre 64x64
  • For osu!mania, click the Fade In mod icon to see this icon.

Default skin: selection-mod-hidden.png
selection-mod-key1.png All X normal Centre 64x64
  • This element is osu!mania-specific.

  • Cycle through the xK mods to view.

Default skin: selection-mod-key1.png
selection-mod-key2.png All X normal Centre 64x64
  • This element is osu!mania-specific.

  • Cycle through the xK mods to view.

Default skin: selection-mod-key2.png
selection-mod-key3.png All X normal Centre 64x64
  • This element is osu!mania-specific.

  • Cycle through the xK mods to view.

Default skin: selection-mod-key3.png
selection-mod-key4.png All X normal Centre 64x64
Default skin: selection-mod-key4.png
selection-mod-key5.png All X normal Centre 64x64
  • This element is osu!mania-specific.

  • Cycle through the xK mods to view.

Default skin: selection-mod-key5.png
selection-mod-key6.png All X normal Centre 64x64
  • This element is osu!mania-specific.

  • Cycle through the xK mods to view.

Default skin: selection-mod-key6.png
selection-mod-key7.png All X normal Centre 64x64
  • This element is osu!mania-specific.

  • Cycle through the xK mods to view.

Default skin: selection-mod-key7.png
selection-mod-key8.png All X normal Centre 64x64
  • This element is osu!mania-specific.

  • Cycle through the xK mods to view.

Default skin: selection-mod-key8.png
selection-mod-key9.png All X normal Centre 64x64
  • This element is osu!mania-specific.

  • Cycle through the xK mods to view.

Default skin: selection-mod-key9.png
selection-mod-keycoop.png All X normal Centre 64x64
Default skin: selection-mod-keycoop.png
selection-mod-mirror.png All X normal Centre 64x64
Default skin: selection-mod-mirror.png
selection-mod-nightcore.png All X normal Centre 64x64
  • Click the Double Time mod icon to see this icon.

Default skin: selection-mod-nightcore.png
selection-mod-nofail.png All X normal Centre 64x64
Default skin: selection-mod-nofail.png
selection-mod-perfect.png All X normal Centre 64x64
  • Click the Sudden Death mod icon to see this icon.

Default skin: selection-mod-perfect.png
selection-mod-random.png All X normal Centre 64x64
Default skin: selection-mod-random.png
selection-mod-relax.png All X normal Centre 64x64
Default skin: selection-mod-relax.png
selection-mod-relax2.png All X normal Centre 64x64
  • This element is osu!-specific mod.

  • This mod will move the cursor for the player while the player just needs to tap or click.

Default skin: selection-mod-relax2.png
selection-mod-scorev2.png All X normal Centre 64x64
Default skin: selection-mod-scorev2.png
selection-mod-spunout.png All X normal Centre 64x64
  • This element is osu!-specific mod.

Default skin: selection-mod-spunout.png
selection-mod-suddendeath.png All X normal Centre 64x64
Default skin: selection-mod-suddendeath.png
selection-mod-target.png All X normal Centre 64x64
  • This mod is available in the cuttingedge stream only.

  • This element is an osu!-specific mod.

Default skin: selection-mod-target.png
selection-mod-freemodallowed.png All X normal Centre 64x64
  • This mod does not have an image in-game.

  • This mod does not show up in the mod selection or leaderboards.

  • Indicator for plays with certain mods and combinations.

    • Does not show up if only ‘Score V2’, ‘Auto’, ‘Double Time’, ‘Nightcore’, or ‘Half Time’ by itself is used, combinations with other mods including them will show the mod.
Default skin: selection-mod-freemodallowed.png
selection-mod-touchdevice.png All X normal Centre 64x64
  • This mod does not have an image in-game.

  • This mod does not show up in the mod selection.

  • Indicator for plays done using a touchscreen.

    • The client uses a background algorithm to calculate if a play is done with a touchscreen, if too many cursor warps occur it might be applied to a play.
Default skin: selection-mod-touchdevice.png

Cursor

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
cursor.png All X normal Centre -
  • By default, this element will rotate and expand (on click).

  • skin.ini commands:

Default skin: cursor.png
cursormiddle.png All X normal Centre -
  • This element does not rotate nor expand (on click).

  • This element is above the cursor.png element.

Default skin: cursormiddle.png
cursor-smoke.png All X normal Centre -
  • This element is used when the player presses the smoke key.

    • By default, the smoke key is bound to C.
Default skin: cursor-smoke.png
cursortrail.png All X normal Centre -
  • This element is underneath the cursor.png element

  • If cursormiddle.png is present, a longer trail is used.

  • By default, this element does not rotate.

  • skin.ini command:

Default skin: cursortrail.png
cursor-ripple.png All X unknown Additive Centre -
  • This element is used when the player presses the Left-Click key or Right-Click key on their keyboard or mouse.

    • By default, the Left-Click key is bound to Z.
    • By default, the Right-Click key is bound to X.
Default skin: cursor-ripple.png

Countdown

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
count1.png All X normal Centre -
  • This should either say “1” or “3”.

Default skin: count1.png
count2.png All X normal Centre -
  • This should say “2”.

Default skin: count2.png
count3.png All X normal Centre -
  • This should either say “3” or “1”.

Default skin: count3.png
go.png All X normal Centre -
  • This should say “Go!”.

Default skin: go.png
ready.png All X normal Centre -
  • This should say “Are You Ready?” or “Ready?”.

Default skin: ready.png

Game Mode Indicators

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
mode-osu.png All X X Additive Centre 256x256
  • This element flashes in the centre of the song select screen in respect of the song’s BPM.

  • Select osu! for this to be visible.

Default skin: mode-osu.png
mode-taiko.png All X X Additive Centre 256x256
  • This element flashes in the centre of the song select screen in respect of the song’s BPM.

  • Select osu!taiko for this to be visible.

Default skin: mode-taiko.png
mode-fruits.png All X X Additive Centre 256x256
  • This element flashes in the centre of the song select screen in respect of the song’s BPM.

  • Select osu!catch for this to be visible.

Default skin: mode-fruits.png
mode-mania.png All X X Additive Centre 256x256
  • This element flashes in the centre of the song select screen in respect of the song’s BPM.

  • Select osu!mania for this to be visible.

Default skin: mode-mania.png
mode-osu-med.png All X X normal Centre 128x128
  • This element is used inside the game mode selection dropdown menu.

  • Click on selection-mode.png to see.

Default skin: mode-osu-med.png
mode-taiko-med.png All X X normal Centre 128x128
  • This element is used inside the game mode selection dropdown menu.

  • Click on selection-mode.png to see.

Default skin: mode-taiko-med.png
mode-fruits-med.png All X X normal Centre 128x128
  • This element is used inside the game mode selection dropdown menu.

  • Click on selection-mode.png to see.

Default skin: mode-fruits-med.png
mode-mania-med.png All X X normal Centre 128x128
  • This element is used inside the game mode selection dropdown menu.

  • Click on selection-mode.png to see.

Default skin: mode-mania-med.png
mode-osu-small.png All X X Additive Centre 32x32
  • This element is on top of the selection-mode.png element.

  • Select osu! for this to be visible.

  • If the menu-snow.png element is not skinned, this element will be used if it is selected.

Default skin: mode-osu-small.png
mode-taiko-small.png All X X Additive Centre 32x32
  • This element is on top of the selection-mode.png element.

  • Select osu!taiko for this to be visible.

  • If the menu-snow.png element is not skinned, this element will be used if it is selected.

Default skin: mode-taiko-small.png
mode-fruits-small.png All X X Additive Centre 32x32
  • This element is on top of the selection-mode.png element.

  • Select osu!catch for this to be visible.

  • If the menu-snow.png element is not skinned, this element will be used if it is selected.

Default skin: mode-fruits-small.png
mode-mania-small.png All X X Additive Centre 32x32
  • This element is on top of the selection-mode.png element.

  • Select osu!mania for this to be visible.

  • If the menu-snow.png element is not skinned, this element will be used if it is selected.

Default skin: mode-mania-small.png

Grade Letters

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
ranking-XH.png All X X normal Centre -
  • Positioning varies:

    • 192px away from right screenborder
    • v1.0: at 272px height
    • v2.0+: at 320px height
Default skin: ranking-XH.png
ranking-XH-small.png All X normal (Varies) 34x40
  • Origin varies:

    • Break: Centre
    • Song Select panel: Left
    • User scores: Centre
Default skin: ranking-XH-small.png
ranking-X.png All X X normal Centre -
  • Positioning varies:

    • 192px away from right screenborder
    • v1.0: at 272px height
    • v2.0+: at 320px height
Default skin: ranking-X.png
ranking-X-small.png All X normal (Varies) 34x40
  • Origin varies:

    • Break: Centre
    • Song Select panel: Left
    • User scores: Centre
Default skin: ranking-X-small.png
ranking-SH.png All X X normal Centre -
  • Positioning varies:

    • 192px away from right screen border
    • v1.0: at 272px height
    • v2.0+: at 320px height
Default skin: ranking-SH.png
ranking-SH-small.png All X normal (Varies) 34x40
  • Origin varies:

    • Break: Centre
    • Song Select panel: Left
    • User scores: Centre
Default skin: ranking-SH-small.png
ranking-S.png All X X normal Centre -
  • Positioning varies:

    • 192px away from right screen border
    • v1.0: at 272px height
    • v2.0+: at 320px height
Default skin: ranking-S.png
ranking-S-small.png All X normal (Varies) 34x40
  • Origin varies:

    • Break: Centre
    • Song Select panel: Left
    • User scores: Centre
Default skin: ranking-S-small.png
ranking-A.png All X X normal Centre -
  • Positioning varies:

    • 192px away from right screen border
    • v1.0: at 272px height
    • v2.0+: at 320px height
Default skin: ranking-A.png
ranking-A-small.png All X normal (Varies) 34x40
  • Origin varies:

    • Break: Centre
    • Song Select panel: Left
    • User scores: Centre
Default skin: ranking-A-small.png
ranking-B.png All X X normal Centre -
  • Positioning varies:

    • 192px away from right screen border
    • v1.0: at 272px height
    • v2.0+: at 320px height
Default skin: ranking-B.png
ranking-B-small.png All X normal (Varies) 34x40
  • Origin varies:

    • Break: Centre
    • Song Select panel: Left
    • User scores: Centre
Default skin: ranking-B-small.png
ranking-C.png All X X normal Centre -
  • Positioning varies:

    • 192px away from right screen border
    • v1.0: at 272px height
    • v2.0+: at 320px height
Default skin: ranking-C.png
ranking-C-small.png All X normal (Varies) 34x40
  • Origin varies:

    • Break: Centre
    • Song Select panel: Left
    • User scores: Centre
Default skin: ranking-C-small.png
ranking-D.png All X X normal Centre -
  • Positioning varies:

    • 192px away from right screen border
    • v1.0: at 272px height
    • v2.0+: at 320px height
Default skin: ranking-D.png
ranking-D-small.png All X normal (Varies) 34x40
  • Origin varies:

    • Break: Centre
    • Song Select panel: Left
    • User scores: Centre
Default skin: ranking-D-small.png

Key Counter

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
inputoverlay-background.png All X normal Top Right 193x55
  • This element is positioned at 320px height.

  • Since the image is rotated, the origin on the image itself is Top Left.

  • This element is used in osu! and osu!catch.

  • This element is rotated 90 degrees clockwise and stretched by 1.05x in-game.

  • Must be enabled in the options to see.

Default skin: inputoverlay-background.png
inputoverlay-key.png All X Multiplicative Centre 43x46
  • This element is used in osu! and osu!catch.

  • Positioning varies for each key:

    • 24px away from screenborder
    • K1/L: at 350px height
    • K2/R: at 398px height
    • M1/D: at 446px height
    • M2: at 492px height
  • Toggleable in the options.

  • Shrinks briefly when the keys are pressed.

  • Tinting varies by button location and state:

    • White, if key is not pressed.
    • Yellow, if the key is pressed and located on the top half.
    • Purple, if the key is pressed and located on the bottom half.
Default skin: inputoverlay-key.png

Leaderboard

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
scoreentry-0.png All X Multiplicative (varies) 11x14
  • This element is used for the in-game leaderboards and input overlay.

    • For input overlay, the initial button labels are not skinnable.
  • Tinting depends on use:

  • Origin varies on use:

    • Score: Top Left
    • Combo: Top Right
    • Rank: Top Right
    • Input overlay: Top
Default skin: scoreentry-0.png
scoreentry-1.png All X Multiplicative (varies) 11x14
  • This element is used for the in-game leaderboards and input overlay.

    • For input overlay, the initial button labels are not skinnable.
  • Tinting depends on use:

  • Origin varies on use:

    • Score: Top Left
    • Combo: Top Right
    • Rank: Top Right
    • Input overlay: Top
Default skin: scoreentry-1.png
scoreentry-2.png All X Multiplicative (varies) 11x14
  • This element is used for the in-game leaderboards and input overlay.

    • For input overlay, the initial button labels are not skinnable.
  • Tinting depends on use:

  • Origin varies on use:

    • Score: Top Left
    • Combo: Top Right
    • Rank: Top Right
    • Input overlay: Top
Default skin: scoreentry-2.png
scoreentry-3.png All X Multiplicative (varies) 11x14
  • This element is used for the in-game leaderboards and input overlay.

    • For input overlay, the initial button labels are not skinnable.
  • Tinting depends on use:

  • Origin varies on use:

    • Score: Top Left
    • Combo: Top Right
    • Rank: Top Right
    • Input overlay: Top
Default skin: scoreentry-3.png
scoreentry-4.png All X Multiplicative (varies) 11x14
  • This element is used for the in-game leaderboards and input overlay.

    • For input overlay, the initial button labels are not skinnable.
  • Tinting depends on use:

  • Origin varies on use:

    • Score: Top Left
    • Combo: Top Right
    • Rank: Top Right
    • Input overlay: Top
Default skin: scoreentry-4.png
scoreentry-5.png All X Multiplicative (varies) 11x14
  • This element is used for the in-game leaderboards and input overlay.

    • For input overlay, the initial button labels are not skinnable.
  • Tinting depends on use:

  • Origin varies on use:

    • Score: Top Left
    • Combo: Top Right
    • Rank: Top Right
    • Input overlay: Top
Default skin: scoreentry-5.png
scoreentry-6.png All X Multiplicative (varies) 11x14
  • This element is used for the in-game leaderboards and input overlay.

    • For input overlay, the initial button labels are not skinnable.
  • Tinting depends on use:

  • Origin varies on use:

    • Score: Top Left
    • Combo: Top Right
    • Rank: Top Right
    • Input overlay: Top
Default skin: scoreentry-6.png
scoreentry-7.png All X Multiplicative (varies) 11x14
  • This element is used for the in-game leaderboards and input overlay.

    • For input overlay, the initial button labels are not skinnable.
  • Tinting depends on use:

  • Origin varies on use:

    • Score: Top Left
    • Combo: Top Right
    • Rank: Top Right
    • Input overlay: Top
Default skin: scoreentry-7.png
scoreentry-8.png All X Multiplicative (varies) 11x14
  • This element is used for the in-game leaderboards and input overlay.

    • For input overlay, the initial button labels are not skinnable.
  • Tinting depends on use:

  • Origin varies on use:

    • Score: Top Left
    • Combo: Top Right
    • Rank: Top Right
    • Input overlay: Top
Default skin: scoreentry-8.png
scoreentry-9.png All X Multiplicative (varies) 11x14
  • This element is used for the in-game leaderboards and input overlay.

    • For input overlay, the initial button labels are not skinnable.
  • Tinting depends on use:

  • Origin varies on use:

    • Score: Top Left
    • Combo: Top Right
    • Rank: Top Right
    • Input overlay: Top
Default skin: scoreentry-9.png
scoreentry-comma.png All X Multiplicative (varies) 5x14
  • This element is used for the in-game leaderboards.

  • This element is used as the decimal separator.

    • Usage depends on your selected language.
  • Tinting depends on use:

    • Score: white
    • Combo: cyan
  • Origin varies on use:

    • Score: Top Left
    • Combo: Top Right
Default skin: scoreentry-comma.png
scoreentry-dot.png All X Multiplicative Top Left 5x14
  • This element is used for the in-game leaderboards.

  • This element is used as the decimal separator.

    • Usage depends on your selected language.
  • Tinted white.

Default skin: scoreentry-dot.png
scoreentry-percent.png All X Multiplicative Top Left 12x14
  • This element is used for the in-game leaderboards.

  • This element is used in Multi games when the win condition is set to Accuracy.

  • Tinted white.

Default skin: scoreentry-percent.png
scoreentry-x.png All X Multiplicative Top Right 10x14
  • This element is used for the in-game leaderboards.

  • This element is used as the multiplier symbol.

  • Tinted cyan.

Default skin: scoreentry-x.png
Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
menu-background.jpg All X X normal Centre 1366x768 (see notes)
  • osu!supporter required.

  • This element is positioned in the centre and is set to cover (fill the entire width and height while keeping its aspect ratio, but crop anything that is outside the game window).

  • By default, osu! has a set of background images that it will cycle through.

    • If this element is skinned and the user has osu!supporter tag, this element will override this behaviour.
  • This element is used as the playfield if beatmap does not have a background.

  • The seasonal background option can affect the visibility of this element.

    • If it is set to Always the seasonal backgrounds will override this element.
    • If it is set to Sometimes the seasonal backgrounds will override this element while they are in active use.
  • .jpg extension only.

    • If the image type is .png change the extension to .jpg.
    • If the background is transparent, the background colour will be black.
  • The player can drag and drop an image to overwrite the skin’s skinned image. This will replace the image in the skin’s folder!

Default skin: menu-background.jpg
welcome_text.png All X X normal Centre -
  • osu!supporter required.

  • This element appears upon starting the client.

  • This element folds out and expands, then fades out.

Default skin: welcome_text.png
menu-snow.png All X X Additive Centre 32x32
  • If not skinned, the current game mode’s small icon will be used instead.

  • Must be enabled in the options to see.

    • This option may forcibly be enabled during the holidays (Christmas).
Default skin: menu-snow.png
options-offset-tick.png All X X Multiplicative Centre -
  • Used in the offset wizard.

  • Stretched to fit screen height.

  • Tinting varies by tick state.

Default skin: options-offset-tick.png

Pause Screen

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
pause-overlay.png All X normal Centre 1366x768
  • When the game is paused, the playfield will be dimmed and this file will overlay on top of it.

  • This element will not stretch to fit.

  • Full image height is 768px.

  • Smaller images are shown with transparent borders while larger images are partially shown.

  • This can also be a .jpg file (and can have the .jpg extension).

    • osu! prefers .png over .jpg.
Default skin: pause-overlay.png
fail-background.png All X normal Centre 1366x768
  • When the player has failed, the playfield will be dimmed and this file will overlay on top of it.

  • This element will stretch to fit.

  • This can also be a .jpg file (and can have the .jpg extension).

    • osu! prefers .png over .jpg.
Default skin: fail-background.png
pause-back.png All X normal Centre -
  • This element is positioned at 576px height.

  • This element is seen in the fail and pause screens.

Default skin: pause-back.png
pause-continue.png All X normal Centre -
  • This element is positioned at 224px height.

  • This element is seen in the pause screen.

Default skin: pause-continue.png
pause-replay.png All X X normal Right -
  • This element appears on the ranking screen (after finishing a map or viewing a score).

  • This element is positioned at 672px height or at 576px height, if pause-retry.png is not available.

Default skin: pause-replay.png
pause-retry.png All X normal (Varies) -
  • Positioning varies:

    • pause or fail screen:
      • Centre, positioned at 400px height
    • ranking screen:
      • Right, positioned at 576px height
  • This element appears on the ranking screen after finishing a map and on the pause and fail screens.

Default skin: pause-retry.png

Playfield

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
comboburst.png All X (see notes) normal Centre -
  • To have multiple combobursts, use: comboburst-{n}.png.

    • One of the images in the set will be appear when a combo milestone is met.
  • For v2.2-, this is osu! and osu!catch’s combobursts.

  • For v2.3+, this is osu!’s combobursts.

  • This can be disabled in the options.

  • This should face towards the right.

Default skin: comboburst.png
play-skip.png All Multiplicative Bottom Right -
  • Animation name: play-skip-{n}.png

Default skin: play-skip.png
star2.png All X Additive Centre 24x24
  • This element is used for song selection (the stars that fly from right to left), cursor, kiai time, combobursts.

Default skin: star2.png
menu-button-background.png All X Multiplicative Bottom Left min: 690x85
  • Skin versions 2.2+ can support thumbnails (must be enabled in the options) for song selection

    • Thumbnails get positioned 9px away from the left image border
    • Thumbnail size is 115x85
  • This element is used in various places:

    • scoreboards in song selection
    • button for the beatmap difficulty in song selection
    • scoreboards on the left while playing
    • button that shows the selected beatmap while waiting in a room in multiplayer
  • Tinting varies by button state.

Default skin: menu-button-background.png
play-unranked.png All X Multiplicative Centre -
  • This element is shown when using mods that disable score submission.

Default skin: play-unranked.png
play-warningarrow.png All X X (see notes) Multiplicative Centre -
  • Beatmap skinnable status is suspected to be a bug.

  • Tinting varies by version.

    • pause screen:
      • all versions: tinted blue
    • exiting breaks:
      • v1.0: tinted white
      • v2.0+: tinted red
Default skin: play-warningarrow.png
arrow-pause.png All X X (see notes) normal Centre -
  • Beatmap skinnable status is suspected to be a bug.

  • If skinned, this element overrides play-warningarrow.png.

  • This element is used in the pause and fail screens.

  • Not tinted.

Default skin: arrow-pause.png
arrow-warning.png All X X (see notes) normal Centre -
  • Beatmap skinnable status is suspected to be a bug.

  • If skinned, this element overrides play-warningarrow.png.

  • Used for the end break warning.

  • Not tinted.

Default skin: arrow-warning.png
section-fail.png All X normal Centre -
  • This element is seen when the player has a low amount of HP, about less than 50%, during a long enough break.

Default skin: section-fail.png
section-pass.png All X normal Centre -
  • This element is seen when the player has a high amount of HP, about more than 50%, during a long enough break.

Default skin: section-pass.png
multi-skipped.png All X normal Bottom Right 60x30
  • This element is used in multi games, seen next to the player’s score (on the sides) when the player votes to skip the intro of a beatmap.

Default skin: multi-skipped.png
masking-border.png All X X normal Right max height: 768px
  • Used when playing with 4:3 storyboards on widescreen.

  • While beatmapping, disable Widescreen support in song setup for this to appear.

  • This element is stretched to fit the needed area.

  • The right pillar is flipped horizontally.

Default skin: masking-border.png
hitcircleselect.png All X normal Centre 118x118 (circle) 128x128 (whole file)
  • This element is only used in the beatmap editor.

  • Should be a circle.

Default skin: hitcircleselect.png

Ranking Panel

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
ranking-accuracy.png All X (see notes) X normal Top Left -
  • Can be animated, but only the zeroth frame will be used.

    • Animation name: ranking-accuracy-{n}.png
  • Positioning varies:

    • v1.0: (291,500)
    • v2.0+: (291,480)
Default skin: ranking-accuracy.png
ranking-graph.png 1.0 X X normal Top Left Varies
  • Suggested SD size:

    • v1.0: min: 308x156
    • v2.0+: min: 308x148
  • Positioning varies:

    • v1.0: (256,576)
    • v2.0+: (256,608)
  • The box itself is 301x141.

  • The first 7 pixels at the top and at the left should be transparent.

    • In v1 it’s shifted down by 8px.
Default skin: ranking-graph.png
ranking-maxcombo.png All X (see notes) X normal Top Left -
  • Can be animated, but only the zeroth frame will be used.

    • Animation name: ranking-maxcombo-{n}.png
  • Positioning varies:

    • v1.0: (8,500)
    • v2.0+: (8,480)
Default skin: ranking-maxcombo.png
ranking-panel.png 1.0 X X normal Top Left
  • Suggested SD size:

    • v1.0: max height: 694px
    • v2.0+: max height: 666px
  • Positioning varies:

    • v1.0: (0,74)
    • v2.0+: (0,102)
Default skin: ranking-panel.png
ranking-perfect.png All X (see notes) X normal Centre -
  • Can be animated, but only the zeroth frame will be used.

    • Animation name: ranking-perfect-{n}.png
  • Positioning varies:

    • v1.0: (320,688)
    • v2.0+: (416,688)
Default skin: ranking-perfect.png
ranking-title.png All X X normal Top Right -
  • x-position 32px away from the right side

Default skin: ranking-title.png
ranking-replay.png 1.0 X X normal Right -
  • Position varies:

    • at 672px height.
    • at 576px height, if retry is not available.
Default skin: ranking-replay.png
ranking-retry.png All X X normal Right -
  • Positioned at 576px height.

  • If skinned, this element overrides pause-retry.png.

Default skin: ranking-retry.png
ranking-winner.png All X X normal Top Left 200x214
  • This element is used in multi only.

Default skin: ranking-winner.png

Scorebar

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
scorebar-bg.png All X normal Top Left -
  • This element has no size restrictions.

  • When used in osu!mania, this element is rotated 90 degrees anti-clockwise, scaled to 0.7x size, and placed at the bottom right of stage.

Default skin: scorebar-bg.png
scorebar-colour.png All (Varies) Top Left max height: 120px
  • Animation name: scorebar-colour-{n}.png.

  • Blend mode varies:

    • Multiplicative, if scorebar-marker.png is used.
      • Tinted black over time when near critical zone and tinted red in the critical zone.
  • Normal, otherwise.

  • Positioning varies:

    • If a marker is used, positioned at (12,12).
    • Otherwise, positioned at (5,16).
  • When used in osu!mania, this element is rotated 90 degrees anti-clockwise, scaled to 0.7x size, and placed at the bottom right of stage.

Default skin: scorebar-colour.png
scorebar-ki.png All X normal Centre -
  • scorebar-marker.png has higher priority.

  • This element represents the “passing” zone.

  • This element is not used in osu!mania.

  • Y-position at 16; x-position is placed at the end of the cropped scorebar-colour.png

  • A scorebar-colour.png is required for this element to appear.

Default skin: scorebar-ki.png
scorebar-kidanger.png All X normal Centre -
  • scorebar-marker.png has higher priority.

  • this element represents the “warning” zone

  • This element is not used in osu!mania

  • Y-position at 16; x-position is placed at the end of the cropped scorebar-colour.png

  • A scorebar-colour.png is required for this element to appear.

Default skin: scorebar-kidanger.png
scorebar-kidanger2.png All X normal Centre -
  • scorebar-marker.png has higher priority.

  • This element represents the “critical” zone.

  • This element is not used in osu!mania

  • Y-position at 16; x-position is placed at the end of the cropped scorebar-colour.png

  • A scorebar-colour.png is required for this element to appear.

Default skin: scorebar-kidanger2.png
scorebar-marker.png All X Additive Centre -
  • If skinned, this element overrides the scorebar-ki.png, scorebar-kidanger.png, and scorebar-kidanger2.png elements.

  • The marker fades out if the player reaches the critical zone.

  • This element is not used in osu!mania.

  • Y-position at 16; x-position is placed at the end of the cropped scorebar-colour.png.

Default skin: scorebar-marker.png

Score Numbers

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
score-0.png All X (Varies) (Varies) -
  • By default, this is also used for the combo numbers.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
      • Total Score: x1.3 in V2+
    • In-game
      • Score: x0.96
      • Accuracy: x0.57
      • osu!standard Combo: x1.3 (x1.8 fully expanded)
  • Blend mode varies:

    • If used for combo counter:
      • In osu! and osu!catch, additive for the expanding after images.
      • Additionally in osu!catch, the after images are tinted using the combo colour of the fruit.
      • In osu!mania, multiplicative.
Default skin: score-0.png
score-1.png All X (Varies) (Varies) -
  • By default, this is also used for the combo numbers.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
      • Total Score: x1.3 in V2+
    • In-game
      • Score: x0.96
      • Accuracy: x0.57
      • osu!standard Combo: x1.3 (x1.8 fully expanded)
  • Blend mode varies:

    • If used for combo counter:
      • In osu! and osu!catch, additive for the expanding after images.
      • Additionally in osu!catch, the after images are tinted using the combo colour of the fruit.
      • In osu!mania, multiplicative.
Default skin: score-1.png
score-2.png All X (Varies) (Varies) -
  • By default, this is also used for the combo numbers.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
      • Total Score: x1.3 in V2+
    • In-game
      • Score: x0.96
      • Accuracy: x0.57
      • osu!standard Combo: x1.3 (x1.8 fully expanded)
  • Blend mode varies:

    • If used for combo counter:
      • In osu! and osu!catch, additive for the expanding after images.
      • Additionally in osu!catch, the after images are tinted using the combo colour of the fruit.
      • In osu!mania, multiplicative.
Default skin: score-2.png
score-3.png All X (Varies) (Varies) -
  • By default, this is also used for the combo numbers.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
      • Total Score: x1.3 in V2+
    • In-game
      • Score: x0.96
      • Accuracy: x0.57
      • osu!standard Combo: x1.3 (x1.8 fully expanded)
  • Blend mode varies:

    • If used for combo counter:
      • In osu! and osu!catch, additive for the expanding after images.
      • Additionally in osu!catch, the after images are tinted using the combo colour of the fruit.
      • In osu!mania, multiplicative.
Default skin: score-3.png
score-4.png All X (Varies) (Varies) -
  • By default, this is also used for the combo numbers.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
      • Total Score: x1.3 in V2+
    • In-game
      • Score: x0.96
      • Accuracy: x0.57
      • osu!standard Combo: x1.3 (x1.8 fully expanded)
  • Blend mode varies:

    • If used for combo counter:
      • In osu! and osu!catch, additive for the expanding after images.
      • Additionally in osu!catch, the after images are tinted using the combo colour of the fruit.
      • In osu!mania, multiplicative.
Default skin: score-4.png
score-5.png All X (Varies) (Varies) -
  • By default, this is also used for the combo numbers.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
      • Total Score: x1.3 in V2+
    • In-game
      • Score: x0.96
      • Accuracy: x0.57
      • osu!standard Combo: x1.3 (x1.8 fully expanded)
  • Blend mode varies:

    • If used for combo counter:
      • In osu! and osu!catch, additive for the expanding after images.
      • Additionally in osu!catch, the after images are tinted using the combo colour of the fruit.
      • In osu!mania, multiplicative.
Default skin: score-5.png
score-6.png All X (Varies) (Varies) -
  • By default, this is also used for the combo numbers.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
      • Total Score: x1.3 in V2+
    • In-game
      • Score: x0.96
      • Accuracy: x0.57
      • osu!standard Combo: x1.3 (x1.8 fully expanded)
  • Blend mode varies:

    • If used for combo counter:
      • In osu! and osu!catch, additive for the expanding after images.
      • Additionally in osu!catch, the after images are tinted using the combo colour of the fruit.
      • In osu!mania, multiplicative.
Default skin: score-6.png
score-7.png All X (Varies) (Varies) -
  • By default, this is also used for the combo numbers.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
      • Total Score: x1.3 in V2+
    • In-game
      • Score: x0.96
      • Accuracy: x0.57
      • osu!standard Combo: x1.3 (x1.8 fully expanded)
  • Blend mode varies:

    • If used for combo counter:
      • In osu! and osu!catch, additive for the expanding after images.
      • Additionally in osu!catch, the after images are tinted using the combo colour of the fruit.
      • In osu!mania, multiplicative.
Default skin: score-7.png
score-8.png All X (Varies) (Varies) -
  • By default, this is also used for the combo numbers.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
      • Total Score: x1.3 in V2+
    • In-game
      • Score: x0.96
      • Accuracy: x0.57
      • osu!standard Combo: x1.3 (x1.8 fully expanded)
  • Blend mode varies:

    • If used for combo counter:
      • In osu! and osu!catch, additive for the expanding after images.
      • Additionally in osu!catch, the after images are tinted using the combo colour of the fruit.
      • In osu!mania, multiplicative.
Default skin: score-8.png
score-9.png All X (Varies) (Varies) -
  • By default, this is also used for the combo numbers.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
      • Total Score: x1.3 in V2+
    • In-game
      • Score: x0.96
      • Accuracy: x0.57
      • osu!standard Combo: x1.3 (x1.8 fully expanded)
  • Blend mode varies:

    • If used for combo counter:
      • In osu! and osu!catch, additive for the expanding after images.
      • Additionally in osu!catch, the after images are tinted using the combo colour of the fruit.
      • In osu!mania, multiplicative.
Default skin: score-9.png
score-comma.png All X normal (Varies) 5x14
  • By default, this is also used for the combo numbers.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
      • Total Score: x1.3 in V2+
    • In-game
      • Score: x0.96
      • Accuracy: x0.57
  • This element is for the accuracy.

  • The usage is dependent on your selected language.

Default skin: score-comma.png
score-dot.png All X normal (Varies) 5x14
  • By default, this is also used for the combo numbers.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
      • Total Score: x1.3 in V2+
    • In-game
      • Score: x0.96
      • Accuracy: x0.57
  • This element is for the accuracy.

  • The usage is dependent on your selected language.

Default skin: score-dot.png
score-percent.png All X normal (Varies) 12x14
  • This element is for the accuracy.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
    • In-game
      • Accuracy: x0.57
Default skin: score-percent.png
score-x.png All X (Varies) (Varies) 10x14
  • This element is for the combo, only used in osu!.

  • Custom pathing possible by using ScorePrefix

  • Different scaling depending on usage:

    • Results screen
      • All counters: x1.1
    • In-game
      • osu!standard Combo: x1.3 (x1.8 fully expanded)
  • Blend mode varies:

    • If used for combo counter:
      • Additive for the expanding after images.
Default skin: score-x.png

Song Selection Buttons

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
rank-forum.png All X X normal Centre 25x25
  • Any pixels outside of the 25x25 square will be cut off.

Default skin: rank-forum.png
selection-mode.png All X X normal Top Left Varies
  • In v1.0, positioning is 87px away from the bottom.

  • Suggested SD size:

    • v1.0: 92x87
    • v2.0+: 92x90
Default skin: selection-mode.png
selection-mode-over.png All X X normal Top Left Varies
  • Hover over selection-mode.png to see.

  • In v1.0, positioning is 87px away from the bottom.

  • Suggested SD size:

    • v1.0: 92x87
    • v2.0+: 92x90
Default skin: selection-mode-over.png
selection-mods.png All X X normal Top Left Varies
  • In v1.0, positioning is 87px away from the bottom.

  • Suggested SD size:

    • v1.0: 77x87
    • v2.0+: 77x87
Default skin: selection-mods.png
selection-mods-over.png All X X normal Top Left Varies
  • Hover over selection-mods.png to see.

  • In v1.0, positioning is 87px away from the bottom.

  • Suggested SD size:

    • v1.0: 77x87
    • v2.0+: 77x87
Default skin: selection-mods-over.png
selection-random.png All X X normal Top Left Varies
  • In v1.0, positioning is 87px away from the bottom.

  • Suggested SD size:

    • v1.0: 77x87
    • v2.0+: 77x87
Default skin: selection-random.png
selection-random-over.png All X X normal Bottom Left Varies
  • Hover over selection-random.png to see.

  • In v1.0, positioning is 87px away from the bottom.

  • Suggested SD size:

    • v1.0: 77x87
    • v2.0+: 77x87
Default skin: selection-random-over.png
selection-options.png All X X normal Top Left Varies
  • In v1.0, positioning is 87px away from the bottom.

  • Suggested SD size:

    • v1.0: 77x87
    • v2.0+: 77x87
Default skin: selection-options.png
selection-options-over.png All X X normal Top Left Varies
  • Hover over selection-options.png to see.

  • In v1.0, positioning is 87px away from the bottom.

  • Suggested SD size:

    • v1.0: 77x87
    • v2.0+: 77x87
Default skin: selection-options-over.png
selection-tab.png All X Multiplicative Top Left 142x24
  • Depending on the client’s window size, 4 to 5 tabs will be displayed.

Default skin: selection-tab.png

Song Selection

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
songselect-bottom.png All X X normal Bottom Left -
  • Stretches to 100% of screen width.

  • Making this element too tall will prevent mouse clicks from interacting with elements below it.

Default skin: songselect-bottom.png
songselect-top.png All X X normal Top Left -
  • Rightmost few pixels repeat from a certain point

  • Repetitions are layered below the initial asset

  • Their starting point varies depending on user’s in-game resolution

Default skin: songselect-top.png
Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
menu-button-background.png All X Multiplicative Bottom Left min: 690x85
  • Skin versions 2.2+ can support thumbnails (must be enabled in the options) for song selection

    • Thumbnails get positioned 9px away from the left image border
    • Thumbnail size is 115x85
  • This element is used in various places:

    • scoreboards in song selection
    • button for the beatmap difficulty in song selection
    • scoreboards on the left while playing
    • button that shows the selected beatmap while waiting in a room in multiplayer
  • Tinting varies by button state.

Default skin: menu-button-background.png
star.png All X X Multiplicative Centre 50x50
  • This element is used for difficulty star ratings (seen in song selection).

    • v2.2+ will scale down the last star, if necessary
    • v2.1- will crop the last star, if necessary
  • Tinting depends on the state of menu-button-background.png

Default skin: star.png
star2.png All X Additive Centre 24x24
  • This element is used for song selection (the stars that fly from right to left), cursor, kiai time, combobursts.

Default skin: star2.png

Standard

Hitbursts

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
hit0.png All ✓ (see notes) normal Centre -
  • Animation name: hit0-{n}.png

  • Animation rate is fixed to 60 FPS. With a total length of 1.1s

  • If animation is used:

    • animation does not loop, but the last frame persists until it fades out.
    • results screen uses 0th frame
    • static sprites are used (if included)
    • single frame behaviour is not used.
  • Animation timing: (frame:opacity)

  • 0-7 : 0% -> 100%

  • 8-30 : 100%

  • 30-66 : 100% -> 0%

Default skin: hit0.png
hit50.png All ✓ (see notes) normal Centre -
  • Animation name: hit50-{n}.png

  • Animation rate is fixed to 60 FPS. With a total length of 1.1s

  • If animation is used:

    • animation does not loop, but the last frame persists until it fades out.
    • results screen uses 0th frame
    • static sprites are used (if included)
    • single frame behaviour is not used.
  • Animation timing: (frame:opacity)

  • 0-7 : 0% -> 100%

  • 8-30 : 100%

  • 30-66 : 100% -> 0%

Default skin: hit50.png
hit100.png All ✓ (see notes) normal Centre -
  • Animation name: hit100-{n}.png

  • Animation rate is fixed to 60 FPS. With a total length of 1.1s

  • If animation is used:

    • animation does not loop, but the last frame persists until it fades out.
    • results screen uses 0th frame
    • static sprites are used (if included)
    • single frame behaviour is not used.
  • Animation timing: (frame:opacity)

  • 0-7 : 0% -> 100%

  • 8-30 : 100%

  • 30-66 : 100% -> 0%

Default skin: hit100.png
hit100k.png All ✓ (see notes) normal Centre -
  • Default skin shows 喝 (Katsu)

    • Shows after finishing a combo with a 100
  • Animation name: hit100k-{n}.png

  • Animation rate is fixed to 60 FPS. With a total length of 1.1s

  • If animation is used:

    • animation does not loop, but the last frame persists until it fades out.
    • results screen uses 0th frame
    • static sprites are used (if included)
    • single frame behaviour is not used.
  • Animation timing: (frame:opacity)

  • 0-7 : 0% -> 100%

  • 8-30 : 100%

  • 30-66 : 100% -> 0%

Default skin: hit100k.png
hit300.png All ✓ (see notes) normal Centre -
  • Animation name: hit300-{n}.png

  • Animation rate is fixed to 60 FPS. With a total length of 1.1s

  • If animation is used:

    • animation does not loop, but the last frame persists until it fades out.
    • results screen uses 0th frame
    • static sprites are used (if included)
    • single frame behaviour is not used.
  • Animation timing: (frame:opacity)

  • 0-7 : 0% -> 100%

  • 8-30 : 100%

  • 30-66 : 100% -> 0%

Default skin: hit300.png
hit300g.png All ✓ (see notes) normal Centre -
  • Default skin shows 激 (Geki)

    • Shows after finishing a combo with only 300s
  • Animation name: hit300g-{n}.png

  • Animation rate is fixed to 60 FPS. With a total length of 1.1s

  • If animation is used:

    • animation does not loop, but the last frame persists until it fades out.
    • results screen uses 0th frame
    • static sprites are used (if included)
    • single frame behaviour is not used.
  • Animation timing: (frame:opacity)

  • 0-7 : 0% -> 100%

  • 8-30 : 100%

  • 30-66 : 100% -> 0%

Default skin: hit300g.png
hit300k.png All ✓ (see notes) normal Centre -
  • Default skin shows 喝 (Katsu)

    • Shows after finishing a combo with a 300, while having 1 or more 100
  • Animation name: hit300k-{n}.png

  • Animation rate is fixed to 60 FPS. With a total length of 1.1s

  • If animation is used:

    • animation does not loop, but the last frame persists until it fades out.
    • results screen uses 0th frame
    • static sprites are used (if included)
    • single frame behaviour is not used.
  • Animation timing: (frame:opacity)

  • 0-7 : 0% -> 100%

  • 8-30 : 100%

  • 30-66 : 100% -> 0%

Default skin: hit300k.png
particle50.png All X normal Centre 7x7
  • hit50.png must be skinned.

Default skin: particle50.png
particle100.png All X normal Centre 7x7
  • hit100.png must be skinned.

  • This element is used for hit100.png and hit100k.png.

Default skin: particle100.png
particle300.png All X normal Centre 7x7
  • hit300.png must be skinned.

  • This element is used for hit300, hit300g, and hit300k.

Default skin: particle300.png

Hitcircle

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
approachcircle.png All X Multiplicative Centre 126x126
  • Tinting depends on the hit circle’s combo colour.

  • This element shrinks over time.

    • If Hidden mod is enabled, this element will not be used.
      • To show the first approach circle with Hidden mod enabled, the player will need to enable it in the options.
  • Should be a circle.

Default skin: approachcircle.png
hitcircle.png All X Multiplicative Centre 118x118 (circle) 128x128 (whole file)

Image used for osu! combo burst

  • This element fades in before getting tapped and expands when tapped or missed.

    • If Hidden mod is enabled, this will fade in before getting tapped and only fade out.
  • Tinting depends on the hit circle’s combo colour.

  • Also used for sliderstartcircle and/or sliderendcircle if not skinned.

  • Should be a circle.

Default skin: hitcircle.png
hitcircleoverlay.png All X (see notes) normal Centre 118x118 (circle) 128x128 (whole file)
  • This element fades in before getting tapped and expands when tapped or missed.

    • If Hidden mod is enabled, this will fade in before getting tapped and only fade out.
  • This can either overlay or underlay the combo number, by default this will always overlay.

    • To make this underlay the combo number, set HitCircleOverlayAboveNumber to 0.
  • Should be a circle.

  • This element was animatable in the past. For full details, see skinning history.

  • The overlay’s visibility on sliders depends on slider circle elements:

    • If sliderstartcircle/sliderendcircle exists in a skin without sliderstartcircleoverlay/sliderendcircleoverlay, then hitcircleoverlay isn’t displayed at all on slider starts or ends.
    • If sliderstartcircle/sliderendcircle does not exist, then hitcircleoverlay is used as the overlay sprite for slider starts or ends.
Default skin: hitcircleoverlay.png
followpoint.png All normal Centre -
  • Animation name: followpoint-{n}.png

  • If an arrow-like figure is used, it should point towards the right.

  • This stays on the screen for 1.2 seconds (1200ms).

Default skin: followpoint.png
lighting.png All X Additive Centre 100x100
  • This can be disabled in the options.

  • Tinting depends on the hit circle’s combo colour.

  • Used during kiai time:

    • Coloured afterimage as part of hitburst explosion.
    • Glowing behind hit circles during kiai time.
  • This element is also used in osu!taiko and osu!catch.

  • In v2.0+, the expanding animation is smaller.

Default skin: lighting.png
sliderstartcircle.png All X Multiplicative Centre 118x118 (circle) 128x128 (whole file)
  • Overrides hitcircle.png for the start of the slider, if skinned.

  • This element is the hit circle for the start of the slider.

  • This element fades in before getting tapped and expands when tapped or missed.

    • If Hidden mod is enabled, this will fade in before getting tapped and only fade out.
  • Should be a circle.

Default skin: sliderstartcircle.png
sliderstartcircleoverlay.png All X (see notes) normal Centre 118x118 (circle) 128x128 (whole file)
  • This element fades in before getting tapped and expands when tapped or missed.

    • If Hidden mod is enabled, this will fade in before getting tapped and only fade out.
  • This can either overlay or underlay the combo number, by default this will always overlay.

    • To make this underlay the combo number, set HitCircleOverlayAboveNumber to 0.
  • Overrides the hitcircle.png image for the start of the slider.

  • sliderstartcircle.png is required for this to work.

  • Should be a circle.

  • This element was animatable in the past. For full details, see skinning history.

Default skin: sliderstartcircleoverlay.png
sliderendcircle.png All X Multiplicative Centre 118x118 (circle) 128x128 (whole file)
  • Overrides hitcircle.png for the end of the slider, if skinned.

  • This element is the hitcircle for the end of the slider.

  • This element fades in before completing and expands when completed.

    • If Hidden mod is enabled, this will fade in before completing and only fade out.
  • Should be a circle.

Default skin: sliderendcircle.png
sliderendcircleoverlay.png All X (see notes) normal Centre 118x118 (circle) 128x128 (whole file)
  • This element fades in before completing and expands when completed.

    • If Hidden mod is enabled, this will fade in before completing and only fade out.
  • This can either overlay or underlay the combo number, by default this will always overlay.

    • To make this underlay the combo number, set HitCircleOverlayAboveNumber to 0.
  • Overrides the hitcircleoverlay.png image for the end of the slider.

  • sliderendcircle.png is required for this to work.

  • Should be a circle.

  • This element was animatable in the past. For full details, see skinning history.

Default skin: sliderendcircleoverlay.png
reversearrow.png All X normal Centre 118x118 (circle) 128x128 (whole file)
  • osu! will rotate this element to line up with the slider’s path.

  • This element will pulse at the bpm.

  • If an arrow-like figure is used, it should point towards the right.

Default skin: reversearrow.png

Hitcircle Numbers

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
default-0.png All X normal Centre -
  • In v1.0, these expanded then fades out with the hit circle.

    • If Hidden mod is enabled, this will only fade out.
  • In v2.0+, these fade out.

  • Custom pathing possible by using HitCirclePrefix

  • This element is downscaled by 0.8x

Default skin: default-0.png
default-1.png All X normal Centre -
  • In v1.0, these expanded then fades out with the hit circle.

    • If Hidden mod is enabled, this will only fade out.
  • In v2.0+, these fade out.

  • Custom pathing possible by using HitCirclePrefix

  • This element is downscaled by 0.8x

Default skin: default-1.png
default-2.png All X normal Centre -
  • In v1.0, these expanded then fades out with the hit circle.

    • If Hidden mod is enabled, this will only fade out.
  • In v2.0+, these fade out.

  • Custom pathing possible by using HitCirclePrefix

  • This element is downscaled by 0.8x

Default skin: default-2.png
default-3.png All X normal Centre -
  • In v1.0, these expanded then fades out with the hit circle.

    • If Hidden mod is enabled, this will only fade out.
  • In v2.0+, these fade out.

  • Custom pathing possible by using HitCirclePrefix

  • This element is downscaled by 0.8x

Default skin: default-3.png
default-4.png All X normal Centre -
  • In v1.0, these expanded then fades out with the hit circle.

    • If Hidden mod is enabled, this will only fade out.
  • In v2.0+, these fade out.

  • Custom pathing possible by using HitCirclePrefix

  • This element is downscaled by 0.8x

Default skin: default-4.png
default-5.png All X normal Centre -
  • In v1.0, these expanded then fades out with the hit circle.

    • If Hidden mod is enabled, this will only fade out.
  • In v2.0+, these fade out.

  • Custom pathing possible by using HitCirclePrefix

  • This element is downscaled by 0.8x

Default skin: default-5.png
default-6.png All X normal Centre -
  • In v1.0, these expanded then fades out with the hit circle.

    • If Hidden mod is enabled, this will only fade out.
  • In v2.0+, these fade out.

  • Custom pathing possible by using HitCirclePrefix

  • This element is downscaled by 0.8x

Default skin: default-6.png
default-7.png All X normal Centre -
  • In v1.0, these expanded then fades out with the hit circle.

    • If Hidden mod is enabled, this will only fade out.
  • In v2.0+, these fade out.

  • Custom pathing possible by using HitCirclePrefix

  • This element is downscaled by 0.8x

Default skin: default-7.png
default-8.png All X normal Centre -
  • In v1.0, these expanded then fades out with the hit circle.

    • If Hidden mod is enabled, this will only fade out.
  • In v2.0+, these fade out.

  • Custom pathing possible by using HitCirclePrefix

  • This element is downscaled by 0.8x

Default skin: default-8.png
default-9.png All X normal Centre -
  • In v1.0, these expanded then fades out with the hit circle.

    • If Hidden mod is enabled, this will only fade out.
  • In v2.0+, these fade out.

  • Custom pathing possible by using HitCirclePrefix

  • This element is downscaled by 0.8x

Default skin: default-9.png

Slider

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
sliderfollowcircle.png All normal Centre 256x256 (see notes)
  • Animation name: sliderfollowcircle-{n}.png

  • Max size: 308x308 (hitbox)

  • This element expands briefly when collecting a slider tick.

Default skin: sliderfollowcircle.png
sliderb.png All ✓ (see notes) Multiplicative Centre 118x118
  • Animation name: sliderb{n}.png (no hyphen (-))

  • Tinting depends on the hit circle’s combo colour.

  • By default, the sliderball flips upon hitting the reverse arrow.

    • To disable this, set sliderballflip to 0.
Default skin: sliderb.png
sliderb-nd.png All X ✓ (see notes) Multiplicative Centre 118x118
  • Ignored if sliderb.png is skinned.

    • Beatmap skinnable if the player skin does not have sliderb.png skinned.
  • Tinted black.

  • This element is the background layer of the default slider ball.

Default skin: sliderb-nd.png
sliderb-spec.png All X ✓ (see notes) Additive Centre 118x118
  • Ignored if sliderb.png is skinned.

    • Beatmap skinnable if the player skin does not have sliderb.png skinned.
  • This element is the top layer of the ball that stays in a static position (does not flip nor rotate).

Default skin: sliderb-spec.png
sliderpoint10.png 1.0 X ✓ (see notes) normal Centre 50x30
  • Beatmap Skinnable if the player skin is using v1.0.

  • Used when the player collects a slider tick.

  • Should say “10”.

Default skin: sliderpoint10.png
sliderpoint30.png 1.0 X ✓ (see notes) normal Centre 50x30
  • Beatmap Skinnable if the player skin is using v1.0.

  • Used when the player starts a slider and/or when they hit the reverse arrow.

  • Should say “30”.

Default skin: sliderpoint30.png
sliderscorepoint.png All X normal Centre 16x16
  • This element is the slider tick.

  • If this element is overlapping the slider start or end, it will not be rendered.

  • This element is also used in osu!taiko.

Default skin: sliderscorepoint.png

Spinner

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
spinner-approachcircle.png All X normal Centre 384x384
  • This element is positioned around 397px vertically.

  • Applied to both styles.

  • Shrinks over time, like approachcircle.png

  • Usage is forced when spinner-circle.png or spinner-top.png is skinned.

  • This element is also used for osu!taiko.

Default skin: spinner-approachcircle.png
spinner-rpm.png All X normal TopLeft 280x56
  • RPM is short for “Revolutions Per Minute”

  • This element is positioned at 139px to the left from the middle of the screen and at 712px height

    • (373,712) at 1024x768
    • (544,712) at 1366x768
Default skin: spinner-rpm.png
spinner-clear.png All X normal Centre -
  • This element is positioned around 230px vertically.

  • This appears when the player has fulfilled the spinner.

Default skin: spinner-clear.png
spinner-spin.png All X normal Centre -
  • This element is positioned around 582px vertically.

  • This appears at the start of a spinner.

Default skin: spinner-spin.png

Spinner (Old)

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
spinner-background.png All X Multiplicative Centre 1024x702 (see notes)
  • osu! is watching for this element. If found, it will force the old styled spinners on v2.0+ (all elements in this section).

  • Using the suggested SD size will help alignment with spinner-metre.png.

  • By default, tinted grey.

    • To change this, use the SpinnerBackground command.
Default skin: spinner-background.png
spinner-circle.png All X normal Centre -
  • This element is positioned around 397px vertically.

  • This element is the rotating part of the spinner.

  • This element is also used for osu!taiko.

    • If using the new spinner style, you can still skin this for osu!taiko.
Default skin: spinner-circle.png
spinner-metre.png All X normal TopLeft 1024x692
  • Positioned 46px away from top and 512px to the left from the middle axis.

    • (0,46) at 1024x768 and (171,46) at 1366x768.
  • This element is the progression bars

  • The highest part of the bar will blink when bonus points are awarded.

Default skin: spinner-metre.png
spinner-osu.png 1.0 X ✓ (see notes) normal Centre -
  • Beatmap Skinnable if the player skin is using v1.0.

  • This appears after the spinner fades out.

Default skin: spinner-osu.png

Spinner (New)

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
spinner-glow.png 2.0+ X Additive Centre -
  • This element is positioned around 397px vertically.

  • Tinted cyan, blinks white when bonus points are awarded

  • This blinks when awarding bonus points.

  • This element is the lowest layer.

Default skin: spinner-glow.png
spinner-bottom.png 2.0+ X normal Centre -
  • This element is positioned around 397px vertically.

  • This rotates the slowest.

  • This element is the second lowest layer.

Default skin: spinner-bottom.png
spinner-top.png 2.0+ X normal Centre -
  • This element is positioned around 397px vertically.

  • This rotates the second fastest (slower than spinner-middle2.png).

  • This element is the middle layer.

Default skin: spinner-top.png
spinner-middle.png 2.0+ X Multiplicative Centre -
  • This element is positioned around 397px vertically.

  • Tinted red over time (this is the time indicator).

  • This element is the highest layer.

Default skin: spinner-middle.png
spinner-middle2.png 2.0+ X normal Centre -
  • This element is positioned around 397px vertically.

  • This rotates the fastest.

  • This element is the second highest layer.

Default skin: spinner-middle2.png

Catch the Beat

Catcher & Interface

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
fruit-catcher-idle.png 2.3+ normal Top Min width: 302px
  • Animation name: fruit-catcher-idle-{n}.png

  • This element is the catcher state when doing nothing or catching objects

  • This should face towards the right.

  • The first 16 pixels at the top should be transparent.

  • The width should cover two fruits at a Circle Size of 0.

Default skin: fruit-catcher-idle.png
fruit-catcher-fail.png 2.3+ normal Centre -
  • Animation name: fruit-catcher-fail-{n}.png

  • This element is the “missed” catcher state.

  • This overrides fruit-catcher-kiai.png if a fruit or drop/droplet is missed during kiai time.

  • This should face towards the right.

Default skin: fruit-catcher-fail.png
fruit-catcher-kiai.png 2.3+ normal Centre -
  • Animation name: fruit-catcher-kiai-{n}.png

  • This element is the catcher state during kiai time.

  • fruit-catcher-fail.png will override this if a fruit or drop/droplet is missed during kiai time.

  • This should face towards the right.

Default skin: fruit-catcher-kiai.png
fruit-ryuuta.png 2.2- ✓ (see notes) normal Centre -
  • Beatmap Skinnable if the player skin is using v2.2-.

  • Animation name: fruit-ryuuta-{n}.png

  • This should face towards the right.

Default skin: fruit-ryuuta.png
comboburst-fruits.png 2.3+ X (see notes) normal BottomLeft Max height: 768px
  • To have multiple combobursts, use: comboburst-fruits-{n}.png.

    • One of the images in the set will be appear when a combo milestone is met.
  • On v2.2-, comboburst.png will be used instead.

  • osu!catch-specific combobursts

  • This can be disabled in the options.

  • This should face towards the right.

Default skin: comboburst-fruits.png
lighting.png All X Additive Centre 100x100
  • This pulsates on the catch line for where fruit’s landing location during kiai time.

  • This element is also used in osu! and osu!taiko.

  • This can be disabled in the options.

  • Tinting depends on the fruit’s combo colour.

Default skin: lighting.png

Fruits

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
fruit-pear.png All X Multiplicative Centre 128x128
  • This element is shown first.

  • This element is used for the hyperdash outline.

  • Tinting depends on the fruit’s combo colour.

Default skin: fruit-pear.png
fruit-pear-overlay.png All X normal Centre 128x128
  • This element is shown first; overlaying fruit-pear.png.

Default skin: fruit-pear-overlay.png
fruit-grapes.png All X Multiplicative Centre 128x128
  • This element is shown second.

  • This element is used for the hyperdash outline.

  • Tinting depends on the fruit’s combo colour.

Default skin: fruit-grapes.png
fruit-grapes-overlay.png All X normal Centre 128x128
  • This element is shown second; overlaying fruit-grapes.png.

Default skin: fruit-grapes-overlay.png
fruit-apple.png All X Multiplicative Centre 128x128
  • This element is shown third.

  • This element is used for the hyperdash outline.

  • Tinting depends on the fruit’s combo colour.

Default skin: fruit-apple.png
fruit-apple-overlay.png All X normal Centre 128x128
  • This element is shown third; overlaying fruit-apple.png.

Default skin: fruit-apple-overlay.png
fruit-orange.png All X (see notes) Multiplicative Centre 128x128
  • Can be animated, but only the zeroth frame will be used.

    • Animation name: fruit-orange-{n}.png
  • This element is shown fourth (last).

  • This element is used for the hyperdash outline.

  • Tinting depends on the fruit’s combo colour.

    • On the ranking screen:
      • Tinted orange for collected fruit
      • Tinted light grey for missed fruit.
Default skin: fruit-orange.png
fruit-orange-overlay.png All X (see notes) normal Centre 128x128
  • Can be animated, but only the zeroth frame will be used.

    • Animation name: fruit-orange-overlay-{n}.png
  • This element is shown fourth (last); overlaying fruit-orange.png.

Default skin: fruit-orange-overlay.png
fruit-bananas.png All X Multiplicative Centre 128x128
  • Tinted yellow.

  • This element is shown during a “spinner”.

  • This element is used for the hyperdash outline.

Default skin: fruit-bananas.png
fruit-bananas-overlay.png All X normal Centre 128x128
  • This element is shown during a spinner; overlaying fruit-bananas.png.

Default skin: fruit-bananas-overlay.png
fruit-drop.png All X (see notes) Multiplicative Centre 128x128
  • Can be animated, but only the zeroth frame will be used.

    • Animation name: fruit-drop-{n}.png
  • This element is shown during a “slider”.

  • Tinting depends on the fruit’s combo colour.

Default skin: fruit-drop.png
fruit-drop-overlay.png All X normal Centre 128x128
  • This element is not used in the ranking screen.

  • This element is shown during a “slider”; overlaying fruit-drop.png

Default skin: fruit-drop-overlay.png

Taiko

Drum Bar

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
taiko-bar-left.png All X X (see notes) normal TopLeft 181x200
  • Beatmap skinnable status is suspected to be a bug.

  • Positioned at (0,216).

  • This element is where the drum goes.

Default skin: taiko-bar-left.png
taiko-drum-inner.png v1 - v2.0 X X (see notes) normal TopLeft Max width: 56px
  • Beatmap skinnable status is suspected to be a bug.

  • Position varies by skin version:

    • v1–v2.0: (29,266) (and (86,266) when mirrored)
    • v2.1+: (0,216) (and (90,216) when mirrored)
Default skin: taiko-drum-inner.png
taiko-drum-inner.png All X X (see notes) normal TopLeft Varies
  • Beatmap skinnable status is suspected to be a bug.

  • Position varies by skin version:

    • v1–v2.0: (29,266) (and (86,266) when mirrored)
    • v2.1+: (0,216) (and (90,216) when mirrored)
  • Suggested SD size:

    • v1.0–v2.0: Max width: 56px
    • v2.1+: 90x200
Default skin: taiko-drum-inner.png
taiko-drum-outer.png All X X (see notes) normal TopLeft Varies
  • Beatmap skinnable status is suspected to be a bug.

  • Position varies by skin version:

    • v1–v2.0: (85,253) ((13,253) when mirrored)
    • v2.1+: (90,216) (and (0,216) when mirrored)
  • Suggested SD size:

    • v1.0–v2.0: Max width: 72px
    • v2.1+: 90x200
Default skin: taiko-drum-outer.png
taiko-bar-right.png All X X (see notes) normal TopLeft Varies
  • Beatmap skinnable status is suspected to be a bug.

  • This element will get stretched to fit screen width.

  • This element is the normal state of the scrolling bar.

  • Position varies by skin version:

    • v1.0–v2.0: (181,216)
    • v2.1+: (0,216)
  • Suggested SD size:

    • v1.0–v2.0: 843x200
    • v2.1+: 1024x200
Default skin: taiko-bar-right.png
taiko-bar-right-glow.png All X X (see notes) normal TopLeft Varies
  • Beatmap skinnable status is suspected to be a bug.

  • This element will get stretched to fit screen width.

  • This element is the kiai state of the scrolling bar.

  • This element overlays taiko-bar-right.

  • Position varies by skin version:

    • v1.0–v2.0: (181,216)
    • v2.1+: (0,216)
  • Suggested SD size:

    • v1.0–v2.0: 843x200
    • v2.1+: 1024x200
Default skin: taiko-bar-right-glow.png
taiko-barline.png All X X normal Centre 4x175

This image is displayed on the playfield at the start of each measure in the song (unless omitted by a timing point).

Default skin: taiko-barline.png

Drumroll

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
taiko-roll-middle.png All X Multiplicative TopLeft 1x128
  • The SD image width must be exactly 1px wide.

  • This element is the track of the roll where the sliderscorepoint.png are placed on.

  • Tinting shifts from yellow to red.

Default skin: taiko-roll-middle.png
taiko-roll-end.png All X Multiplicative TopLeft 64x128
  • This element is the end part of a roll.

  • Tinting shifts from yellow to red.

Default skin: taiko-roll-end.png
sliderscorepoint.png All X normal Centre -
  • This element is also used in osu!.

  • This are the ticks of the roll.

Default skin: sliderscorepoint.png

Hitbursts

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
taiko-hit0.png All normal Centre -
  • Default skin shows 不可 (Bad)

  • Animation name: taiko-hit0-{n}.png.

  • If animated, default effect from static images will not be disabled.

Default skin: taiko-hit0.png
taiko-hit100.png All normal Centre -
  • Default skin shows 可 (OK)

  • Animation name: taiko-hit100-{n}.png.

  • If animated, default effect from static images will not be disabled.

Default skin: taiko-hit100.png
taiko-hit100k.png All normal Centre -
  • Default skin shows 良 (Good)

  • Animation name: taiko-hit100k-{n}.png.

  • If animated, default effect from static images will not be disabled.

Default skin: taiko-hit100k.png
taiko-hit300.png All normal Centre -
  • Animation name: taiko-hit300-{n}.png.

  • If animated, default effect from static images will not be disabled.

Default skin: taiko-hit300.png
taiko-hit300k.png All normal Centre -
  • Animation name: taiko-hit300k-{n}.png.

  • If animated, default effect from static images will not be disabled.

Default skin: taiko-hit300k.png
taiko-hit300g.png All X (see notes) X normal Centre -
  • Can be animated, but only the zeroth frame will be used.

  • Animation name: taiko-hit300g-{n}.png

  • This image is only used on the ranking screen (instead of taiko-hit300k.png).

Default skin: taiko-hit300g.png

Notes

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
taikobigcircle.png All X Multiplicative Centre 118x118
  • This element is used for finisher/big notes.

    • This element is upscaled automatically.
  • This element is also used on the hit position.

  • Tinted red for “Don” (235,69,44)

  • Tinted blue for “Katsu” (68,141,171)

  • Tinted yellow for drumroll starting circle (252,83,6)

Default skin: taikobigcircle.png
taikobigcircleoverlay.png All normal Centre 118x118
  • Animation name: taikobigcircleoverlay-{n}.png.

    • 2 frames only (0 and 1)
    • animation speed depends on BPM
      • animation starts at combo 50
      • speeds up at combo 150
  • This element is upscaled automatically.

Default skin: taikobigcircleoverlay.png
taikohitcircle.png All X Multiplicative Centre 118x118
  • Tinted red for “Don” (235,69,44)

  • Tinted blue for “Katsu” (68,141,171)

  • Tinted yellow for drumroll starting circle (252,83,6)

Default skin: taikohitcircle.png
taikohitcircleoverlay.png All normal Centre 118x118
  • Animation name: taikohitcircleoverlay-{n}.png.

    • 2 frames only (0 and 1)
    • animation speed depends on BPM
      • animation starts at 50 combo
      • speeds up at 150 combo
Default skin: taikohitcircleoverlay.png
approachcircle.png All X normal Centre 126x126
  • This element is used on the hit position as a border.

  • This element is also used in osu!.

Default skin: approachcircle.png
taiko-glow.png All X X (see notes) Multiplicative Centre -
  • Beatmap skinnable status is suspected to be a bug.

  • Tinted yellow.

  • This element is behind the hit position during kiai time, expands when notes are hit.

Default skin: taiko-glow.png
lighting.png All X Additive Centre -
  • Tinted orange-red.

  • There isn’t a need to skin this element for osu!taiko.

    • This element is only visible when using a transparent taiko bar.
  • This pulsates behind the scrolling bar on the hit position during kiai time.

Default skin: lighting.png

Pippidon

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
pippidonclear.png All ✓ (see notes) normal BottomLeft -
  • Animation name: pippidonclear{n}.png.

    • You can only skin up 7 frames (from 0 to 6).
    • If animated, it is recommended to animate all 7 frames. (If not, the last frame will persist for the missing frames in the frame order as stated below.)
    • The animation frame order is 0 1 2 3 4 5 6 5 6 5 4 3 2 1 0.
  • The animation rate is BPM dependent.

  • This animation only plays once when the player hits a combo milestone; then goes back to the idle or kiai state.

Default skin: pippidonclear.png
pippidonfail.png All ✓ (see notes) normal BottomLeft -
  • Animation name: pippidonfail{n}.png.

  • The animation rate is BPM dependent.

  • This animation plays when the player misses a note or does not have enough health during a break.

  • This overrides pippidonkiai if the player misses a note during kiai time.

Default skin: pippidonfail.png
pippidonidle.png All ✓ (see notes) normal BottomLeft -
  • Animation name: pippidonidle{n}.png.

  • The animation rate is BPM dependent.

  • This animation plays when doing nothing (during breaks or waiting for the player to hit the next note)

Default skin: pippidonidle.png
pippidonkiai.png All ✓ (see notes) normal BottomLeft -
  • Animation name: pippidonkiai{n}.png.

  • The animation rate is BPM dependent.

  • This animation plays during kiai time.

  • pippidonfail.png overrides this if the player misses a note during kiai time.

Default skin: pippidonkiai.png

Slider Bar

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
taiko-flower-group.png All X (see notes) normal Bottom -
  • These are like combobursts.

  • To have multiple combobursts, use: taiko-flower-group-{n}.png.

    • One of the images in the set will be appear when a combo milestone is met.
  • This image expands and fades in from behind pippidon when it changes to clear state.

Default skin: taiko-flower-group.png
taiko-slider.png All X ✓ (see notes) normal TopLeft 776x162
  • Beatmap skinnable status is suspected to be a bug.

  • This scrolls in a seamless loop, from the right side towards the left.

  • This element is disabled if the beatmap has a storyboard.

  • Gets upscaled by 1.4x in-game.

Default skin: taiko-slider.png
taiko-slider-fail.png All X X normal TopLeft 776x162
  • This appears when the player misses a note or if the health bar isn’t filled up to 50% during a break.

  • Beatmap skinnable status is suspected to be a bug.

  • This scrolls in a seamless loop, from the right side towards the left.

  • This element is disabled if the beatmap has a storyboard.

  • Gets upscaled by 1.4x in-game.

Default skin: taiko-slider-fail.png

Spinner

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
spinner-warning.png All X normal Centre -
  • This element is an indicator for the spinner.

Default skin: spinner-warning.png
spinner-circle.png All X X (see notes) normal Centre -
  • Beatmap skinnable status is suspected to be a bug.

  • This element is also used in osu!.

  • For each hit in the spinner happens, the circle rotates anti-clockwise.

Default skin: spinner-circle.png
spinner-approachcircle.png All X X (see notes) normal Centre -
  • Beatmap skinnable status is suspected to be a bug.

  • This element is also used in osu!.

  • This element is the duration indicator of the spinner.

    • This shrinks over time.
Default skin: spinner-approachcircle.png

Mania

Hitbursts

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
mania-hit0.png All normal Centre -
  • Animation name: mania-hit0-{n}.png.

  • This element has a fixed looped animation of 60 FPS.

  • If a custom path is used, the ranking screen will use the file in the root directory instead of the pathed skinning element.

Default skin: mania-hit0.png
mania-hit50.png All normal Centre -
  • Animation name: mania-hit50-{n}.png.

  • This element has a fixed looped animation of 60 FPS.

  • If a custom path is used, the ranking screen will use the file in the root directory instead of the pathed skinning element.

Default skin: mania-hit50.png
mania-hit100.png All normal Centre -
  • Animation name: mania-hit100-{n}.png.

  • This element has a fixed looped animation of 60 FPS.

  • If a custom path is used, the ranking screen will use the file in the root directory instead of the pathed skinning element.

Default skin: mania-hit100.png
mania-hit200.png All normal Centre -
  • Animation name: mania-hit200-{n}.png.

  • This element has a fixed looped animation of 60 FPS.

  • If a custom path is used, the ranking screen will use the file in the root directory instead of the pathed skinning element.

Default skin: mania-hit200.png
mania-hit300.png All normal Centre -
  • Animation name: mania-hit300-{n}.png.

  • This element has a fixed looped animation of 60 FPS.

  • If a custom path is used, the ranking screen will use the file in the root directory instead of the pathed skinning element.

Default skin: mania-hit300.png
mania-hit300g.png All normal Centre -
  • Animation name: mania-hit300g-{n}.png.

  • This element has a fixed looped animation of 60 FPS.

  • If a custom path is used, the ranking screen will use the file in the root directory instead of the pathed skinning element.

Default skin: mania-hit300g.png

Keys

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
mania-key1.png All X X normal Bottom 50x107
  • This is the idle state.

  • This element gets stretched or compressed to fit the column width.

Default skin: mania-key1.png
mania-key1D.png All X X normal Bottom 50x107
  • This is the pressed state.

  • This element gets stretched or compressed to fit the column width.

Default skin: mania-key1D.png
mania-key2.png All X X normal Bottom 50x107
  • This is the idle state.

  • This element gets stretched or compressed to fit the column width.

Default skin: mania-key2.png
mania-key2D.png All X X normal Bottom 50x107
  • This is the pressed state.

  • This element gets stretched or compressed to fit the column width.

Default skin: mania-key2D.png
mania-keyS.png All X X normal Bottom 50x107
  • This is the idle state.

  • This element gets stretched or compressed to fit the column width.

Default skin: mania-keyS.png
mania-keySD.png All X X normal Bottom 50x107
  • This is the pressed state.

  • This element gets stretched or compressed to fit the column width.

Default skin: mania-keySD.png

Notes

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
mania-note1.png All X normal Bottom -
  • Animation name: mania-note1-{n}.png.

  • These elements are scaled to fit the individual columns.

    • If the columns’ widths differ: the smallest one is scaled correctly and the others are compressed to match its height.
  • Notes can be manually stretched or compressed via the WidthForNoteHeightScale command in the skin.ini file.

Default skin: mania-note1.png
mania-note2.png All X normal Bottom -
  • Animation name: mania-note2-{n}.png.

  • These elements are scaled to fit the individual columns.

    • If the columns’ widths differ: the smallest one is scaled correctly and the others are compressed to match its height.
  • Notes can be manually stretched or compressed via the WidthForNoteHeightScale command in the skin.ini file.

Default skin: mania-note2.png
mania-noteS.png All X normal Bottom -
  • Animation name: mania-noteS-{n}.png.

  • These elements are scaled to fit the individual columns.

    • If the columns’ widths differ: the smallest one is scaled correctly and the others are compressed to match its height.
  • Notes can be manually stretched or compressed via the WidthForNoteHeightScale command in the skin.ini file.

Default skin: mania-noteS.png
mania-note1H.png All X normal Bottom -
  • Animation name: mania-note1H-{n}.png.

  • By default, this is also the tail part.

    • When used for the tail part, this element is flipped by default for v2.5+.
  • This element is scaled to fit the individual columns.

    • If the columns’ widths differ: the smallest one is scaled correctly and the others are compressed to match its height.
  • Long notes can be manually stretched or compressed via the WidthForNoteHeightScale command in the skin.ini file.

Default skin: mania-note1H.png
mania-note2H.png All X normal Bottom -
  • Animation name: mania-note2H-{n}.png.

  • By default, this is also the tail part.

    • When used for the tail part, this element is flipped by default for v2.5+.
  • This element is scaled to fit the individual columns.

    • If the columns’ widths differ: the smallest one is scaled correctly and the others are compressed to match its height.
  • Long notes can be manually stretched or compressed via the WidthForNoteHeightScale command in the skin.ini file.

Default skin: mania-note2H.png
mania-noteSH All X normal Bottom -
  • Animation name: mania-noteSH-{n}.png.

  • By default, this is also the tail part.

    • When used for the tail part, this element is flipped by default for v2.5+.
  • This element is scaled to fit the individual columns.

    • If the columns’ widths differ: the smallest one is scaled correctly and the others are compressed to match its height.
  • Long notes can be manually stretched or compressed via the WidthForNoteHeightScale command in the skin.ini file.

Default skin: mania-noteSH
mania-note1L.png All ✓ (see notes) X normal Bottom -
  • Animation name: mania-note1L-{n}.png.

  • The animation starts when the long note is pressed and stops if released.

  • The NoteBodyStyle changes the behaviour of these elements.

  • Notes can be manually stretched or compressed via the WidthForNoteHeightScale command in the skin.ini file.

Default skin: mania-note1L.png
mania-note2L.png All ✓ (see notes) X normal Bottom -
  • Animation name: mania-note2L-{n}.png.

  • The animation starts when the long note is pressed and stops if released.

  • The NoteBodyStyle changes the behaviour of these elements.

  • Notes can be manually stretched or compressed via the WidthForNoteHeightScale command in the skin.ini file.

Default skin: mania-note2L.png
mania-noteSL.png All ✓ (see notes) X normal Bottom -
  • Animation name: mania-noteSL-{n}.png.

  • The animation starts when the long note is pressed and stops if released.

  • The NoteBodyStyle changes the behaviour of these elements.

  • Notes can be manually stretched or compressed via the WidthForNoteHeightScale command in the skin.ini file.

Default skin: mania-noteSL.png
mania-note1T.png All X normal Bottom -
  • Animation name: mania-note1T-{n}.png.

  • These elements are the tail part of the hold note.

  • By default, the head notes are used instead.

  • By default, these elements are flipped for skin versions 2.5 and up.

  • These elements are scaled to fit the individual columns.

    • If the columns’ widths differ: the smallest one is scaled correctly and the others are compressed to match its height.
  • Notes can be manually stretched or compressed via the WidthForNoteHeightScale command in the skin.ini file.

Default skin: mania-note1T.png
mania-note2T.png All X normal Bottom -
  • Animation name: mania-note2T-{n}.png.

  • These elements are the tail part of the hold note.

  • By default, the head notes are used instead.

  • By default, these elements are flipped for skin versions 2.5 and up.

  • These elements are scaled to fit the individual columns.

    • If the columns’ widths differ: the smallest one is scaled correctly and the others are compressed to match its height.
  • Notes can be manually stretched or compressed via the WidthForNoteHeightScale command in the skin.ini file.

Default skin: mania-note2T.png
mania-noteST.png All X normal Bottom -
  • Animation name: mania-noteST-{n}.png.

  • These elements are the tail part of the hold note.

  • By default, the head notes are used instead.

  • By default, these elements are flipped for skin versions 2.5 and up.

  • These elements are scaled to fit the individual columns.

    • If the columns’ widths differ: the smallest one is scaled correctly and the others are compressed to match its height.
  • Notes can be manually stretched or compressed via the WidthForNoteHeightScale command in the skin.ini file.

Default skin: mania-noteST.png

Stage

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
comboburst-mania.png All X (see notes) normal BottomLeft Max height: 768px
  • To have multiple combobursts, use: comboburst-mania-{n}.png.

    • One of the images in the set will appear when a combo milestone is met.
  • osu!mania-specific combobursts

  • This can be disabled in the options.

  • Unlike osu! and osu!catch’s combobursts, all edges of this imageset should not be clipped.

Default skin: comboburst-mania.png
mania-stage-left.png All X X normal BottomRight Max height: 768px
  • This element is shown on the left side of the stage(s).

  • This element is stretched to fit the stage height (allows for shorter images).

Default skin: mania-stage-left.png
mania-stage-right.png All X X normal BottomRight Max height: 768px
  • This element is shown on the right side of the stage(s).

  • This element is stretched to fit the stage height (allows for shorter images).

Default skin: mania-stage-right.png
mania-stage-bottom.png All X normal Bottom -
  • This element is 0.625x smaller than the stage width.

  • Animation name: mania-stage-bottom-{n}.png.

  • Shown on the bottom (or top, if the stage is upside down) of the stage(s).

  • This element will not be stretched to fit the stage width!

  • This element should be skinned for a 480px playfield height.

  • This element overlays the entire stage, including the notes.

Default skin: mania-stage-bottom.png
mania-stage-light.png All X Multiplicative Bottom Max height: 768px
  • Animation name: mania-stage-light-{n}.png.

  • This element is the lighting for the columns when the key is pressed.

  • This element is placed underneath the notes.

  • By default, tinted white.

  • Use ColourLight to change this.

  • Positioning is set by the skin.ini

  • Use LightPosition.

Default skin: mania-stage-light.png
mania-stage-hint.png All X X normal Centre -
  • This element is the graphical representation of the judgement line.

  • The judgement line is drawn in the centre of the image.

  • This element is drawn for the entire stage width, not individual columns.

  • This element is stretched to fit the stage width (allowing for narrower images).

Default skin: mania-stage-hint.png
mania-warningarrow.png All X X normal Centre -
  • This element should point downwards.

    • This image is automatically flipped horizontally if the stage is upside down.
  • This element is always seen before the map starts, if there is enough time.

Default skin: mania-warningarrow.png
lightingL.png All X Additive Centre -
  • Animation name: lightingL-{n}.png.

  • This element is the lighting for the long notes.

  • This image is flipped horizontally if the stage is upside down.

  • This element is positioned where the centre of the judgement line crosses the centre of a lane.

Default skin: lightingL.png
lightingN.png All X Additive Centre -
  • Animation name: lightingN-{n}.png.

  • This element is the lighting for the single notes (and tail notes).

  • This image is flipped horizontally if the stage is upside down.

  • This element is positioned where the centre of the judgement line crosses the centre of a lane.

Default skin: lightingN.png

Sounds

Gameplay Countdown

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
count.wav All X ? normal centre
  • This replaces the count{n}s sounds (if one sound is wanted).

  • This is also the metronome for the Target Practice mod.

count1s.wav All X ? normal centre
count2s.wav All X ? normal centre
count3s.wav All X ? normal centre
gos.wav All X ? normal centre
readys.wav All X ? normal centre

Gameplay Game Screens

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
applause.wav All X ? normal centre
  • The sound is played on the ranking screen after clearing a map.

  • Should be formatted as .mp3 or .ogg in beatmaps aiming for rank.

pause-loop.wav All X ? normal centre
  • The sound is played when the game is paused.

  • This sound is looped.

  • Fades out when the client loses focus.

Gameplay Playfield

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
comboburst.wav All X ? normal centre

Achieving a combo milestone

combobreak.wav All X ? normal centre

Breaking a combo of 20 or more

failsound.wav All X ? normal centre

Failing a map at any point

  • Not intended to last longer than the fail animation (about 5 seconds).

  • Using a long audio track will impact the game client’s performance, as it is loaded each time you play a beatmap, even if you never fail. It isn’t supposed to be bigger than a few kilobytes.

sectionpass.wav All X ? normal centre

Halfway through a break with high HP remaining

sectionfail.wav All X ? normal centre

Halfway through a break with low HP remaining

Hitsounds - Drum

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
drum-hitnormal.wav All X ? normal centre
  • These sounds are mapped as D:C1 on beatmap skins:

drum-hitclap.wav All X ? normal centre
  • These sounds are mapped as D:C1 on beatmap skins:

drum-hitfinish.wav All X ? normal centre
  • These sounds are mapped as D:C1 on beatmap skins:

drum-hitwhistle.wav All X ? normal centre
  • These sounds are mapped as D:C1 on beatmap skins:

drum-slidertick.wav All X ? normal centre
  • These sounds are mapped as D:C1 on beatmap skins:

drum-sliderslide.wav All X ? normal centre
  • These sounds are mapped as D:C1 on beatmap skins:

  • Looped

drum-sliderwhistle.wav All X ? normal centre
  • These sounds are mapped as D:C1 on beatmap skins:

  • Looped

Hitsounds - Nightcore

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
nightcore-kick.wav All X ? normal centre
  • These sounds play on top of the song when the Nightcore mod is enabled. In 4/4 time:

  • is played on beats 1 and 3

nightcore-clap.wav All X ? normal centre
  • These sounds play on top of the song when the Nightcore mod is enabled. In 4/4 time:

  • is played on beats 2 and 4

nightcore-hat.wav All X ? normal centre
  • These sounds play on top of the song when the Nightcore mod is enabled. In 4/4 time:

  • is played on every odd quaver, but only if the slider tick rate of the beatmap is a multiple of 2

nightcore-finish.wav All X ? normal centre
  • These sounds play on top of the song when the Nightcore mod is enabled. In 4/4 time:

  • is played on the first beat of every 4 measures, unless that barline is omitted by a timing point

Hitsounds - Normal

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
normal-hitnormal.wav All X ? normal centre
  • These sounds are mapped as N:C1 on beatmap skins:

normal-hitclap.wav All X ? normal centre
  • These sounds are mapped as N:C1 on beatmap skins:

normal-hitfinish.wav All X ? normal centre
  • These sounds are mapped as N:C1 on beatmap skins:

normal-hitwhistle.wav All X ? normal centre
  • These sounds are mapped as N:C1 on beatmap skins:

normal-slidertick.wav All X ? normal centre
  • These sounds are mapped as N:C1 on beatmap skins:

normal-sliderslide.wav All X ? normal centre
  • These sounds are mapped as N:C1 on beatmap skins:

  • Looped

normal-sliderwhistle.wav All X ? normal centre
  • These sounds are mapped as N:C1 on beatmap skins:

  • Looped

Hitsounds - Soft

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
soft-hitnormal.wav All X ? normal centre
  • These sounds are mapped as S:C1 on beatmap skins:

soft-hitclap.wav All X ? normal centre
  • These sounds are mapped as S:C1 on beatmap skins:

soft-hitfinish.wav All X ? normal centre
  • These sounds are mapped as S:C1 on beatmap skins:

soft-hitwhistle.wav All X ? normal centre
  • These sounds are mapped as S:C1 on beatmap skins:

soft-slidertick.wav All X ? normal centre
  • These sounds are mapped as S:C1 on beatmap skins:

soft-sliderslide.wav All X ? normal centre
  • These sounds are mapped as S:C1 on beatmap skins:

  • Looped

soft-sliderwhistle.wav All X ? normal centre
  • These sounds are mapped as S:C1 on beatmap skins:

  • Looped

Hitsounds - Spinner

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
spinnerspin.wav All X ? normal centre
  • This sound is looped.

  • This sound could modulate from ~500 hz to 80000 hz.

spinnerbonus.wav All X ? normal centre

Plays everytime you get 1000 bonus points from spinning.

spinnerbonus-max.wav All X ? normal centre
  • In the Lazer client, this sound plays instead of spinnerbonus.wav if the maximum score has already been achieved on the spinner. It has no effect in osu!stable.

Hitsounds - Taiko Drum

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
taiko-drum-hitnormal.wav All X ? normal centre
  • These sounds are mapped as D:C1 on beatmap skins, and they are only played when mapped and included:

taiko-drum-hitclap.wav All X ? normal centre
  • These sounds are mapped as D:C1 on beatmap skins, and they are only played when mapped and included:

taiko-drum-hitfinish.wav All X ? normal centre
  • These sounds are mapped as D:C1 on beatmap skins, and they are only played when mapped and included:

taiko-drum-hitwhistle.wav All X ? normal centre
  • These sounds are mapped as D:C1 on beatmap skins, and they are only played when mapped and included:

Hitsounds - Taiko Normal

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
taiko-normal-hitnormal.wav All X ? normal centre
  • These sounds are mapped as N:C1 on beatmap skins:

taiko-normal-hitclap.wav All X ? normal centre
  • These sounds are mapped as N:C1 on beatmap skins:

taiko-normal-hitfinish.wav All X ? normal centre
  • These sounds are mapped as N:C1 on beatmap skins:

taiko-normal-hitwhistle.wav All X ? normal centre
  • These sounds are mapped as N:C1 on beatmap skins:

Hitsounds - Taiko Soft

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
taiko-soft-hitnormal.wav All X ? normal centre
  • These sounds are mapped as S:C1 on beatmap skins:

taiko-soft-hitclap.wav All X ? normal centre
  • These sounds are mapped as S:C1 on beatmap skins:

taiko-soft-hitfinish.wav All X ? normal centre
  • These sounds are mapped as S:C1 on beatmap skins:

taiko-soft-hitwhistle.wav All X ? normal centre
  • These sounds are mapped as S:C1 on beatmap skins:

Interface Clicks

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
back-button-click.wav All X ? normal centre

Clicking on the back button

check-on.wav All X ? normal centre

Enabling a checkbox or a mod

check-off.wav All X ? normal centre

Disabling a checkbox or a mod

click-close.wav All X ? normal centre

Closing a chat tab

click-short-confirm.wav All X ? normal centre

Clicking to confirm a button or dropdown option, opening or closing chat, switching between chat tabs, or switching groups

menuback.wav All X ? normal centre

Clicking on menu-back or returning to the previous screen

menuhit.wav All X ? normal centre

Confirming a selection that switches screens

menu-back-click.wav All X ? normal centre

Clicking on Back in the main menu

menu-direct-click.wav All X ? normal centre

Clicking on osu!direct in the main menu

menu-edit-click.wav All X ? normal centre

Clicking on Edit in the main menu

menu-exit-click.wav All X ? normal centre

Clicking on Exit in the main menu

menu-freeplay-click.wav All X ? normal centre

Clicking on Solo in the main menu

menu-multiplayer-click.wav All X ? normal centre

Clicking on Multiplayer in the main menu

menu-options-click.wav All X ? normal centre

Clicking on Options in the main menu

menu-play-click.wav All X ? normal centre

Clicking on Play in the main menu

pause-back-click.wav All X ? normal centre

Clicking Back to Menu in the pause menu

pause-continue-click.wav All X ? normal centre

Clicking Continue in the pause menu

pause-retry-click.wav All X ? normal centre

Clicking Retry in the pause menu

select-expand.wav All X ? normal centre

Switching into song selection, selecting a beatmap, opening dropdown boxes, opening chat tabs

select-difficulty.wav All X ? normal centre

Selecting a difficulty of a beatmap

shutter.wav All X ? normal centre

Taking a screenshot

Interface Drag

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
sliderbar.wav All X ? normal centre

Changing the options via a slider

whoosh.wav All X ? normal centre

Disabled as of now

Interface Hover

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
back-button-hover.wav All X ? normal centre

Hovering above the back button

click-short.wav All X ? normal centre

Hovering above all selectable boxes except beatmaps or main screen buttons

menuclick.wav All X ? normal centre

Hovering above difficulties

menu-back-hover.wav All X ? normal centre

Hovering above Back in the main menu

menu-direct-hover.wav All X ? normal centre

Hovering above osu!direct in the main menu

menu-edit-hover.wav All X ? normal centre

Hovering above Edit in the main menu

menu-exit-hover.wav All X ? normal centre

Hovering above Exit in the main menu

menu-freeplay-hover.wav All X ? normal centre

Hovering above Solo in the main menu

menu-multiplayer-hover.wav All X ? normal centre

Hovering above Multiplayer in the main menu

menu-options-hover.wav All X ? normal centre

Hovering above Options in the main menu

menu-play-hover.wav All X ? normal centre

Hovering above Play in the main menu

pause-hover.wav All X ? normal centre
pause-back-hover.wav All X ? normal centre

Hovering over Back to Menu in pause menu

pause-continue-hover.wav All X ? normal centre

Hovering over Continue in pause menu

pause-retry-hover.wav All X ? normal centre

Hovering over Retry in pause menu

Interface Keys

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
key-confirm.wav All X ? normal centre

Sending a message in chat

key-delete.wav All X ? normal centre

Deleting text in chat

key-movement.wav All X ? normal centre

Changing the text cursor position

key-press-{n}.wav All X ? normal centre

Pressing a key for chat, search, edit, etc. (n = 1/2/3/4)

Interface Main Menu

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
heartbeat.wav All X ? normal centre

When the cursor hovers over the osu! cookie in the main menu

seeya.wav All X ? normal centre

Closing the osu! client

  • For seeya.wav and welcome.wav:

  • osu!supporter is required to modify.

  • This can be disabled by unchecking osu! music theme in the options.

welcome.wav All X ? normal centre

Starting the osu! client

  • For seeya.wav and welcome.wav:

    • osu!supporter is required to modify.
    • This can be disabled by unchecking osu! music theme in the options.

Interface Metronome

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
metronomelow.wav All X ? normal centre
  • In the beatmap editor, this plays for the small white ticks; however, the beatmap editor will only use the default sounds.

  • Despite the above, this can be skinned for the offset wizard and the bananas in osu!catch (pitch goes up per caught banana).

Interface Multiplayer

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
match-confirm.wav All X ? normal centre

All players are ready

match-join.wav All X ? normal centre

A player joins a room

match-leave.wav All X ? normal centre

A player leaves a room

match-notready.wav All X ? normal centre

A player revoked his ready signal

match-ready.wav All X ? normal centre

A player is ready to start

match-start.wav All X ? normal centre

The match is starting. Also the chat highlight sound

skin.ini

Versions

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
1.0 All X ? normal centre
2.0 All X ? normal centre
  • UI: positioning changes / osu!: visibility update (reduced clutter).

    • High definition skins
      • Use the suffix @2x.png in the skinning element to let osu! know that the skinning element is higher in quality.
    • New style spinner (spinner-middle.png, spinner-middle2.png, spinner-top.png, spinner-bottom.png, and spinner-glow.png).
    • Countdown sequence instead of segmented image.
      • Countdowns are now centred.
    • Hitcircle numbers are no longer part of hitburst explosions.
    • Red coloured play-warningarrow during end of breaks.
    • Smaller expansion of lighting.png.
    • Anchor changes of selectionbar images.
    • Positioning changes of ranking screen images (generally, it is shifted down).
2.1 All X ? normal centre
2.2 All X ? normal centre
  • interface/UI changes

    • Thumbnail support.
      • Must be enabled by the user in the Options and be supported by the skin in the skin.ini file.
    • Changes star rating display to scaling star.png instead of partially widthed star.png.
    • Panel text alignment optimisations.
2.3 All X ? normal centre
  • osu!catch changes

    • fruit-ryuuta.png will no longer work from this point forward.
    • New catcher states (and images).
    • New osu!catch specific combobursts (comboburst-fruits.png).
      • osu! combobursts will no longer be used for osu!catch.
2.4 All X ? normal centre
  • osu!mania stage scaling adjustments

    • Downscale combo counter and hitbursts.
    • Column lines are drawn on both sides of the column when columns are spaced.
    • Introduction of hold note tails on release (works for all versions).
2.5 All X ? normal centre
2.6 All X ? normal centre
2.7 All X ? normal centre
  • osu!mania specific combobursts

latest All X ? normal centre
  • Always the newest version

  • If your skin folder does not contain a skin.ini file, it will default to this version.

    • Never use this when distributing skins! (if a new skin version releases, a skin with its version set to latest might break).
    • Always uses the latest version the game supports.
User All X ? normal centre
  • This is not a version, but a special skin folder that is created when the default skin is modified, e.g. by dragging in a custom menu background into the game window (with osu!supporter) or when attempting to modify osu!mania keybinds for the default skin from the options.

  • A skin in a folder named User will always use the latest skin version, regardless of any speification in skin.ini or otherwise.

[General]

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
Name: All X ? normal centre
  • After exporting the skin, the filename is <Name>.osk.

    • In osu!(lazer), the filename is <Name> (<Author>).osk.
  • The skin selector uses folder names, not the names given by this option.

    • In osu!(lazer), the skin selector options are in the format <Name> (<Author>), or <Name> [<.osk filename>] (<Author>) if the name in skin.ini differs from the name of the .osk file.

Unknown

Author: All X ? normal centre
  • In osu!(lazer), after exporting the skin, the filename is <Name> (<Author>).osk.

    • In osu!(lazer), the skin selector options are in the format <Name> (<Author>), or <Name> [<.osk filename>] (<Author>) if the name in skin.ini differs from the name of the .osk file.

(empty)

Version: All X ? normal centre
  • If the skin.ini file is not present, latest will be used.

  • If the skin.ini file is present, but does not use the Version command, 1.0 will be used (legacy support).

AnimationFramerate: All X ? normal centre
  • This will set the framerate of most animations.

  • Exceptions: circleoverlays, sliderball, pippidon, osu!mania notes and lighting

-1

AllowSliderBallTint: All X ? normal centre
  • The default sliderball will always get tinted, if enabled in options.

0

ComboBurstRandom: All X ? normal centre

0

CursorCentre: All X ? normal centre
  • 0 = top-left corner

  • 1 = centred

1

CursorExpand: All X ? normal centre

1

CursorRotate: All X ? normal centre

1

CursorTrailRotate: All X ? normal centre

1

CustomComboBurstSounds: All X ? normal centre
  • This is not for osu!taiko.

  • This only affects the combo burst sounds, not the milestones.

(empty)

HitCircleOverlayAboveNumber: All X ? normal centre
  • This is for osu! only.

  • Old command: HitCircleOverlayAboveNumer (with typo) still works for legacy support

1

LayeredHitSounds: All X ? normal centre

1

SliderBallFlip: All X ? normal centre
  • This is for osu! only.

1

SpinnerFadePlayfield: All X ? normal centre
  • Should the spinner add black bars during spins?

0

SpinnerFrequencyModulate: All X ? normal centre
  • Should the spinnerspin sound pitch up the longer the spinner goes?

1

SpinnerNoBlink: All X ? normal centre
  • Should the highest bar of the metre stay visible all the time?

0

[Colours]

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
Combo1: All X ? normal centre
  • This is used if beatmap skin is disabled or uses default colours.

  • This appears last.

255,192,0

Combo2: All X ? normal centre
  • This is used if beatmap skin is disabled or uses default colours.

  • This appears first.

0,202,0

Combo3: All X ? normal centre
  • This is used if beatmap skin is disabled or uses default colours.

  • This appears second, if defined.

18,124,255

Combo4: All X ? normal centre
  • This is used if beatmap skin is disabled or uses default colours.

  • This appears third, if defined.

242,24,57

Combo5: All X ? normal centre
  • This is used if beatmap skin is disabled or uses default colours.

  • This appears fourth, if defined.

(empty)

Combo6: All X ? normal centre
  • This is used if beatmap skin is disabled or uses default colours.

  • This appears fifth, if defined.

(empty)

Combo7: All X ? normal centre
  • This is used if beatmap skin is disabled or uses default colours.

  • This appears sixth, if defined.

(empty)

Combo8: All X ? normal centre
  • This is used if beatmap skin is disabled or uses default colours.

  • This appears seventh, if defined.

(empty)

InputOverlayText: All X ? normal centre
  • This is for osu! and osu!catch only..

  • This tints the numbers shown on the input overlay.

0,0,0

MenuGlow: All X ? normal centre

0,78,155

SliderBall: All X ? normal centre
  • This is for osu!.

  • Default sliderball’s colour if tinting is disabled in options.

2,170,255

SliderBorder: All X ? normal centre
  • This is for osu! only.

255,255,255

SliderTrackOverride: All X ? normal centre
  • This is for osu! only.

  • Using this will make all slider track colours the same.

use current combo colour

SongSelectActiveText: All X ? normal centre

0,0,0

SongSelectInactiveText: All X ? normal centre

255,255,255

SpinnerBackground: All X ? normal centre

100,100,100

StarBreakAdditive: All X ? normal centre
  • colour of star2 during breaks

255,182,193

[Fonts]

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
HitCirclePrefix: All X ? normal centre
  • You can use a custom path

default

HitCircleOverlap: All X ? normal centre
  • Negative integers will add a gap.

-2

ScorePrefix: All X ? normal centre

score

ScoreOverlap: All X ? normal centre
  • Negative integers will add a gap.

0

ComboPrefix: All X ? normal centre

score

ComboOverlap: All X ? normal centre
  • Negative integers will add a gap.

0

[CatchTheBeat]

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
HyperDash: All X ? normal centre
  • osu! will use a default alpha value.

  • This is the colour of the catcher itself.

255,0,0

HyperDashFruit: All X ? normal centre
  • osu! will use a default alpha value.

  • This is the colour outlining the fruit.

use HyperDash

HyperDashAfterImage: All X ? normal centre
  • osu! will use a default alpha value.

  • This is the colour of the images following the catcher after obtaining the hyperdash fruit.

use HyperDash

[Mania]

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Default Skin Asset
Keys: All X ? normal centre
  • This is required per key set

ColumnStart: All X ? normal centre

136

ColumnRight: All X ? normal centre

19

ColumnSpacing: All X ? normal centre
  • This is the spacing between the columns

  • The gap will be transparent.

0

ColumnWidth: All X ? normal centre
  • It is suggested to keep this thin if high keycounts or wide keys are used.

30

ColumnLineWidth: All X ? normal centre

2

BarlineHeight: All X ? normal centre

1.2

LightingNWidth: All X ? normal centre

(empty)

LightingLWidth: All X ? normal centre

(empty)

WidthForNoteHeightScale: All X ? normal centre
  • If not defined, the height scale of the smallest column width is used

HitPosition: All X ? normal centre

402

LightPosition: All X ? normal centre

413

ScorePosition: All X ? normal centre
  • The hitbursts will be vertically centred on the stage.

ComboPosition: All X ? normal centre
  • The combo counter will be vertically centred on the stage.

JudgementLine: All X ? normal centre
  • This is the hint for when the keys should be pressed.

LightFramePerSecond: All X ? normal centre

unknown

SpecialStyle: All X ? normal centre
  • 0 = none

  • 1 = (left (SP) or outer (DP) lane)

  • 2 = (right (SP) or inner (DP) lane)

  • For even keycounts, more than 4.

  • For DP, the centre between the stages is used for determining positions.

0

ComboBurstStyle: All X ? normal centre
  • 0 = Left

  • 1 = Right

  • 2 = Both (random)

  • You can use the words or values, both are accepted.

  • Combobursts will be flipped on the right stage half.

1

SplitStages: All X ? normal centre
  • This value is forced, if defined.

  • 0 = no splitting / forced SP

  • Each keycount higher than 1 can be split (or merged, if count is higher than 9).

StageSeparation: All X ? normal centre
  • The distance between the two stages, if split.

40

SeparateScore: All X ? normal centre
  • 0 = shows on both stages at the same time

  • 1 = shows when hit on specific stage

  • For DP, each stage gets shown its own judgement or of both stages

1

KeysUnderNotes: All X ? normal centre
  • should be used depending on note and key designs.

0

UpsideDown: All X ? normal centre
  • Act like DDR/StepMania?

0

KeyFlipWhenUpsideDown: All X ? normal centre
  • Requires skin version 2.5 or higher.

  • This applies for all columns.

1

KeyFlipWhenUpsideDown#: All X ? normal centre
  • Requires skin version 2.5 or higher.

  • This applies for the specified column.

  • Replace # with a valid column index (from 0 to 17).

NoteFlipWhenUpsideDown: All X ? normal centre
  • Requires skin version 2.5 or higher.

  • This applies for all columns.

1

KeyFlipWhenUpsideDown#D: All X ? normal centre
  • Requires skin version 2.5 or higher.

  • This applies for the specified column’s pressed key state.

NoteFlipWhenUpsideDown#: All X ? normal centre
  • Requires skin version 2.5 or higher.

  • Column specific (for notes)

NoteFlipWhenUpsideDown#H: All X ? normal centre
  • Requires skin version 2.5 or higher.

  • Column specific (for head parts)

NoteFlipWhenUpsideDown#L: All X ? normal centre
  • Requires skin version 2.5 or higher.

  • Column specific (for length parts)

NoteFlipWhenUpsideDown#T: All X ? normal centre
  • Requires skin version 2.5 or higher.

  • Column specific (for tail parts)

NoteBodyStyle: All X ? normal centre
  • Requires skin version 2.5 or higher.

  • All columns.

1

NoteBodyStyle#: All X ? normal centre
  • Requires skin version 2.5 or higher.

  • Column specific (for notes)

Colour#: All X ? normal centre
  • For the specific column’s background.

  • # starts at 1

0,0,0,255

ColourLight#: All X ? normal centre
  • Column specific (StageLight).

  • # starts at 1

55,255,255

ColourColumnLine: All X ? normal centre
  • These are the lines that separate the columns.

255,255,255,255

ColourBarline: All X ? normal centre
  • A bar is one full measure.

255,255,255,255

ColourJudgementLine: All X ? normal centre

255,255,255

ColourKeyWarning: All X ? normal centre
  • This is the colour of the keybindings check before the game starts

0,0,0

ColourHold: All X ? normal centre
  • This is the colour of the combo counter during holds.

255,191,51,255

ColourBreak: All X ? normal centre
  • This is the colour of combo counter during a combobreak.

255,0,0

KeyImage#: All X ? normal centre
  • This is for the specific column’s idle key image.

KeyImage#D: All X ? normal centre
  • This is for the specific column’s pressed key image.

NoteImage#: All X ? normal centre
  • This is for the specific column’s note image.

NoteImage#H: All X ? normal centre
  • This is for the specific column’s hold note head image.

NoteImage#L: All X ? normal centre
  • This is for the specific column’s hold note body image.

NoteImage#T: All X ? normal centre
  • This is for the specific column’s hold note tail image.

StageLeft: All X ? normal centre
  • This is the left border.

StageRight: All X ? normal centre
  • This is the right border.

StageBottom: All X ? normal centre
  • This will not be stretched to fit

StageHint: All X ? normal centre
  • This is the graphical judgement line.

StageLight: All X ? normal centre
  • This is the column lighting.

LightingN: All X ? normal centre
LightingL: All X ? normal centre
WarningArrow: All X ? normal centre
  • This appears three barlines before the map starts, if there is enough time.

Hit0: All X ? normal centre
Hit50: All X ? normal centre
Hit100: All X ? normal centre
Hit200: All X ? normal centre
Hit300: All X ? normal centre
Hit300g: All X ? normal centre

osu!lazer

Slidermiss Indicator

Name
Versions
Animatable
Beatmap Skinnable
Blend Mode
Origin
Suggested SD Size
Default Skin Asset
sliderendmiss.png All normal Centre 16x16

Displays when missing a sliderend.

Default skin: sliderendmiss.png
slidertickmiss.png All normal Centre 16x16

Displays when missing a slider tick.

Default skin: slidertickmiss.png