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