docs

Features & Guide

Kuroosu Launcher Our Windows app: press PLAY to start osu! on Kuroosu (osu!stable or our lazer client), with your profile, rankings, news, Discord status, performance options and auto-updates. Search and download beatmaps right in the launcher (they go straight into osu!), and after playing you see a short summary of your session: plays, time, pp, rank and your best play. Supporters also see all their sessions with a week overview, download 10 maps at once instead of 3, and their name in their Supporter colour.
Download
Kuroosu lazer client Our own osu!lazer for Kuroosu – no lazer delay, no notelock, same account and leaderboards. In the launcher or as its own download (Windows installer, portable .zip or Linux AppImage).
Download
Beatmap packs Turn the maps in your osu! folder into a pack in the launcher, send the link or code to friends or publish it on the packs page. Opening a pack downloads all its maps in one go.
Packs
Kuroosu Overlay A free overlay for osu!stable on the download page: your pp with how much you can still get in this play, the pp of the selected map, your real tapping speed next to the song's BPM, keys per second and how long you hold every key, each press as a bar in its lane. Always on screen, with a settings window: any size from 25 to 300 %, drag it anywhere, your own colours, extras (accuracy, combo, 100/50/miss, unstable rate, stars, grade, song name, map progress), only pp, only keys, or no box at all so that just the numbers stay. Shows over osu! in borderless or windowed mode, or in OBS.
Download

Everything you can do on Kuroosu besides playing: your profile, titles, tournaments and more. New to the server? Start with Connect.

1Your profile

Rank graphYour rank over the last 90 days, updated every minute. Hover it to see your rank at every point.
Pinned scoresShow off your favourite plays: click the on any of your score cards (or "Pin to profile" on a score page). Up to 10 per mode, shown right at the top of your profile.
ScoresBest scores, last scores, first places, highest star pass, most played beatmaps and most watched replays – each with its own mode menu.
Your layoutPut the sections of your profile in the order you like: Settings → Profile → Profile layout (drag and drop).
Hover cardsHover any player name to see a little card with their rank, pp, level and banner.

2Champions & Hall of Fame

#1 / #2 / #3The top 3 of a leaderboard get a gold, silver or bronze rank card on their profile.
Ex ChampionHold #1 for at least 30 days in a row and you get the Ex-Champion badge on your profile for ever, even after someone takes your spot.
Which modesThe Ex-Champion badge only counts in modes with at least 5 ranked players.
Hall of FameHall of Fame: who held #1 the longest, the biggest plays of every mode, who reached 1k / 5k / 10k pp first, most #1s and top recruiters.

3Clans

ClansJoin a clan on Clans or create your own in Settings → Profile – it is free. The clan leaderboard ranks all clans by total pp, average pp, accuracy or ranked score and shows members and level. The clan picture and the small clan flag (shown next to your members on the leaderboard) are free too. A clan has 10 places; while its owner is a Supporter it has 50 and can set a big banner on the clan page. Nobody is removed when Supporter runs out, the clan just cannot take new members above 10.

4Tournaments

On Tourneys you sign up with one click. Tournaments are 1v1 with a mappool for every round and a bracket; staff enter the results and the winner moves on automatically. Some tournaments need the Verified badge (see Rules). The winner gets the Tournament Winner medal. Every tournament page shows who can join (some are only for a rank range), the prize, the rules, the time of every round and, once you are in, your next match with your opponent and the time.

5Beatmaps

Your own mapsMade a map yourself? Export it in the osu! editor (File → Export) and upload the .osz on Upload a beatmap (max 35 MB, no video). You see every difficulty with stars, length and BPM before it goes live. It is playable right away – in osu!direct and on the website – with a leaderboard but no pp. Staff checks it: Ranked gives pp to every score on it, Loved keeps the leaderboard, or you get a note what to fix and can upload a new version. Max 5 maps waiting at a time. All of them: Custom maps.
Submit a mapWant a map ranked, loved or unranked? Paste the link on Submit Map, pick the status and add a reason if needed. A nominator reviews it and you get a notification. Max 5 open submissions, one per map.
Friends tabOn every beatmap you can switch the leaderboard to Friends: you and the players you follow.
Song previewEvery beatmap page has a Preview button to listen to the song.
Your #1sWhen someone takes your #1 on a map, you get an in-game message and a notification.

