osu! program files 1t492f

See also: osu! File Formats x2k2d

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

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

Folders 126436

Chat 571f4b

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

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

Exports 6d43z

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 1n5f5y

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 182v5t

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 2y2b

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 2v2612

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 586e6d

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 c5d6t

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

Data 4w603l

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 2f5k6j

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

Database files (.db) 70c3x

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

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) 243f61

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

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