knowledge base
This page does not meet the standards of the osu! wiki and needs to be cleaned up or rewritten. If you are able to help out, please consider updating the article!

osu! program files

osu! Program Files in a nutshellosu! Program Files in a nutshell

Location

Windows

Current default filepath Old installer filepath
C:\Users\<Username>\AppData\Local\osu! C:\Program Files\osu! / C:\Program Files(x86)\osu! (for 7 64-bit or 8)

C: is your drive with osu! installed.

Folders

Chat

Only appears when you used "/savelog" at Chat Console once or if you enabled "Automatically log private messages" in Options. The folder shows your Chat Console tab's log of comments.

The styling is {Tab_name}-{YYYYMMDD}-{HHMMSS} in .txt format, which basically can be opened in any word application of choice(Notepad).

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

Downloads

This folder appears when you use the "osu!direct" download service (requires osu!supporter). This holds the .osz files which you are currently downloading from osu!direct. It will then be transferred into osu!'s Songs folder as legitimate beatmaps upon completion.

Exports

This folder appears if you used the Skin Selector's "Export as .osk" or Beatmap Editor's "Export Package". It will hold the .osz (beatmap)/.osk (skin) files you had exported from osu!.

If you want to know how to do this, see osu! File Formats.

Localisation

This folder appears when you have switched your language in the options. It will hold the translated text files which can be used each to replace the usual English text based on the user's selected localisation.

Replays

This folder holds osu! replay files (.osr). A replay file does not work when the beatmap linked to it is missing. The replay file also contains the results data and reanimates your cursor movement during the replay. To create the .osr, press F2 at Results screen or click on the Save as .osr at the Online Ranking screen (below Results screen in Solo only). This, however, does not save multi-play elements. The file sizes in here are usually ranging from 100KB ~ 1KB. For players who are interested to upload their replay to YouTube, see this thread.

The format is {Local player name} - {Artist} - {Title} {[Difficulty]}{(YYYY-MM-DD)} {Game Mode}

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

Screenshots

Screenshots (F12 by default) of osu!. The saved screenshot's file extension (.jpg/.png) is based on what you set on the Options menu.

The format is screenshot### where "###" is the screenshot number count.

Skins

This folder holds user-created skins, which can be used to customise the in-game interface. You can download skins from the Skinning subforum. You can instal .osk skins by double-clicking them. If the downloaded skin is in folder form, you will have to place the folder here yourself. If it is in a ZIP or RAR format, you must extract it first. You can change your skins at Options menu under Skins tab (Skin Selector). Please bear in mind that the selected skin is only visible to you.

For further reference, please refer to the Skinning page. Also, "osu! by peppy" is the only skin without its folder and cannot be deleted directly.

Songs

Your compendium of osu! beatmaps. Usually contains .osu (difficulties), .mp3/.ogg (music file), .jpg/.png/.gif (BG image), .osb (SB file) and .mp4/.flv (video file). May also contains .wav/.ogg (hitsound file) and folders (SB spites and/or skin).

The format 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

Data

osu!data files. Should not be tampered.

Program files

.db (Database file)

The .db files are beatmaps' data which only osu!.exe/osu!test.exe can utilise. Notepad can open the .db files but it will be mostly made up of encrypted characters.

osu! database

  • collection.db (Your "Collections" in-game. You can post it to forum for others to check out your "Collections". Actual beatmaps not provided.)
  • osu!.db (osu! beatmaps' cache. You know, that long start-up loading screen before you see Song Selection?)
  • presence.db (Cache of osu!players @ Chat Console)
  • scores.db (Stores historical Local scores)

.cfg (Configuration files)

Configuration files or config files configure the initial settings for osu! to work. The files can be opened by Notepad.

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

.exe (Application)

The main component. Click on it to start-up. The .exe files are safe to open assuming you used the osu!installer to install osu!.

osu!.exe (Start-up osu!)

Hidden files

.dll (application extension)

These .dll files are components of osu!.

Base components

  • avcodec-51.dll
  • avformat-52.dll
  • avutil-49.dll
  • bass.dll
  • bass_fx.dll
  • d3dcompiler_47.dll
  • libEGL.dll
  • libGLESv2.dll
  • Microsoft.Ink.dll
  • OpenTK.dll
  • pthreadGC2.dll

osu! components

  • osu!gameplay.dll
  • osu!seasonal.dll
  • osu!ui.dll
  • osu.dll