6Chat with friends

Open Chat ( at the top) to write with your friends – everyone you follow or who follows you. It's the same chat as in-game: messages you send on the website arrive in osu!, and your in-game messages show up on the website. Send emojis, pictures (you see a preview first), react to messages with , see when your friend is typing and when they read your message, see who is on the website right now (blue dot; green means online in-game). Press Turn on desktop notifications in the chat or in Settings → Notifications once (there you also choose what you get: messages, notifications, sounds and pop-ups) to get messages and notifications on your PC even when the website is closed (your browser has to be running, e.g. in the background). Chats are not private: they aren't encrypted and our staff can read them to keep everyone safe.

Reply, edit, deletePoint at a message: answers exactly that message, lets you edit or delete your own messages, copy the text, pin a message to the top or report it.
CardsSend a link to a score, a map or a profile and it turns into a card with cover, pp and grade.
Challenge → Challenge sends one of your scores as “beat this”. You both get a notification when it is beaten.
Multiplayer invite → Multiplayer invite invites your friend to the lobby you are in right now, with a Join in osu! button.
Search, mute, blockSearch all your messages on the left, or one chat with at the top. There you also mute a chat (1 hour, 8 hours or until you turn it back on), block or report a player.
PicturesPaste pictures with Ctrl+V or drag them into the chat, several at once. Click a picture to see it big.
Now playingThe top of a chat shows what your friend is doing in osu! right now.
SupportersOwn colour for your messages, a background for the chat, pictures up to 15 MB, any emoji as a reaction – and your messages are never cleaned up.

60 days: to keep the server fast, messages are removed 60 days after they were sent. Messages written by supporters stay.

7Suggestions & bugs

Have an idea or found something broken? Open Suggestions & Bugs (menu Community or the box on the home page), pick Suggestion or Bug report, say where it happens (website, in-game, launcher, Discord), write a title and the details and add a screenshot if you like. Only you and the team can see it. Staff marks it as seen, planned / confirmed, added / fixed or declined and can answer you – you get a notification and see everything under Your messages on the same page. For bans and account problems please still open a ticket on Discord.

8Medals & notifications

MedalsKuroosu medals like First #1, Sniper, Champion, 10,000pp, Recruiter and Tournament Winner. You get a message when you unlock one. A new top play or a new #1 greets you with confetti on your profile.
The bellThe at the top shows new badges, medals, comments, reviewed map submissions, tournament news and more.

9Invite your friends

Get your own invite link in Settings → Invite friends. Everyone who signs up with it counts for you – invite 3 active players for the Recruiter medal and a spot on the Hall of Fame.

10News & stats

News shows newly ranked maps, big plays, tournaments, new champions. Server Stats shows players online, plays per day and the most played maps. All updates of the website are in the changelog.

Supporter Coloured names and name fonts, an animated banner on the leaderboards, 20 pinned scores and more – and you keep the server running.
See all perks
Questions, bugs or ideas? Open a ticket for questions and problems, report bugs in the bug report channel and post your ideas in the ideas channel.
Discord

11Reports and your account

StaffStaff never asks for your password.
Report a playerSaw a cheater, a multi-account or someone being toxic? Click Report on a score, or go to Report a player. Only you and the staff see it, and you get a notification when it is handled.
LanguageThe website is in English, German, Polish, Spanish, French, Italian, Portuguese, Russian, Turkish, Arabic, Hindi, Chinese, Japanese and Scottish Gaelic. It picks your browser's language; change it with the flag at the top.
Two-factor loginProtect your account with a code from an authenticator app (Google Authenticator, Authy, …): Settings → Security. Staff need it for the admin panel. After 5 wrong passwords the login pauses for 15 minutes.

12Tools

