osu! program files 4l2n1b

See also: osu! File Formats 6l2o5a

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 566c40

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

Folders 2a6z63

Chat 14u59

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 21141c

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

Exports 3i5f62

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 452773

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 132x1w

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

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

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

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

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

Data 6z2h62

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

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

Database files (.db) 103d53

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

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) 703j5c

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) 1v6f6y

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