knowledge base

osu! program files

See also: osu! File Formats

The file structure of osu!'s installation folder, on Windows and macOSThe 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 user's play.

Installation paths

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

Windows macOS
C:\Users\<Username>\AppData\Local\osu! /Applications/osu!.app/Contents/Resources/drive_c/osu!

Folders

Chat

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).

Downloads

The Downloads folder holds the beatmaps being downloaded by osu!direct (requires osu!supporter). They get transferred to the Songs folder upon completion.

Exports

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!.

Localisations

The Localizations 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 user's selected localisation. The translated text files are generated when you switch languages.

Replays

Note: Replays used to be replayed at a lower sample rate, but are now more optimized 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 uploading 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

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

The Skins folder holds user-created skins, which can be used to customise the in-game interface. Players can download 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

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

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 spites 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

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

Data

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

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

Database files (.db)

The database files are databases that osu! requires to function propertly. 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)

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 username>.cfg: Stores Options data and other game settings. See User Configuration File.

.exe (Application)

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 downloaded from the official website to install osu!.

osu!.exe (Start-up osu!)

.dll (application extension)

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