Importing beatmaps and skins¶

This article is applicable to the post-obit wrappers:

Note

osu!macOS Agent can automatically movement beatmaps and skins from your Downloads folder. Just brand sure to enable the checkboxes inside osu!macOS Agent settings. More information available below.

Importing beatmaps and skins¶

Importing beatmaps into osu! is quite easy, and at that place's a number of ways you can go this to work with your osu! Wineskin.

Using osu!macOS Agent¶

You can have beatmaps automatically moved from your Downloads folder to osu!, with the help of Technocoder's osu!macOS Agent program. To enable this:

  1. Open up osu!macOS Agent

  2. In the General tab, locate the Location: field. Brand sure this points to your osu! install (east.thou /Users/Adrian/Desktop/osu!.app )

  3. Enable the post-obit checkboxes

    • Automatically motion beatmaps from Downloads

    • Automatically movement skins from Downloads

You can also enable

  • Automatically open up replays from Downloads

  1. Leave osu!macOS Agent running. The next time yous download a beatmap from the osu! website, it should automatically move to your osu! wrapper. So merely hit F5 (beatmaps) or Ctrl-Alt-Shift-S (skins) to refresh.

Drag and drop¶

Yous might also be able to drag and drop beatmaps and skins into osu! directly. In my personal experience this only works with Technocoder'due south Wineskin with macOS Catalina ten.15 support.

If osu! is full screen, you tin can use Mission Control (F4 key) to switch between windows.

Click to import¶

You tin ready osu! to automatically open and import a beatmap or skin when yous click on it in your Downloads folder or web browser.

  1. Download a random osu beatmap or skin (and get the osz file)

  2. Right click on osu!.app

  3. Click Show Package Contents

  4. Navigate to drive_c/osu!/Songs and drag & drib your osz or osk beatmap into in that location

  5. Go back a few folders until you achieve Wineskin.app, and click to pen it!

  6. Click Advanced. You should see a screen like the 1 below

Wineskin options showing Associated Extensions.

Note the Associated Extensions section. If the osz2 , osr , osz and osu extensions aren't in that location, add them using the + push button.

To verify that this has all been gear up up correctly:

  1. Click Tools, and then click Command Line (cmd). A console-like should open up (it takes a while tho)

  2. Type explorer.exe

  3. Navigate to My Computer\osu!\Songs in the window that appears and locate the osz beatmap you just dropped

  4. Correct click on the file, click Properties and verify it worked. It should look like the epitome below.

Wine Explorer showing Properties for osz extensions.

Notation

This method tends to be more unreliable than the others listed and you may feel varying degrees of success.

Manual import¶

To manually import a beatmap into osu!, follow the following instructions:

  1. Detect your Songs directory

    • Locate where osu!.app (your Wineskin) is installed

    • Right click on it and select Show Bundle Contents

    • You should now see three files/folders: Contents , drive_c and Wineskin . Click drive_c .

    • From here, click osu! .

    • From hither, locate Songs

Tip

You can create an alias or shortcut pointed to your Songs directory, in somewhere handy like your Desktop. Then you can rapidly access the folder whenever yous want to drop beatmaps in.

To create an alias, click on the Songs binder, and then go to File > Make Alias - then put this alias somewhere where you can easly access it.

  1. Discover a beatmap on osu.ppy.sh. For this example, we'll use Ryofuka's crossing field.

  2. Just like you would normally, click the Download button to download the beatmap.

  3. Yous should now accept a .osz file in your Downloads file. Drag and driblet this file into the Songs directory nosotros located before.

Dragging and dropping a beatmap into the Songs directory.

Tip

To avoid potential import problems, remove any not-alphabetical characters (numbers and hyphens are fine)

Annotation

Aye, my beatmap folder is very empty (but yours won't exist! Unless information technology is, of form..)

  1. If you don't accept osu! open already, open it now. Then in-game, press F5

Note

Unless you have function keys enabled, you may need to press the Fn button at the aforementioned time.


Utilize F1, F2, etc. as standard function keys

  1. Locate where osu!.app is installed

  2. Right click on it and select Testify Packet Contents

  3. You lot should at present see three files/folders: Contents , drive_c and Wineskin . Click Wineskin

  4. A window like the one below should pop up. Click Advanced

Wineskin settings.

  1. Click the Options tab

  2. Select Apply F1, F2, etc. as standard function keys


Tip

You can practice all of this while leaving osu! running open in the groundwork!

A note virtually importing skins¶

Importing skins is largely the same process, except instead of the Songs directory, use the Skins directory, and to reload osu! use Ctrl-Alt-Shift-Due south instead of F5 .

You can then select your skin every bit normal from the osu! in-game settings carte du jour.

Annotation

Treat this as if yous were working on a Windows organization. If the pare is compressed, you lot'll probably need to uncompress it. You can use something like The Unarchiver or even your in-built Annal Utility to do this (though Archive Utility might not accept so much fun with .rar or .7zip files)

Encounter the osu! knowledge base for more info.