osu! program files 4j2h63

See also: osu! File Formats 6q6r36

The file structure of osu!'s installation folder, on Windows and macOS

The osu! program files are a set of files that run osu! and keep track of different activities as 's play.

Installation paths 342l4q

By default, osu! is installed in the following locations:

Folders fy5h

Chat 5rv11

The Chat folder only appears if the player has "Automatically log private messages" enabled in Options, or the player runs the "/savelog" command in the Chat Console.

The name structure of the files is {Tab_name}-{YYYYMMDD}-{HHMMSS}, and can be opened in any text editor. An example of this is shown below:

#multiplayer-20121115-040845 (/savelog at #multiplayer tab in 15th November 2012 at 04hrs, 08mins, and 45secs).

s 1q5r6i

The s folder holds the beatmaps being ed by osu!direct (requires osu!er). They get transferred to the Songs folder upon completion.

Exports 525j5b

The Exports folder appears if the player uses the Skin Selector's "Export as .osk" or Beatmap Editor's "Export Package". It will hold the beatmaps and skins the player has exported from osu!.

Localisation 664gq

The Localisation folder appears when the player has switched their language in the options. It will hold the translated text files which can be used each to replace the English text based on the 's selected localisation. The translated text files are generated when you switch languages.

Replays 4h3d67

Note: Replays used to be replayed at a lower sample rate, but are now more optimised of a better experience

The Replays folder holds the player's replay files. A replay file does not work when the beatmaps linked to it is missing. The replay also contains the results data, and reanimates the player's cursor movement while replaying. To create a replay, press F2 at the results screen, or click on the 'Save replay to Replays folder' (in Solo only).

*For players who interested in ing their replay to YouTube, see: Osr2mp4 public release. Automatically convert replay file to video.

The file name structure is {Local player name} - {Artist} - {Title} {[Difficulty]}{(YYYY-MM-DD)} {Game Mode}. An example of this is shown below:

dummytest1 - Loituma - Ievan Polkka \[SPINNER-MADNESS\] (2013-08-12) OsuMania

Screenshots 2l1v23

The Screenshots folder holds screenshots the player has created in osu!. By default, the saved screenshot's file extension is .jpg, however this can be changed to .png in the Options menu.

Note: To create a screenshot, press the screenshot key (F12 by default).

The file name structure is screenshot###, where "###" is the screenshot number count.

Skins 1s3n64

The Skins folder holds -created skins, which can be used to customise the in-game interface. Players can skins from the Skinning subforum. Players can install skins by double-clicking on the skin from a file manager. "osu! by peppy" is the only skin without its folder and cannot be deleted.

For further reference, see Skinning

Songs 2e562

The Songs folder holds the player's osu! beatmaps. Usually contains .osu (difficulties), .mp3/.ogg (music files), .jpg/.png/.gif (background images), .osb (storyboard files) and .mp4/.flv (video files). May also contain .wav/.ogg (hitsound files) and folders (storyboard sprites and/or skin folders).

The file name structure is {Beatmap number} {Artist} - {Song Title}.
Example: 57950 SOUND HOLIC - Drive My Life

Please note that some very old beatmaps (for example, Kenji Ninuma - DISCO PRINCE or Dudelstudios - Angry Video Game Nerd Theme [MATURE CONTENT]), as well as unsubmitted beatmaps, do not follow the format.

Hidden folders 4h136u

These folders are hidden because any modifications to them could prevent osu! from starting correctly, or at all.

Data ptg

osu! data files. Contains some of osu!'s cache, like beatmap background cache and avatar caches. They should not be deleted, because they may be in use by osu!.

Files 5id5b

Caution: Be careful with these files, you might break osu! if you are not careful.

Database files (.db) 332v57

The database files are databases that osu! requires to function properly. The files contain vital information that osu! requires, such as saved scores, and the cached list of beatmaps saved on the player's device.

• collections.db: Stores the player's "Collections" in-game.
• osu!.db: Stores osu!'s database of beatmaps.
• presence.db: Stores a cache of osu!players logged in the Chat Console.
• scores.db: Stores the local leaderboards.

.cfg (Configuration files) 32rh

Configuration files configure the initial settings for osu! to work. The files can be opened with a text editor.

• osu!.cfg: Stores security information about the osu! application files and current release stream. This should never be modified manually.
• osu!.<operating system name>.cfg: Stores Options data and other game settings. See Configuration File.

.exe (Application) 6a482h

The main component. Click on it to start-up (only applies to Windows). The .exe files are safe to open assuming the player used the osu!installer ed from the official website to install osu!.

osu!.exe (Start-up osu!)

.dll (application extension) 2j3219

These .dll files are osu!'s components and dependencies.