A skin folder collects files over time: old slider balls, unused combo bursts, a sliderb-spec.png that no longer matters because you added sliderb.png, or a typo such as hit-300.png. osu!stable will ignore those leftovers, but they still bloat the .osk and they confuse the next edit. This script walks a skin folder, builds a set of names that look used (from skin.ini and a list of well-known stems), and prints everything else.
It uses only the Python standard library. Point it at the root of a skin (the folder that contains skin.ini).
#!/usr/bin/env python3 """List files in an osu! skin folder that skin.ini and known stems do not use.""" import re import sys from pathlib import Path KNOWN_STEMS = [ "approachcircle", "hitcircle", "hitcircleoverlay", "hitcircleselect", "cursor", "cursormiddle", "cursor-middle", "cursortrail", "cursor-ripple", "reversearrow", "sliderfollowcircle", "sliderscorepoint", "sliderstartcircle", "sliderendcircle", "sliderendmiss", "slidertickmiss", "sliderb", "sliderb-nd", "sliderb-spec", "spinner-background", "spinner-circle", "spinner-metre", "spinner-meter", "spinner-osu", "spinner-approachcircle", "spinner-bottom", "spinner-top", "spinner-middle", "spinner-middle2", "spinner-spin", "spinner-clear", "spinner-glow", "spinner-rpm", "hit0", "hit50", "hit100", "hit100k", "hit300", "hit300g", "hit300k", "particle50", "particle100", "particle300", "scorebar-bg", "scorebar-colour", "scorebar-marker", "scorebar-ki", "scorebar-kidanger", "scorebar-kidanger2", "inputoverlay-background", "inputoverlay-key", "play-skip", "play-unranked", "play-warningarrow", "arrow-pause", "arrow-warning", "section-pass", "section-fail", "count1", "count2", "count3", "go", "ready", "masking-border", "multi-skipped", "pause-overlay", "pause-back", "pause-continue", "pause-retry", "pause-replay", "fail-background", "menu-background", "menu-back", "menu-button-background", "menu-snow", "welcome_text", "button-left", "button-middle", "button-right", "options-offset-tick", "songselect-top", "songselect-bottom", "selection-tab", "selection-mode", "selection-mode-over", "selection-mods", "selection-mods-over", "selection-random", "selection-random-over", "selection-options", "selection-options-over", "mode-osu", "mode-taiko", "mode-fruits", "mode-mania", "ranking-panel", "ranking-title", "ranking-graph", "ranking-accuracy", "ranking-maxcombo", "ranking-perfect", "ranking-replay", "ranking-retry", "ranking-winner", "ranking-X", "ranking-XH", "ranking-S", "ranking-SH", "ranking-A", "ranking-B", "ranking-C", "ranking-D", "default-0", "default-1", "default-2", "default-3", "default-4", "default-5", "default-6", "default-7", "default-8", "default-9", "combo-0", "score-0", "score-dot", "score-comma", "score-percent", "score-x", "score-pp", "comboburst", "lighting", "star", "star2", "mania-key1", "mania-key1D", "mania-key2", "mania-key2D", "mania-keyS", "mania-keySD", "mania-note1", "mania-note2", "mania-stage-left", "mania-stage-right", "mania-stage-hint", "mania-stage-bottom", "mania-stage-light", "mania-hit0", "mania-hit50", "mania-hit100", "mania-hit200", "mania-hit300", "mania-hit300g", "fruit-catcher-idle", "fruit-catcher-kiai", "fruit-catcher-fail", "fruit-apple", "fruit-grapes", "fruit-orange", "fruit-pear", "fruit-bananas", "fruit-drop", ] PREFIX_KEYS = ( "hitcircleprefix", "scoreprefix", "comboprefix", "keyimage", "keyimaged", "noteimage", "noteimagel", "noteimageh", "noteimaget", ) IGNORE_NAMES = {"skin.ini", "thumbs.db", ".ds_store"} IGNORE_SUFFIXES = {".txt", ".md", ".osk", ".zip", ".ds_store"} def parse_ini(path: Path): refs = [] for raw in path.read_text(errors="replace").splitlines(): line = raw.split("//", 1)[0].strip() if not line or line.startswith("["): continue if ":" not in line: continue key, val = line.split(":", 1) key, val = key.strip(), val.strip().strip('"').strip("'") if not val: continue refs.append((key, val)) return refs def stem_variants(stem: str): stem = stem.strip() if not stem: return [] base = Path(stem).name base = re.sub(r"\.(png|jpg|jpeg|gif|wav|ogg|mp3)$", "", base, flags=re.I) return {base, base.lower()} def used_stems(root: Path): used = set() for stem in KNOWN_STEMS: used.update(stem_variants(stem)) ini = root / "skin.ini" if not ini.is_file(): return used, [] refs = parse_ini(ini) for key, val in refs: used.update(stem_variants(val)) compact = key.lower().replace(" ", "") if compact in PREFIX_KEYS or compact.endswith("prefix"): used.update(stem_variants(val)) return used, refs def file_stem(name: str): n = name lower = n.lower() if lower.endswith("@2x.png") or lower.endswith("@2x.jpg"): n = n[:-7] n = re.sub(r"\.(png|jpg|jpeg|gif|wav|ogg|mp3)$", "", n, flags=re.I) n = re.sub(r"-\d+$", "", n) return n def main(): root = Path(sys.argv[1] if len(sys.argv) > 1 else ".").expanduser() print("skin:", root.resolve()) ini = root / "skin.ini" if not ini.is_file(): print("No skin.ini in that folder.") return used, refs = used_stems(root) print("skin.ini keys:", len(refs)) leftovers = [] empty = [] used_l = {s.lower() for s in used} for path in sorted(root.rglob("*")): if not path.is_file(): continue rel = path.relative_to(root) if path.name.lower() in IGNORE_NAMES or path.suffix.lower() in IGNORE_SUFFIXES: continue if path.stat().st_size == 0: empty.append(str(rel)) stem = file_stem(path.name) sl = stem.lower() if sl in used_l: continue if any(sl == s or sl.startswith(s + "-") for s in used_l): continue leftovers.append(str(rel)) print("leftover files:", len(leftovers)) for name in leftovers: print(" leftover:", name) print("empty files:", len(empty)) for name in empty: print(" empty:", name) if not leftovers and not empty: print("No leftover or empty files found.") if __name__ == "__main__": main() What it reports
- leftover — a file whose stem is not a known gameplay/interface name and does not match a
skin.inivalue or prefix. A typo such ashit-300.png(the real stem ishit300) will show up here. - empty — a 0-byte file. Those are worth deleting or replacing; a zero-length hitsound is a common source of a silent tap.
The known-stem list is not every possible filename in existence. Rare or very old names can appear as leftovers even when stable would load them. Read the list once before you delete anything, and keep a copy of the skin.
A short run
I ran the script on a temporary folder that contained skin.ini, a used hitcircle.png, a used cursor.png, an empty hit100.png, and a leftover old-sliderb-backup.png. It printed the leftover backup and the empty hit burst, and it left the real stems alone. Point it at your own skin root the same way:
python3 leftover_osu_skin_files.py /path/to/skin If you want to compare how complete skins name these files, look at a few finished sets on osuskins.org before you delete a leftover you are not sure about.
