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
opsu! logo



opsu! is an unofficial open-source client for osu! created by Jeffrey "euphyy" Han (@itdelatrisu), a rhythm game based on popular commercial games such as Ouendan and Elite Beat Agents. It is written in Java using Slick2D and LWJGL, wrappers around the OpenGL and OpenAL libraries.

opsu! runs on Windows, OS X, and Linux platforms. A libGDX port by fluddokt additionally supports Android devices.


Please refer to the official website release notes (itdelatrisu).
Alternatively, Android's port official website release notes (fluddokt).


Desktop port

  • Download and install osu! (Ignore if you already have osu!).
    • opsu!-{version}.jar operate using osu! resources.
  • Visit https://itdelatrisu.github.io/opsu/ .
  • Click on Desktop Releases at the right of the screen to download.
    • Because of the nature of opsu! as a Java program, your browser will alert you about the security issue. Allow the download.
    • Alternatively, if you want older version, go to https://github.com/itdelatrisu/opsu/releases/ and pick your version.
  • Operate opsu!-{version}.jar anywhere.
    • Unless you put osu! files somewhere else other than the default directory, then:
      • Set the paths manually in the configuration file (.opsu.cfg, generated when the program starts), or
      • Run opsu! from the working directory (If you put osu! in G:\(directory name), then put opsu!.jar into osu! folder located in G:\ you specified).
  • opsu! will operate in your Desktop as a Java program.

Android's port

How to install (PC way)

  • Visit https://itdelatrisu.github.io/opsu/ .
  • Tap on the "Android release" button.
  • Wait for download to complete
  • Transfer the .apk file to your device 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 "opsu!-android{releasenum}.apk" to install.
    • If your phone alerts you about the security issue, disable the "Unknown source button". You can re-enable it later anyway in Settings.
  • opsu! is now installed in your phone.

How to install (Device way)

  • Visit https://itdelatrisu.github.io/opsu/ .
  • Tap on the "Android release" button.
  • Wait for download to complete and allow "opsu!-android{releasenum}.apk" to install.
    • If your phone alerts you about the security issue, disable the "Unknown source button". You can re-enable it later anyway in Settings.
  • opsu! is now installed in your phone.

Adding Beatmaps

Note: Only beatmaps downloaded from bloodcat's osu! server and/or from the "osu!MapDownloader" app below can play the current beatmap version without crashing.
Note2: These methods will be focusing on the Android devices. The method is the same for Desktop players as it operate on your osu! folder.

opsu! Direct Download (Recommended)

  • Launch opsu!
  • Click "Downloads" at the right of the screen. You should be directed to a page similar to osu!direct.
  • Pick or search the beatmap(s) you want to download.
    • Double-tap the song's tab to initiate the download.
  • Wait for the download to complete
  • Import the beatmap by selecting "Import All"
  • You can now play the beatmap(s) you have downloaded.

osu!MapDownloader app way (Android only)

  • Download and Install the app @Play Store (2.3MB)
  • Open "osu!MapDownloader"
  • Open the settings menu of "osu!MapDownloader"
    • Depending on your device, long press the right button may open the settings menu of the app.
  • Modify the "Select download folder" to the opsu!'s "Songs" folder.
    • "osu!MapDownloader" will automatically unzip the .osz file for you.
  • Pick your beatmap(s) and download.
  • Open opsu! and enjoy.

P.S. It has many other uses other than downloading beatmaps for opsu!.

Online way

  • Open your preferred browser and go to http://bloodcat.com/osu/
  • Select your desired beatmap for downloading
  • Change the download directory to "(place you install opsu!)/opsu/SongPacks".
  • Wait until the beatmap is downloaded.
  • The beatmap can be imported at the next launch of opsu!

Obsolete method

