This article explains everything you need to know on how to use the osu! game client. Here you will find information about the song select screen, the rankings display as well as the results screen. When starting the game client, you can see the following screen:
P) to play osu! either for yourself or with others.
E) to edit a beatmap.
O) to open the options sidebar.
Esc) to exit the game.
The jukebox has the following buttons:
|Stop and reset the current song to its beginning|
|Toggle between having the information for the current song showing permanently, or fading out after a little while.|
|Jump to a specific song. You can search for songs or filter by collection.|
The jukebox can also be controlled using keyboard shortcuts.
Access this screen by clicking on your profile at the top left of the main menu. You can select any item by pressing its corresponding number:
1. View Profile: View your profile page on the website.
2. Sign Out: Sign out of your account. After signing out, the game will prompt you to sign back in.
3. Change Avatar: Open the edit avatar page on the website.
4. Close: Close this dialog.
Play in the main menu, you can choose between three options:
P) to play on your own. This leads you to the song selection screen.
M) to play with other people. You will be directed to the Multi Lobby.
Backto return to the main menu.
Main page: Multi
The multiplayer lobby allows you to play with as well as against other players.
The currently selected game mode icon can be seen in the bottom left options, above
Mode. The mode icon is also faintly visible at the centre of the screen. These are the four you will see:
Before continuing on, this screen has too many elements to note with easily, noticeable numbers. The subsections below will focus on one part of the screen at a time, starting from top to bottom and left to right.
This area displays information on the beatmap difficulty currently selected. When entering the song selection screen, the song playing on the jukebox is selected by default. The top-left icon displays the beatmap category, where this particular one is ranked.
The song title is normally shown as romanised (lower picture), but if you select
Prefer metadata in original language in the Options, it will show the Unicode title (upper picture). The difficulty name of the beatmap is shown between square brackets (
). The creator who mapped the beatmap is shown below the title, and even more information is listed below. From left to right, the values are as follows:
Click on one of the tabs to sort your song list according to the selected criterion.
These options organise beatmaps into various expandable groups:
||Beatmaps will not be grouped but will still be sorted in the order specified by Sort.|
||Beatmaps will be grouped by their star rating, rounded down to a whole number.|
||Beatmaps will be grouped by the first character of the artist's name.|
||Beatmaps will be grouped by when you last played them.|
||This will show the collections you have created. Note that this will hide beatmaps not listed in a collection!|
||Beatmaps will be grouped according to BPM in multiples of 60.|
||Beatmaps will be grouped by the first character of the beatmap creator's name.|
||Beatmaps will be grouped according to when they were added, from today to 5+ months ago.|
||Beatmaps will be grouped according to their length: 1 minute or less, 2 minutes or less, 3, 4, 5, 10, and 10 minutes or more.|
||Beatmaps will be grouped according to their game mode.|
||Beatmaps will be sorted by the highest rank achieved on them.|
||Beatmaps will be grouped by the first character of the title.|
||Only beatmaps you have favourited online will be shown.|
||Only beatmaps you have mapped (that is, whose creator matches your profile name) will be shown.|
||Beatmaps will be grouped by their status: ranked, pending, not submitted, unknown, or loved.|
The first five groupings are available in tabs below Group and Sort.
Sort beatmaps in a certain order.
||Beatmaps will be sorted alphabetically by artist.|
||Beatmaps will be sorted lowest to highest by their BPM. For maps with changing BPM, the highest will be used.|
||Beatmaps will be sorted alphabetically by creator.|
||Beatmaps will be sorted by when they were added, from oldest to newest.|
||Beatmaps will be sorted by star rating, from easiest to hardest. Note that this will split apart the difficulties of the beatmap!|
||Beatmaps will be sorted by length, from shortest to longest.|
||Beatmaps will be sorted by the highest rank achieved on them, from worst to best.|
||Beatmaps will be sorted alphabetically by the song title.|
Note: You cannot have the chat console or the options sidebar open if you want to search. Otherwise, anything you type will be perceived as chat text or as an options search query.
Only beatmaps that match the criteria of your search will be shown. By default, any search will be matched against the beatmaps' artists, titles, creators, and tags.
In addition to searching these fields, you can use filters to search through other metadata by combining one of the supported filters with a comparison to a value (for example,
||Name of the artist|
||Name of the beatmap creator|
||Name of the track|
||Name of the beatmap difficulty|
||HP drain rate|
||Number of keys (osu!mania and converted beatmaps only)|
||Beats per minute|
||Length in seconds|
||Drain time in seconds|
||Game mode. This can be one of
||Beatmap status. Value can be
||Time since last played in days|
||Shows only unplayed maps. A comparison with no set value must be used (e.g.
||Saved osu!mania scroll speed. Always 0 for unplayed maps or if the
||Not equal to|
||Less than or equal to|
||Greater than or equal to|
You may also enter a difficulty or beatmap ID number in your search to get a single result.
A variety of things can appear in this space:
Not Submittedbox denotes a beatmap that has not been uploaded to the osu! website using the Beatmap Submission System or was deleted by the mapper.
Update to latest versionbox appears if there is a new version of the beatmap available for download. Click on the button to update.
Latest pending versionbox means that the beatmap has been uploaded to the osu! website but is not ranked yet.
No records set!box means that there are no replays for the current view setting (this is typically seen in the local view setting if you just downloaded or edited the beatmap).
These are the view settings:
Click the word bubble icon to call up the quick web access screen for the selected beatmap:
1or click the
Beatmap Listing/Scoresto view the beatmap page for the selected difficulty in your browser.
Beatmap Moddingto view the beatmap's modding page.
Cancelto return to the song selection screen.
The beatmap carousel displays all available beatmaps. Different beatmaps may have differently coloured boxes:
|Pink||This beatmap has not been played yet.|
|Orange||At least one difficulty from the beatmap has been completed.|
|Light Blue||Other difficulties in the same beatmap, shown when a beatmap is expanded.|
|White||Currently selected difficulty.|
You can navigate the beatmap list by using the mouse wheel, using the up and down arrow keys, dragging it while holding the left mouse button or clicking the right mouse button (known as absolute scrolling), which will move the scroll bar to your mouse's Y position. Click on a beatmap to select it, then click it again, press
Enter or click the osu! cookie at the bottom-right corner to play the beatmap.
List of available game modes
This section can be called the gameplay toolbox. We will cover each button's use from left to right.
Esc or click the
Back button to return to main menu.
Click on the
Mode button to open a list of game modes available in osu!. Alternatively, you can press
3 (osu!catch), or
4 (osu!mania) to change the game mode. Switching to another mode will also switch to its leaderboards, as one may observe by seeing the displayed rank change.
Mod selection screen
Mods button or press
F1 to open the mod selection screen.
In this screen, you can apply modifications ("mods" for short) to gameplay. Some mods lower difficulty and apply a multiplier that lowers the score you achieve. Conversely, some mods increase the difficulty, but apply a multiplier that increases the score you achieve. Finally, some mods modify gameplay in a different way. Relax and Auto Pilot fall in that category.
Place your mouse on a mod's icon to see a short description of its effect. Click on an icon to select or deselect that mod. Some mods, like Double Time, have multiple variations — click on the mod again to cycle through them. The score multiplier value displays the combined effect all selected mods will have on your score. Click
Reset all mods or press
1 to deselect all currently selected mods. Click
Close or press
Esc to return to the song selection screen.
Random button or press
F2 to have the game randomly scroll through all of your beatmaps and pick one.
Note: You can press
Shift + the
Random button or
F2 to go back to the beatmap you had selected before you randomised your selection.
Possible commands for a beatmap
Beatmap Options button, press
F3 or right-click your mouse while hovering over the beatmap to bring up the beatmap options menu for options on the currently selected beatmap.
1or click the
Manage Collectionsbutton to bring up the collection manager — here, you can manage pre-existing collections, as well as add or remove the currently selected beatmap or mapset to or from a collection.
Delete...to delete the  currently selected difficulty,  delete the currently selected beatmap, or  delete all VISIBLE beatmaps.
Remove from Unplayedto mark an unplayed beatmap as played (that is, change its box colour from pink to orange).
Clear local scoresto delete all records of the scores you have achieved in this beatmap.
Editto open the selected beatmap in osu!'s editor.
Closeto return to the song selection screen.
Click on your user panel to access the user options menu.
Click on the osu! cookie to start playing the selected beatmap.
Accuracy in osu!
This is the results screen shown after you have successfully passed the beatmap. You can access your online results by scrolling down or pressing the obvious button.
Below are the results screens of the other game modes.
Accuracy in osu!taiko
Accuracy in osu!mania
Accuracy in osu!catch
An example of an online osu! score
This is your online leaderboard. You can go here by scrolling down from the results screen. Your local scoreboard will show your name and the score as usual.
Save replay to Replays folder: You can watch the replay later either by opening it from a local leaderboard, or by going to
Replaysdirectory and double clicking it.
Add as online favourite: Include the beatmap into your list of favourites, which is located on your osu! profile page under the
Local Rankingsfrom the drop-down menu above the scoreboard.
Overall Rankingsection. It's available only for beatmaps with online leaderboards. You also need to be online to see this section. See below for more details.
The categories in the ranking panel are as follows:
|Category||Beatmap Ranking||Overall Ranking|
||Your position on the map's leaderboard. Note that scores with mods also appear on this same leaderboard.||Your global rank against everyone in the world.|
||How accurately you played the beatmap. This is only counted when your old score is surpassed.||A weighted average of the accuracy of your best scores.|
||The longest combo on the map you played.||The longest combo over all beatmaps you have played.|
||Your best result on the beatmap.||The number of points earned from all ranked beatmaps that you have ever played, with every map being counted exactly once.|
||Not taken into account, since it does not affect your position in online rankings.||Same as ranked score, but it takes into account all beatmaps available on the osu! website, including underplayed or failed beatmaps. This counts towards your level.|
||The amount of unweighted pp you would receive for the play.||Your total amount of performance points, and how much pp the submitted play was worth.|
Main page: Medals
Unlocking a medal
Sometimes, when specific conditions are met, you may receive a medal.