adding beatmaps - itdelatrisu/opsu GitHub Wiki

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 through the available download servers. More information can be found down below.

Desktop

opsu! will refer to an existing installation of osu! for beatmaps. If an existing installation is not found, beatmaps will be loaded from (opsu! install dir)/Songs

opsu! Direct Download will be opened when there are no beatmaps present on both directories.

Additionally, manually downloaded beatmaps can be placed in the Import/ directory for opsu! to unpack them automatically.

Android (Mobile)

opsu! Direct Download (Recommended)

Also applies for Desktop releases of opsu!

  • Launch opsu!
  • Click Downloads at the right of the screen. A page similar to osu!direct would be opened.
  • Pick or search the beatmap(s) to download.
    • Double-tap the song's tab to initiate the download.
    • Online connection is required to use the service
    • Select a download server, available servers are listed in Download Servers
  • Wait for the download to complete
  • Import the beatmap(s) by selecting Import All
  • Beatmap(s) downloaded can now be played in opsu!.

Browser download

Also applies to the Desktop releases of opsu!

  • Open a browser and go to Bloodcat.
  • Select beatmap for downloading
  • Change the download directory to (opsu! install location)/opsu/Import.
  • Wait until the beatmap download on the browser is completed.
  • The beatmap can be imported at the next launch of opsu!

From PC

  • Connect device to PC with USB cable
  • The location to put in depends on what type the file is.
    • If .osz or .zip files, copy them into the device's opsu/Import directory.
    • If unpacked songs (i.e. in folders), copy them into opsu/Songs directory.
  • Disconnect device and launch opsu!

Download Servers

opsu! supports direct downloading from these servers:

Available download servers:

⚠️ **GitHub.com Fallback** ⚠️