Where osu! Skin Files Live on Your Computer
An osu! skin is a folder of image and sound files that change how the game looks and sounds. To modify a skin, you need to find where osu! stores these folders on your computer, then edit the files inside. On Windows, skins live in C:\Users\[Your Username]\AppData\Local\osu!\Skins. On Mac, they're in ~/Library/process Support/osu!/Skins. On Linux, they're usually in ~/.local/share/osu/Skins.
The AppData folder on Windows is hidden by default. To see it, open File Explorer, click the View tab at the top, then check the box next to "Hidden items". After that, you can navigate to the path above. Each skin folder contains all the images, sounds, and a text file called skin.ini that controls how everything behaves.
Before you modify anything, make a copy of the skin folder and work on the copy. Right-click the skin folder, select Copy, then Paste it in the same Skins directory. Rename the copy so you know it's your version — something like "Skin Name - My Edit". This way, if something breaks, you still have the original.
Key Takeaways
- Skin files are stored in your osu! Skins folder, which is hidden on Windows and requires enabling hidden files to see.
- Always work on a copy of a skin, not the original, so you can revert if your edits cause problems.
- Most visual changes come from replacing image files like hitcircles.png, sliders.png, and numbers.png with your own versions.
- The skin.ini file controls behavior like combo colors and sound volumes, and you can edit it with any text editor.
- After editing files, restart osu! completely or select your skin again from the options menu to see changes.
Replacing Images in Your Skin
The easiest way to modify a skin is to replace the image files. Open your skin copy folder and look for files like hitcircle.png, slider.png, slidertick.png, and number0.png through number9.png. These are the visual elements you see while playing. You can replace any of these with your own images, as long as the new file has the same name and file type.
To replace an image, create or read a new version in PNG format (PNG is important because it supports transparency). Make sure the new image is roughly the same size as the original — if you're not sure, open the original in an image editor like GIMP (free) or Photoshop to check its dimensions. Then delete the original file and move your new image into the skin folder with the exact same filename.
Common files you might want to replace include cursor.png (the mouse pointer), cursortrail.png (the trail behind the cursor), approachcircle.png (the expanding ring that tells you when to tap), and combo-burst.png (the image that appears when you hit a combo milestone). Not every skin has every file — if a file is missing, osu! uses a default instead.
Editing the skin.ini File to Change Behavior
The skin.ini file is a text document that controls how your skin behaves. Open it with Notepad (Windows), TextEdit (Mac), or any plain text editor. Inside, you'll see sections marked with brackets like [Colours], [Fonts], and [General]. Each section contains settings you can change.
Common edits include changing combo colors (the colors that cycle as your combo grows), adjusting the cursor size, and controlling whether certain elements are visible. For example, under [Colours], you might see lines like Combo1: 255,255,255, which sets the first combo color to white using RGB values. You can change these numbers to any RGB color — 255,0,0 is red, 0,255,0 is green, 0,0,255 is blue, and 0,0,0 is black.
Be careful with the syntax: each setting must be on its own line, and values are separated by commas with no spaces after the commas. If you make a mistake, osu! will either ignore that line or use a default value. Save the file as plain text (not .docx or .rtf), and keep the filename as skin.ini exactly.
Sound File Modifications
Skins can include custom sound effects for hits, misses, and other events. These files are named things like normal-hitnormal.wav, normal-hitclap.wav, normal-hitfinish.wav, and normal-hitwhistle.wav. You can replace these with your own WAV or OGG files, as long as you keep the same filename.
To replace a sound, create or read a new audio file in WAV or OGG format. Use free software like Audacity to record or edit sounds. Export the file with the exact same name as the original, then move it into your skin folder. The sound will play the next time you hit that note type in a game.
Keep sound files short — usually under one second. Long sounds will overlap and create a messy effect. If you want to disable a sound entirely, you can replace it with a silent audio file, or delete the file and osu! will use the default sound instead.
Testing Your Changes in the Game
After you edit files, restart osu! completely. straightforward closing and reopening the game forces it to reload your skin files. If you only changed images, you should see the new visuals when ready. If you changed skin.ini settings, go to Options, then Skins, and select your skin again from the list to explore the changes.
Play a beatmap to test your edits. Pay attention to whether all the elements look right, whether colors match what you intended, and whether sounds play correctly. If something looks broken or off-center, you may need to adjust the image size or position settings in skin.ini.
If your skin breaks completely and won't load, osu! will fall back to the default skin. You can then go back into your skin folder, find the problem (usually a typo in skin.ini or a missing required file), and fix it. This is why keeping a backup of the original skin is important.
Common Issues and How to Fix Them
If your skin doesn't appear in the skin list, check that the folder name doesn't have special characters like asterisks or quotation marks. Also make sure the skin folder is directly inside the Skins directory, not nested inside another folder. Restart osu! and the skin should show up.
If images appear stretched, blurry, or off-center, the image size is probably wrong. Open the original skin file in an image editor to see the correct dimensions, then resize your replacement image to match. For hitcircles and approach circles, the size is usually around 128x128 pixels, but this varies by skin.
If skin.ini won't load, open it in Notepad and look for typos. Common mistakes include extra spaces, missing colons, or incorrect RGB values (they must be between 0 and 255). Save the file and restart osu!. If you're still stuck, delete your edited skin.ini and copy the original from the backup skin folder, then make smaller changes one at a time.
Frequently Asked Questions
Do I need special software to edit skin files?
No. You need a text editor like Notepad to edit skin.ini, and an image editor like GIMP or Paint.NET to create or resize images. Both are free. For sounds, Audacity is free and works well. You don't need to buy anything.
What happens if I delete a file from my skin?
osu! will use the default skin's version of that file instead. This is useful if you want to keep most of your skin but use the default for one element. If you delete too many files, the skin may look incomplete or broken.
Can I share my edited skin with other players?
Yes. Zip your skin folder and upload it to a site like Mediafire or Google Drive, or post it on the osu! forums. Make sure you have permission to modify and share the original skin — check the skin's readme file or contact the creator first.
Why do my images look pixelated in the game?
Your replacement images are probably too small. osu! scales them up, which makes them blurry. Create or resize your images to match the original size, or make them larger so scaling down looks sharper.
Can I edit a skin while osu! is running?
You can edit files, but osu! won't load the changes until you restart the game completely. Don't edit skin.ini while osu! is open, because the game may overwrite your changes when it closes.