Importing beatmaps and skins¶

This article is applicable to the following wrappers:

Note

osu!macOS Agent can automatically move beatmaps and skins from your Downloads folder. Just make sure to enable the checkboxes inside osu!macOS Agent settings. More data available beneath.

Importing beatmaps and skins¶

Importing beatmaps into osu! is quite easy, and there's a number of means you can become this to piece of work with your osu! Wineskin.

Using osu!macOS Agent¶

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

  1. Open osu!macOS Amanuensis

  2. In the Full general tab, locate the Location: field. Brand sure this points to your osu! install (e.chiliad /Users/Adrian/Desktop/osu!.app )

  3. Enable the post-obit checkboxes

    • Automatically move beatmaps from Downloads

    • Automatically move skins from Downloads

Yous can also enable

  • Automatically open up replays from Downloads

  1. Leave osu!macOS Agent running. The side by side time you download a beatmap from the osu! website, it should automatically move to your osu! wrapper. And so just hit F5 (beatmaps) or Ctrl-Alt-Shift-S (skins) to refresh.

Elevate and drop¶

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

If osu! is full screen, yous can use Mission Command (F4 key) to switch betwixt windows.

Click to import¶

You tin can set osu! to automatically open and import a beatmap or pare when yous click on it in your Downloads binder or web browser.

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

  2. Right click on osu!.app

  3. Click Testify Package Contents

  4. Navigate to drive_c/osu!/Songs and drag & driblet your osz or osk beatmap into there

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

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

Wineskin options showing Associated Extensions.

Annotation the Associated Extensions section. If the osz2 , osr , osz and osu extensions aren't there, add them using the + button.

To verify that this has all been set up correctly:

  1. Click Tools, then click Control Line (cmd). A panel-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 Backdrop and verify it worked. Information technology should look similar the epitome below.

Wine Explorer showing Properties for osz extensions.

Note

This method tends to exist more than unreliable than the others listed and y'all may experience varying degrees of success.

Manual import¶

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

  1. Observe your Songs directory

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

    • Correct click on it and select Show Bundle Contents

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

    • From hither, click osu! .

    • From hither, locate Songs

Tip

You tin create an alias or shortcut pointed to your Songs directory, in somewhere handy like your Desktop. So you can apace admission the binder whenever you desire to driblet beatmaps in.

To create an alias, click on the Songs folder, then go to File > Make Allonym - then put this alias somewhere where you tin easly access it.

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

  2. Just like you would commonly, click the Download push to download the beatmap.

  3. You lot should at present have a .osz file in your Downloads file. Drag and drop this file into the Songs directory nosotros located before.

Dragging and dropping a beatmap into the Songs directory.

Tip

To avoid potential import issues, remove whatever non-alphabetical characters (numbers and hyphens are fine)

Note

Yeah, my beatmap folder is very empty (but yours won't be! Unless information technology is, of course..)

  1. If you don't accept osu! open already, open up information technology at present. Then in-game, press F5

Note

Unless you take function keys enabled, you lot may need to press the Fn button at the same time.


Use F1, F2, etc. as standard function keys

  1. Locate where osu!.app is installed

  2. Correct click on information technology and select Show Package Contents

  3. Yous should now see 3 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 Use F1, F2, etc. every bit standard function keys


Tip

You lot can do all of this while leaving osu! running open in the background!

A notation nigh importing skins¶

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

You can so select your skin as normal from the osu! in-game settings card.

Note

Treat this as if you were working on a Windows organization. If the skin is compressed, you lot'll probably demand to uncompress information technology. You can use something similar The Unarchiver or even your in-built Archive Utility to exercise this (though Archive Utility might not have so much fun with .rar or .7zip files)

See the osu! knowledge base of operations for more info.