pp calculatorpp calculator (Beatmaps page, and on every beatmap page): pick a map, mods and accuracy – same pp as in the game. Logged in, it shows how much your profile would go up.
Share picturesSave as picture on every score makes a nice image for Discord or Instagram. Links to profiles and scores show this picture in Discord automatically.
Medal progressMedals you don't have yet show how far you are, for example 594/1,000 plays.
Your goalsLogged in, the home page shows how many pp you need for the next rank in your best mode, and the medal you are closest to.
Your modeThe leaderboard and the clan pages open in the mode you played most in the last 30 days. If you have not played yet, or are not logged in, they open in Relax. You can always pick another mode on the page.
First stepsNew players see a short checklist on the home page (first map, first pass, an A rank, follow a player, join a clan, first medal). It goes away once everything is done.

13Countries & clans

Relax, Autopilot, lazerShort pages for new players: Relax, Autopilot and osu!lazer on Kuroosu, with live numbers and the top players.
CountriesThe country leaderboard ranks countries by the pp of their players in every mode.
Clan levelClans collect XP from passed plays and new personal bests and level up. The clan page shows the level, the rank, the members, the latest plays and the clan's Discord.

14Supporter

PriceSupporter costs 1 € once and stays on your account for ever – no months, nothing runs out. Nothing in it gives pp or ranks.
How to payBy bank transfer (SEPA, in euro): pick Supporter or Plus on the supporter page, press "Get my payment code" and send the money with the code KU-… in the reference – scan the code with your banking app and everything is filled in. No fees, the full amount goes to the server. Supporter is handed out by hand once the money is in, after the transfer has arrived (1–3 working days) – so it can take a few days, and you get a notification. Want to gift it? Type the exact name of the other player.
Card, Apple Pay, Google PayPress "Card, Apple Pay, Google Pay" on the supporter page – you pay on a page of Stripe and Supporter is on your account a few seconds later, fully automatic. Paying by card costs a little more (Supporter 1.28 €, Plus 3.32 €) because of the card fee – by bank transfer it is 1 € and 3 €.
PayPalOpen a ticket on our Discord and say you want to pay with PayPal – we send you where to pay and hand out Supporter by hand once the money is in.
Supporter Plus3 € once, also for ever: everything from Supporter plus a name with a moving shine or rainbow, a Plus mark next to your heart, 30 pinned scores per mode and the Plus mark in the launcher. Already Supporter for ever? Then Plus costs only the difference (2 €).
HeartsEvery purchase is one heart next to your name (up to three). A gift counts as a heart for the one who pays. The latest purchases are shown on the home page.
InsightsSupporter Plus: Insights are your own statistics, only you see them – plays per day, your rank over 90 days, the hours you play most and with the best accuracy, favourite mappers, mods and this week against last week.
Avatar frameSupporter Plus: a fine line in a colour you pick around your picture, on your profile, in the hover card and in the menu bar. Set it in Settings → Supporter.
ClansA clan has 10 places, 50 when the clan owner is a Supporter and 100 with Supporter Plus.
LauncherIn the Kuroosu Launcher supporters see the history of all their play sessions (time, plays, pp and rank of the last 7 days), download 10 maps at once and have their name in their Supporter colour.
Name changesSupporters can change their name in the settings (or with !changename in-game). Your old names are shown on your profile as “formerly”, so friends still find you – the search finds you by an old name too.

15Voting

VoteOn the vote page press Vote now and type your Kuroosu name on osu-server-list.com. You can vote every 24 hours, the home page shows when you can vote again.
RewardsBadges for 10, 50, 100 and 365 votes, and the player with the most votes in a month gets the badge "Top Voter" and 7 days of Supporter.

16cHall of Fame

The Hall of Fame shows how the top 4 of each mode raced for the top, plus the biggest plays, most #1s, longest time at #1, champions and milestones.

16aBig update

The first card of On Kuroosu on the home page opens /new with everything from the newest big update.

17Gems and boxes

KurolootGems and boxes are no longer part of Kuroosu. They live on their own site, Kuroloot, a small pixel hero game with its own accounts. Playing osu! here gives no gems.

16Weekly League

JoinPlay a map and you join a small group on the league page. All modes play together.
Points10 for a map, up to 10 for accuracy from 90%, 5 for a full combo and 15 for a new personal best. Your best try on each map counts.
RanksBronze, Silver, Gold, Emerald, Diamond and Celestial. Every Monday at 00:00 German time the top of a group go up and the bottom go down.