A skin can look finished in screenshots and still ship without cursor.png, a whole hitsound set, or the @2x pair for a sprite you only exported in HD. osu! will not warn you; it falls back to the default skin or to silence. This article walks through a small Python script that compares a skin folder to a required-file list and prints what is missing. The script was run on a temporary folder in this environment so the output below is real, not sketched.
What the script checks
- A short required list: cursor, hit circle, overlay, approach circle, and
normal-hitnormal(with common audio extensions). - An optional but noisy list: slider start/end circles, scorebar marker, and the soft/drum
hitnormalsamples. Missing optional files are warnings, because stable has a fallback. -
@2xpairing for PNG files: if[email protected]exists withouthitcircle.png, or the reverse, it is reported. That is not always a hard error, but it is how skins end up looking sharp on one machine and soft on another.
You can extend the lists. The point is to fail on names, not on pixels.
The script
from pathlib import Path
AUDIO = (".wav", ".mp3", ".ogg")
REQUIRED_IMAGES = [
"cursor.png",
"hitcircle.png",
"hitcircleoverlay.png",
"approachcircle.png",
]
REQUIRED_AUDIO_STEMS = ["normal-hitnormal"]
OPTIONAL_IMAGES = [
"sliderstartcircle.png",
"sliderendcircle.png",
"scorebar-marker.png",
"scorebar-ki.png",
]
OPTIONAL_AUDIO_STEMS = ["soft-hitnormal", "drum-hitnormal"]
def stems(folder: Path):
return {p.name.lower(): p for p in folder.iterdir() if p.is_file()}
def has_audio(files, stem):
return any(f"{stem}{ext}" in files for ext in AUDIO)
def check(folder: Path):
files = stems(folder)
missing, warnings = [], []
for name in REQUIRED_IMAGES:
if name not in files:
missing.append(name)
hd = name.replace(".png", "@2x.png")
if name in files and hd not in files:
warnings.append(f"{hd} missing (SD only)")
if hd in files and name not in files:
warnings.append(f"{name} missing (@2x only)")
for stem in REQUIRED_AUDIO_STEMS:
if not has_audio(files, stem):
missing.append(stem + ".{wav,mp3,ogg}")
for name in OPTIONAL_IMAGES:
if name not in files:
warnings.append(f"optional missing: {name}")
for stem in OPTIONAL_AUDIO_STEMS:
if not has_audio(files, stem):
warnings.append(f"optional missing: {stem}")
return missing, warnings
if __name__ == "__main__":
import sys
folder = Path(sys.argv[1])
missing, warnings = check(folder)
print("missing required:", missing or "none")
print("warnings:", warnings or "none")
sys.exit(1 if missing else 0)
A real run
A throwaway folder with only hitcircle.png and cursor.png produced:
missing required: ['hitcircleoverlay.png', 'approachcircle.png', 'normal-hitnormal.{wav,mp3,ogg}']
warnings: ['[email protected] missing (SD only)', '[email protected] missing (SD only)',
'optional missing: sliderstartcircle.png', ...]
The exit code was 1 because required files were absent. After adding the two PNG files and a tiny valid normal-hitnormal.wav, the required list went to none and the exit code to 0. Optional warnings remained, which is what you want on a standard-only first draft.
This does not replace in-game testing, and it does not rate how readable a skin is. It only catches the typo and forgotten-file class of mistakes before you zip an .osk. When you are browsing finished packs on osuskins.org, you are looking at skins that already survived this kind of check, even if the author did it by hand.
Keep the required list honest: if you advertise mania or taiko support, add those filenames to the required section instead of leaving them as warnings.
Top comments (0)