Personal tools
Please be aware that the osu!wiki will be moving to GitHub.
You won't be able to edit articles soon so make sure to learn how to use GitHub.
Go to the new home of the osu!wiki


From osu!wiki
Jump to: navigation, search
Other Languages

Français  Русский  Español  Bahasa Indonesia  中文  Deutsch  Finnish  한국어  Polski  ภาษาไทย  Português  Italiano  粵語 

This page will tell you roughly how to get the game working in your device and some troubleshooting methods.


Installation guides

Desktop computers



Minimum System Requirements

How to install

  • Download the osu! installer.
  • Locate the file you just downloaded, double-click on it and follow the instructions to install osu!.
  • Run the game by double-clicking on the newly-created osu! icon on your desktop or the new entry in the Start menu.
  • The main menu should show up. You should be prompted to either log in using an osu! account (create one by clicking on the appropriate button) or play offline.
    • Playing online will enable you to register your scores in the global rankings and get a rank.
  • Enjoy your osu! experience!

Adding Beatmaps

A beatmap is a .osz file containing the song and other files needed to play.

  • Go to the beatmap listing. Find a song that you like and click on its title to open its webpage.
  • Download it by clicking on the big pink "Download beatmap!" button (or, if available, the purple "Without Video" button if you don't want to download the included video).
  • At this point, there are several ways to get your beatmaps installed in osu!:
    • If your browser asks you what it should do with the file, choose "Open with osu!" if you can. The file will be downloaded, and osu! will automatically open and import the file.
    • If you choose to save the file instead, or your browser doesn't give you the choice, download the file, go to the download directory, and either double-click on it to automatically import it in osu! or, if osu! is already opened, drag and drop the newly-downloaded file directly in the game window. If you are tech-savvy, be aware that you can also move your .osz files in the "Songs" folder of osu!'s installation directory (default is Program Files).
  • Go play your beatmap! Press F5 at the song select screen if the list isn't automatically refreshed.

Note : There are a lot of alternative ways to download a beatmap. Here's a short list :

  • Download beatmap packs. They are archive files that combine several beatmaps at once. They generally come as a .zip or .rar archive. Download one, extract it with your favorite archive extractor (e.g. 7-Zip) and import the extracted .osz files as you would do normally.
  • Use a mirror. Mirrors are kindly offered by the community and let you download beatmaps without the need of going through the osu! website and its download quota. The most popular is yas-online but others are also available throughout the web.
  • If you know how to use a torrent client, here are torrent files provided by a member of the community that will let you download many beatmap packs at once.

OS X (beta version)

OS X (beta version)
How to install
  • Go to the download page and click on the "OS X installer" link to download the latest version.
  • Follow these instructions to install the .dmg file on your Mac.
  • Run osu!
    • The first time you run osu!, it may take up to 5 minutes to start. This is due to X11 (the graphical subsystem) rebuilding a font cache.

Adding Beatmaps

Original post
For a picture guide, press the Original post link above.
  • Right-click osu!.app and select "Show Package Contents"
    • If you are moving only one .osz file, drag that directly to osu!.app icon. The map will be extracted.
  • Navigate to "Contents/Resources/winePrefix/drive_c/osu/Songs"
  • Drag your .osz (or .zip) files to the "Songs" file
  • Open your osu!.app and go to song selection or hit "F5".
    • Importing songs may get stuck. If this happens, try "ALT-F4" or "ESC" mashing, or quit osu! and run it again.


  • This build will always start the updater when you run it. It will update to newer releases and therefore when the remaining issues are fixed you will automatically receive the fixes.
  • You can make a shortcut to the songs folder on your desktop by dragging the folder while holding command and option. This should make it easier to load new maps.

Linux (using Wine)

Linux (using Wine)
This tutorial may not be up to date! Check out the last pages of this thread in the forums
to find a way provided by the community to install the newest versions of osu!.

How to install

1. Basic setup.

  • First, check your Graphic Card.
    • For best results, get a nVIDIA-Chipset.
    • On Intel graphic cards, you need to enable Vsync.
    • On AMD HD**** cards you need to disable the shaders.
  • Install "Wine". (If you didn't already)

2. Getting Wine to work.

  • For Ubuntu/GNU/LINUX Debian, just do:
    • sudo apt-get -y install wine
  • For Gentoo / Sabayon do:
    • sudo emerge wine
  • For Fedora do:
    • sudo dnf install wine
  • For any other OS read the install-manual of the system.
  • Create a 32 bit wine prefix
    • mkdir ~/.wine-osu
    • cd ~/.wine-osu
    • export WINEPREFIX=~/.wine-osu WINEARCH=win32
    • winecfg

Please keep in mind that each time you will want to launch/install osu! or configure this wine prefix, the WINEARCH and WINEPREFIX environment variables must be set as written above (even for the application launcher)

3. Getting osu! to work.

  • You will need to use winetricks...
    • As normal user,
      • winetricks install dotnet20 ie7
  • Next, download the latest osu! Windows installer and launch it.
  • Install osu!
  • Launch osu!

Adding Beatmaps

  • Drag and drop the .osz file from a file manager to an osu! window.

Android devices

osu!droid (unofficial)

osu!droid (unofficial, created by Pesets and neico)
How to install (Phone way)
Original Post
  • You have 2 choices. Pick either one.
  • Allow osu!droid.apk to install.
  • osu!droid is now installed in your phone.

How to install (USB way)

  • Use this download link (osu!droid.apk ver. 1.5.5)
  • Download the .apk file from your computer.
  • Transfer the .apk file to your phone using the suitable USB cable (Bluetooth is possible but using USB is much more efficient).
    • Please set your device to USB connection mode first. (Depending on your device)
  • Find and open the .apk file from your device.
  • Allow osu!droid.apk to install.
  • osu!droid is now installed in your phone.

Adding Beatmaps

Note: Picture guide is also included in the Original post above

Smartphone way

  • Open your browser and login at osu.ppy.sh
    • Important: Not all web browsers can download beatmaps from osu.ppy.sh. Please use Opera Mobile or Firefox.
  • Select your desired beatmap for downloading
  • Change the download directory to "/mnt/sdcard/osu!droid/" (This directory is default)
  • Wait until the beatmap is downloaded.
  • The beatmap will be imported automatically at the next launch of osu!droid

USB way

  • Connect your device to PC with USB cable
  • The location you should put in now depends on what type the file is.
    • If you have .osz or .zip files, copy them into your device's osu!droid directory.
    • If you have unpacked songs (i.e. in folders), copy them into osu!droid/Songs directory.
      • Directory will vary if you did modify it in Advanced Option. You need to put in that directory you set instead.
  • Plug off your device and launch osu!droid

T-Aiko [Taiko] (unofficial)

T-Aiko (unofficial, created by Guy-kun)
How to install (Phone way)
Original Post

Adding Beatmaps

Smartphone way

  • Get connected to the internet.
  • Open T-Aiko and press "Get Maps"
    • If the "Get Maps" is grayed out, it means you are not connected to the internet.
  • Pick your song of choice to download. (The file will go to the songs directory that is set by you or by default)
  • Wait for it. You can continue searching or leave after the downloading is completed.
  • Press "Play" from your main menu and the beatmap can be played.

USB way

  • Connect your device to PC with USB cable
  • The location you should put in now depends on what type the file is.
    • If you have .osz or .zip files, copy them into your device's T-Aiko directory.
    • If you have unpacked songs (i.e. in folders), copy them into T-Aiko/Songs directory.
      • Directory will vary if you did modify it in Advanced Option. You need to put in that directory you set instead.
  • Plug off your device and launch T-Aiko

iOS devices

osu! iPhone (unofficial)

osu! iPhone (unofficial, created by nuudles)
How to install
  • Follow this link to find a step-by-step tutorial on how to install osu! iPhone on a jailbroken iOS 7.0.4 device.


How to install
Warning: osu!stream is *NOT* osu!.
It is another game quite similar to osu! but that has its own features and rankings.

iDevice's App Store method (Suggested)

Make sure your iDevice can connect to the Internet (either by Wi-Fi or 3G/4G). 
  • Go to "App Store" from your iDevice
  • Search for osu!stream
  • Press and install osu!stream
    • If you are prompted to key-in your Apple ID and the password, please do so.
  • osu!stream can be played after the download and auto-installation is completed.
    • It is suggested you read "Adding Beatmaps" section too to ensure you get the latest free songs pack. Your download contains only 2 songs.

USB method

Your computer must have iTunes installed.
  • Go to this link and download it
    • If they request for Apple ID, key-in your Apple ID and the password.
  • Plug-in your iDevice (that has osu!stream) to your computer
  • Transfer the osu!stream files using iTunes
  • Unplug your iDevice and osu!stream can be played.

Adding Beatmaps

Make sure your iDevice can connect to the Internet (either by Wi-Fi or 3G/4G).
  • Open osu!stream.
  • Press the osu! symbol and you should be directed to the main menu (or tutorial if this is your first time)
  • Press the "Store" bar
    • You can also head to "Play" and press "Download more songs!"
  • Select your desired pack.
    • It is suggested you download packs that do not cost you money first. Free packs have "FREE" tag instead of the "USD$" cost tag.

FAQ and troubleshooting


  • I try to run osu! and get an 'Initialization Error'
  • Why can't I download from the Beatmap listing?
    • You need to register for the site first. Registration is free and very quick, and as well as giving you the benefit of accessing beatmap downloads, it also allows you to obtain a ranking on the online leaderboards and chat to other players in-game. So there's no excuse not to sign up!
  • I can't play the Beatmap I downloaded!
    • Your file is incomplete/corrupted. Did you just cancel the download half-way? If so, search back that song name and download it again and stay till the song has completed it's download properly.
      • osu! will put the incomplete/corrupted song under "Failed" folder in "Songs" folder file.
  • Something else going wrong?
    • If you come across a bug or error not listed above, check out the Bug Reports forum and post there (searching through existing threads first is highly recommended). Someone will definitely be around to help. Just make sure you speak your points clearly and provide a proof to back-up your points (like a screenshot, video, and/or the steps to reproduce).
    • Also, please consider using the osu! IRC channel if you are bit skeptical to post at Bug Reports section.


  • What versions of Android OS are supported?
    • All versions since 1.6 (Donut).
  • Will you support storyboard/video?
    • No.
  • Will you make a <feature name>?


  • I can't play on my Android phone!
    • Do you happen to be using a Motorola smartphone? There seems to be a bug in Motorola Android firmware that causes the game to crash when pressing play without even letting you send an error report. The only recommendation to-do is to install a (Stock) Google ROM.
    • If you discover any (bugs/problems), please post at this forum post complete with what smartphone you are using and the steps to reproduce the problem.

External links

  • peppy's FAQ [1]
  • peppy's download page [2]
  • peppy's osu! (OS X) testing release [3]
  • mattyu007's How to Run osu! on Your Mac without using Boot Camp [4]
  • KcLKcL's Solution: Running Osu! In Ubuntu or Xubuntu [5]
  • doomed151's General Information and Download (osu!droid) [6]
    • Pesets's osu!droid Changelog [7]
    • osu!droid Google Play page [8]
  • Guy-kun's T-Aiko! for Android (Market Release!) [9]
    • T-Aiko Google Play page [10]
  • peppy's osu!stream official page [11]
    • osu!stream App Store page [12]

List of Guides in osu!
FAQ/Ranking Guidelines
General Mapping Guides What is a beatmap? How do I beatmap? How do beatmaps get ranked? Difficulty appropriate gameplay elements How to time songs Song Setup Mapping Taiko Difficulties Fitting the Size-limit
Modding Aides AIBat
Mapping Techniques Mapping Techniques Making Good Sliders How to do 15° Patterns
Modding Info How do I mod?
Skinning/Hitsound Guides

Cropping with Complex Backgrounds Cropping with Simple Backgrounds Making Properly Centered Spinners What are Custom Sample Overrides? Custom Hitsound Library Adding custom hitsounds

Storyboarding Guides Storyboard Scripting Storyboard Scripting (Cheat Sheet) SGL Tool Reducing SB Load
Audio Editing Guides Audio editing Basic MP3 modifications Getting songs from Video Games
Video Editing Guides Compressing Videos Videos from YouTube
Gameplay Guides Play Styles How to increase your rank Making nice recording for Youtube Live streaming osu! How do I use the Chat Console?
Common Mistakes Changing the Map's Artist or Title
osu!forums Guides BBCode Starting a Beatmap Project How to not Embarrass Yourself in the Projects Subforum How to not Embarrass Yourself in the Modding Queues Subforum
Miscellaneous BanchoBot Changing Title Text Music Theory Setting the Offset on the Correct Beat Collab Information Shortcut Key Reference GL Support Issues What is Internet Relay Chat? How to Run osu! on Your Mac without using Boot Camp

Contents of
Getting Started Registration Installation Newbie's guide Game Interface Options Hit Objects
osu! Game Styles Basic explanation Multi-play
External ports » osu!stream osu!droid opsu! osu!wp T-Aiko Beats
External clients » osu!tourney osu!MapDownloader
World of osu!
Miscellaneous » Mascots osu!academy osu!talk
Beatmap Editor Compose / Design (Scripting) / Timing / Song Setup

Beatmapping Beat Snap Divisor / Distance Snap Custom Sample Overrides Kiai Time Mapping Techniques Skinning Skin.ini Storyboarding

Online Editing
and Ranking
Beatmap forum Submission Beatmap Approval (How to Get Your Map Ranked) Modding (Getting Your Map Modded) Music Theory Audio Editing Kudosu / Star Priority
People The Team Administrators/Global Moderation Team Quality Assurance Team Beatmap Nomination Group Language Moderators osu! Alumni Support Team Community Contributors List of notable people