To download osu beatmaps, you need to grab the `.osz` file from the official osu! website or use the in-game osu! Direct tab, then import it into your game client. The quickest method is to download the beatmap file and double-click it on Windows, or use the osu!macOS Agent on a Mac, to have it automatically appear in your song list.
How to download osu beatmaps from the website
Your journey to download osu beatmaps starts on the official osu! website. First, you'll need to create an account, this is free and only takes a couple of minutes. Head to osu.ppy.sh and click the "Register" button. Fill in your desired username, a valid email address, and a strong password. After completing the quick verification and accepting the terms, you'll receive a confirmation email. Click the link inside it to activate your account, and you're ready to browse.
Once logged in, navigate to the "Beatmaps" section from the top navigation bar. You can search for specific songs, artists, or difficulty levels using the search bar, or filter by genre, length, and other criteria. Each beatmap listing shows the song title, artist, creator, and available difficulty levels, along with user ratings and comments to help you pick a quality map. When you find one you like, click on it to see more details, then hit the "Download" button. The beatmap file will be saved to your computer as an `.osz` file, this single file contains the song, timing data, and all hit objects needed to play the level.
How to install osu beatmaps on Windows
Installing a downloaded beatmap on Windows is as simple as double-clicking the `.osz` file. Your osu! game client should be closed or running, either way, double-clicking the file will trigger the import process automatically. The game will extract the beatmap into its Songs folder and add it to your library. If you have the game open, you might need to press F5 to refresh the song list so the new beatmap appears. This refresh action is also useful if you've manually moved files into the Songs folder or if a beatmap doesn't show up immediately after import.
If double-clicking doesn't work (for example, if file associations are broken), you can manually import by opening osu!, going to the "Beatmap Listing" section, and clicking the "Import" button. Browse to the location of your `.osz` file, select it, and confirm. The beatmap will be installed and appear in your list. Repeat this for each downloaded file, and you'll quickly build a diverse collection.
How to install osu beatmaps on macOS
macOS users have a few reliable options to install osu beatmaps, and the easiest is using the osu!macOS Agent. This small utility automates the import process. First, open osu!macOS Agent and go to the "General" tab. In the "Location:" field, make sure it points to your osu! install folder (e.g., /Users/Adrian/Desktop/osu!.app). Then, enable the checkbox labeled "Automatically move beatmaps from Downloads". Leave the agent running in the background. The next time you download a beatmap from the osu! website, the agent will automatically move the `.osz` file into your osu! wrapper. After that, hit F5 in-game to refresh the beatmap list and see your new map.
If you prefer not to use the agent, you can try the drag-and-drop method. Simply drag the `.osz` file directly into the osu! game window. This has been reported to work with Technocoder's Wineskin on macOS Catalina 10.15. If osu! is in full screen, use Mission Control (press the F4 key) to switch to your desktop and drag the file onto the game window. For a more manual approach, right-click on osu!.app and select "Show Package Contents". Navigate to drive_c/osu!/Songs and drag your downloaded `.osz` file into that folder. You can create an alias or shortcut to this Songs directory for quicker access in the future, just drag the folder to your desktop or sidebar while holding Option+Command. Once the file is in the Songs folder, refresh with F5 in-game to load it.
Downloading beatmaps in-game with osu! Direct
For a streamlined experience, the osu! Direct tab inside the game client lets you download beatmaps without leaving osu!. This feature requires an active osu! Supporter subscription, a paid status that also grants other perks like exclusive cosmetics and priority access to new content. To use it, launch osu! and click the "Direct" tab in the main menu. You'll see a list of recently ranked and popular beatmaps, plus a search bar to filter by title, artist, or difficulty. Click any beatmap to preview it and see its details, then hit the "Download" button. The beatmap will download and automatically install into your game, no manual file handling needed. After the download finishes, the beatmap appears in your song list, ready to play. This method is especially convenient for quickly grabbing new maps without switching to a browser.
What are osu beatmaps?
Beatmaps are community-created levels that define how a song plays in osu!, and they are the core of the game's endless replayability. Each beatmap contains the song file, timing data, and a layout of hit objects (hit circles, sliders, and spinners) that you must interact with in rhythm. These maps are made by players and shared on the osu! website, covering a huge range of music genres and difficulty levels, from beginner-friendly to expert challenges. osu! supports four distinct game modes: osu!standard (clicking circles and following sliders), Taiko (drumming in time), Catch the Beat (catching falling fruits), and osu!mania (keyboard-based note hitting). Each mode interprets the same beatmap data differently, giving you four unique ways to enjoy the same song. Whether you're a casual listener or a competitive score chaser, the vast library of beatmaps ensures there's always something new to try.
