Installation

Desktop port

Linux

Arch Linux

There are opsu and opsu-git available in the AUR (Arch User Repository).

This build uses XDG so the config and the log files are in $XDG_CONFIG_HOME/opsu. The other user directories and files can be found in $XDG_DATA_HOME/opsu.

General

Download the latest opsu-${version}.jar from the opsu! homepage and start the game with java -jar opsu-${version}.jar. This build is self contained so it will dump all the files in the working directory and create a bunch of new folders there.

Build manually (not recommended for non-developers)

See Building for further information.

Windows

• Download and install osu! (Ignore if already have osu!).
  • opsu!-{version}.jar operate using osu! resources.
• Visit opsu! homepage.
• Click on Desktop Releases at the right of the screen to download.
  • Because of the nature of opsu! as a Java program, the browser will alert about the security issue. Allow the download.
  • Alternatively, for older version, go to opsu! releases and pick a version.
• Operate opsu!-{version}.jar anywhere.
  • Unless osu! files were put 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 osu! in G:\(directory name), then put opsu!.jar into osu! folder located in G:\)(Please notice that opsu! will NOT work if the path contains "!").
• opsu! will operate in the Desktop as a Java program.

Android's port

How to install (PC way)

• Visit opsu! homepage.
• Tap on the Android release button.
  • Alternatively, for older version, go to opsu! releases and pick a version.
• Wait for download to complete
• Transfer the .apk file to the device using the suitable USB cable (Bluetooth is possible but using USB is much more efficient).
  • Please set the device to USB connection mode first depending on device requirement.
• Find and open the .apk file from the device.
• Allow opsu!-android{releasenum}.apk to install.
  • If the phone alerts about the security issue, disable the Unknown source button. It can re-enabled later anyway in Settings.
• opsu! is now installed in the phone.

How to install (Device way)

• Visit opsu! homepage.
• Tap on the Android release button and download it.
• Wait for download to complete and allow opsu!-android{releasenum}.apk to install.
  • If the phone alerts about the security issue, disable the Unknown source button. It can re-enabled later anyway in Settings.
• opsu! is now installed in the phone.