osu! program files 2m513a

See also: osu! File Formats 4a144h

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 626l6t

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

Folders 4e1x14

Chat 4d256h

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 5f3y4j

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

Exports 85p5x

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 6w22m

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 6dy5s

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 6e6n28

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 6o71j

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 414v1j

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 3h632c

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

Data 2w2s5h

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 4f6v1v

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

Database files (.db) 6u343u

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) 4z1p2

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) 5s760

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) 4i4j2v

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