First Run

After preparing your device for opsu!, you can follow these steps to add your favourite maps, skins and customize opsu!

Initialization

opsu! will parse all beatmaps and update the database when launched, which can take a while for the first time. If no beatmaps are found, the game will prompt you to download some to get started.

Settings

Game settings can be changed in the options menu, accessed by clicking the "Other Options" button in the song menu. The "Music Offset" value will likely need to be adjusted initially, or whenever hit objects are out of sync with the music.

Importing

Beatmaps

opsu! requires "beatmaps" to run, which contain the songs and gameplay data. These can be downloaded directly through opsu! in the downloads menu, or manually from the osu! website (needs an available osu! account) and mirror sites. Place any manually downloaded beatmaps (in .osz format) in the Import/ directory for opsu! to unpack them automatically. Currently opsu! only supports osu!(standard) mode beatmaps!

If osu! is installed, opsu! will attempt to read beatmaps from the osu! installation location. The beatmap directory can also be changed by setting the "BeatmapDirectory" value in the generated configuration file opsu.cfg.

Skins

Note

Currently opsu! doesn't support skins very well, but basic functions will work. Tell me in discussions if you encounter problems.

You can use the steps for beatmaps to import skins, but the skins must be present in .osk format. You can try to directly rename .zip files to .osk too.

All skins must have a skin.ini file, without which opsu! won't recognize them.

opsu! shows skins by their names and authors provided in the skin.ini file instead of directory names. You can change the skin in the options menu.

Directory Structure

Upon first run, opsu! will create the following files and directories under the executable.

Note

Depending on the version of opsu!, the directory structure may vary and is subject to change.

Warning

These files are all important or useful, for playing the game and reporting problems. Think twice before you delete or move them.

For those using the compile task, please back the files up often, in case of exceptional data losses or unintended effects.

• .opsu.cfg: The configuration file. Most (but not all) of the settings can be changed through the options menu.
• .opsu.db: The beatmap cache database.
• .opsu_scores.db: The scores and player database.
• .opsu.log: The error log. All critical errors displayed in-game are also logged to this file, and other warnings not shown are logged as well.
• Songs/: The beatmap directory (not used if an osu! installation is detected). The parser searches all of its subdirectories for .osu files to load.
• Skins/: The skins directory. Each skin must be placed in a folder within this directory. Any game resource (in res/) can be skinned by placing a file with the same name in a skin folder. Skins can be selected in the options menu.
• Replays/: The replay directory. Replays of each completed game are saved as .osr files, and can be viewed at a later time or shared with others.
• Import/: The import directory. All beatmap packs (.osz) and skin packs (.osk) are unpacked to the proper location. All replays (.osr) are moved to the replay directory, and their scores saved to the scores database.
• Screenshots/: The screenshot directory. Screenshots can be taken by pressing the F12 key.
• Natives/: The native libraries directory. (If exists)
• Temp/: The temporary files directory. Deleted when opsu! exits. (If exists)