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.
Top comments (0)