PC way (Beatmaps not from bloodcat's website may cause crashes)

  • 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 opsu/SongPacks directory.
    • If you have unpacked songs (i.e. in folders), copy them into opsu/Songs directory.
  • Disconnect your device and launch opsu!


What is the difference?

  • Some slidertypes may not have support yet.
  • Free access to psudeo-osu!direct to bloodcat's website.
  • Dynamic Main Menu background based on the current song's background (Can be disabled).
  • You'll likely need to change the "Music Offset" value if hit objects are out of sync.

For Android players

Note: For comparison, osu!droid will be used as an unwilling participant.

  • opsu! is more faithful to osu! as a clone compared to osu!droid.
    • opsu! Desktop is same as opsu! Android.
  • Hit objects in opsu! follows as per osu! Standard unlike osu!droid that resize the Hit objects larger than usual.
    • opsu! is geared toward pen play rather than osu!droid's focus on freehand play.
  • opsu! follows the elegance of osu! Interface rather than osu!droid's resized larger Interface.
    • If you have a small screen (4-inch and below) or having difficulty reading the user interface, you can modify in the options screen under Extras;Scale certain UI elements.
    • In doubt, use the left side of the screen for scrolling.
      • Absolute Scrolling (right-click to speedscroll the scrollbar exactly to your cursor location by top-down distance) is disabled here.
  • opsu! has about the same amount of Game Modifiers (in-progress) to osu! compared to osu!droid's limited Game Modifiers.
  • opsu! is less prone to crashing than osu!droid (crashes immediately if there is a beatmap it cannot read).


Options screen

You can find it in Song Selection screen under "Other Options" (look below of the screen with four row of buttons and a back button; the rightmost button is "Other Options").

Slide left/right on the tab to decrease/increase the value respectively. Please slide responsibly as the android port is very touch-sensitive.

Skin Restart to apply skin change. Click to change to next skin Default skin is called "Default"
Show FPS Counter Show an FPS counter in the bottom-right hand corner. Yes/No
Prefer Non-English Metadata Where available, song titles will be shown in their native language.
Enable Dynamic Backgrounds The song background will be used as the main menu background.
Load HD Images Load HD (@2x) images when available. Increases memory usage and loading times.
Show Detailed Loading Progress Display more specific loading information in the splash screen.
Master Volume Global volume level. 0% - 100%
Music Volume Volume of music.
Effect Volume Volume of menu and game sounds
Hit Sound Volume Volume of hit sounds
Music Offset Adjust this value if hit objects are out of sync. +/-###ms
Disable All Sound Effects May resolve Linux sound driver issues. Requires a restart. Yes/No
Enable Theme Song Whether to play the theme song upon starting opsu!
Background Dim Percentage of dim the background image during gameplay 0% - 100%
Force Default Playfield Use own skin's playfield. Yes/No
Ignore All Beatmap Skins Ignore Beatmaps' Skins.
Snaking sliders Sliders gradually snake out from their starting point.
Show Hit Lighting Adds an effect behind hit explosions.
Show Combo Bursts A character image is displayed at combo milestones.
Show Perfect Hits Whether to show perfect hit result bursts (300s, slider ticks).
Show Follow Points Whether to show follow points between hit objects.
Show Hit Error Bar Shows precisely how accurate you were with each hit.
Left Game Key Tap to change Click any key in keyboard to change the key. Default: Z PC only. Does not work on Android port.
Right Game Key Tap to change Click any key in keyboard to change the key. Default: X
Disable mouse wheel in play mode During play, you can use the mouse wheel to adjust the volume and pause the game.
This will disable that functionality.
Disable mouse buttons in play mode This option will disable all mouse buttons.
Specifically for people who use their keyboard to click.
Cursor Size Change the cursor scale 0.50x - 2.00x
Enable New Cursor Use the new cursor style (may cause higher CPU usage). Yes/No
Disable Cursor Hide the cursor sprite
Fixed Circle Size (CS) Force the size of circles and sliders Disabled - 10.0
Fixed HP Drain Rate (HP) Force rate of health loss
Fixed Approach Rate (AR) Force display length of hit objects
Fixed Overall Difficulty (OD) Force time window judgement
Track Checkpoint (Apply to desktop port only) Press Ctrl+L while playing to load a checkpoint, and Ctrl+S to set one. Slide to change the timing PC only. Does not work on Android port.
Replay Seeking Enable a seeking bar on the left side of the screen during replays. Yes/No
Scales certain UI elements Scales aesthetics UI elements except Hit Objects and the playfield. Restart required. 0.2 - 3.0
Default: 2.0
0.2 (left) and 3.0 (right) scaling.
In-game pause button Shows an in-game pause button {located at lower-right of the screen} Yes/No
Enable New Slider Use the new Slider style.
Slider Quality Lower value for better looking sliders Selection switch start from top to bottom, then back to top again.
  1. Best
  2. Good
  3. Ok
  4. Meh
  5. Bad
  6. Terrible
  7. Horrible
Old Sliders only


  • Unless stated, the options apply immediately after modification.
    • Restart = CTRL + SHIFT + F5 (PC only). For Android, close and open opsu! after applying the change.

How to install skins


  • opsu! does not have a skin selector (yet). Therefore, if you want to use a skin, you must manually open your selected skin folder and move all the files into "(place you install opsu!)/opsu/Skin/"
    • It is not suggested to modify the filepath.

What elements to remove

  • Any .zip or folder contents in the skin. (To save space)
  • Taiko, Catch the Beat, and osu!mania skinning elements (if exist).


Is there a beatmap specially made for opsu!?

  • Any beatmap that is made for original osu! is also made for opsu!. There are no beatmaps created specifically for opsu!.

I have many beatmaps in T-Aiko/osu!droid...

  • Cut and Paste all the beatmaps to opsu/Songs manually using your device's File Explorer.
    • (Unconfirmed) T-Aiko/osu!droid is/are unable to use "mnt/sdcard/opsu/Songs" directory for some reason (It will crash [osu!droid] or gives unknown error [T-Aiko]). You may require to create a backup in T-Aiko!/Songs if you plan to delete osu!droid.

Why is the default skin different?

Should I remove osu!droid?

  • Depends on your preference. osu!droid was specifically made for Android landscape in mind. Moreover, osu!droid(6.40MB as in ver. 1.5.10) is lighter than opsu!(22.23MB as in ver. 0.12.1a). If you are going to miss the simplicity and lightweight mass, keep it as an alternative. Otherwise (especially if it keep crashing), transport your beatmaps to opsu! and uninstall osu!droid.


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