Gaming · osu! on macOS

Use Custom Hitsounds in osu! on a Mac

Source-checked 2 September 2026About 10 minutes

Answer

Put custom hitsound audio in a copy of the skin you use, name each file with osu!'s expected hitsound name, then select that skin and enable its sounds. Use short WAV or OGG files from a source you may legally use. Keep the original skin so you can undo the change.

Before you continue

Copy the skinNever overwrite your only working version.
Use exact filenamesosu! loads hitsounds by name.
Test quietlyCustom files can have very different volume levels.

Read osu!'s skin guide Read the macOS client notes

Choose and copy the skin

Open osu!'s skin folder, duplicate the active skin folder, and give the copy a new name such as `My Skin - custom sounds`.

Prepare legal audio files

Use short, clean WAV or OGG samples you created or have permission to use. Normalize volume conservatively to protect hearing.

Match osu! filenames

Rename each file for the event it replaces, such as the appropriate `normal-hitnormal`, `normal-hitclap`, `normal-hitfinish`, or `normal-hitwhistle` name.

Place files in the copied skin

Put the renamed files beside that copy's `skin.ini`. Replace files only inside the copy.

Select the copied skin

Open osu!, choose the copied skin in Options, and make sure the option to use the skin's sound samples is enabled.

Test in a simple beatmap

Lower volume first, play a short familiar map, and check normal, clap, finish, and whistle sounds separately.

Undo safely

If anything is missing or too loud, switch back to the original skin, fix one file, and test again.

If it does not work

If no custom sounds play, confirm the filenames have no extra extension such as `.wav.wav`.
If only some notes change, the beatmap may supply its own samples or use a different sample set.
If the older Mac app cannot find the skin folder, read osu!'s macOS page because its data can live inside `osu!.app`.

Sources and verification

Checked against official documentation on 2 September 2026. Scope: osu! on macOS.

The written instructions were checked against the current official pages linked below. The older video is kept for reference and may show different menus.