Skip to content

Greenest-Guy/osu-mania-Skin-Merger

Repository files navigation

osu!mania Skin Merger

osu!mania Skin Merger is a tool designed to merge keycounts from two different osu!mania skins into one. Making skinning easier, so you don't have to read through long skin.ini config files, or search for images in large folders! You can also merge a mania skin into a skin of a different gamemode such as Standard, Taiko, or Catch!

GitHub Downloads (all assets, all releases) GitHub Release CodeFactor Grade Static Badge Static Badge

🔭 Preview

preview.mov

⚙️ Options

🧱 Base Skin

The Base Skin is where the majority of the files are drawn from, e.g., menu layout, hitsounds, and the rest of the keycounts, excluding the merging one.

➕ Merge Skin

The Merge Skin is where the files for the selected keycount are drawn from. E.g., if you selected 7k, the 7k skin files from the merge file will be added to the base skin.

🔧 New Skin vs Overwrite Skin

The New Skin option will create a new, separate skin in your downloads folder, leaving the Base and Merge Skins untouched. The Overwrite Skin option will add the Merge Skin to the Base Skin directly, thus changing the Base Skin to incorporate the Merge Skin in the selected keycount.

🔢 Keycount

The keycount is taken from the merge skin and added to the base skin.

❗ Issues & Suggestions

Please report any issues and or suggestions here on GitHub or message me on Discord rh7thm

🧰 How the Program Works

  1. Creates a directory within the user's downloads folder (product folder), in which the merged skin will be created.

  2. Copies all files from the base skin into the product folder.

  3. Creates another directory within the product folder named "merge_files"

  4. Creates a directory within merge_files named "(Merging Keycount)_key".

    • E.g. if you selected a 7k skin, the directory would be named 7_key inside of merge_files
  5. Copies the image files specified inside the merge skin's skin.ini config file into the "(Merging Keycount)_key" folder. (specifically the images specified within the [mania] section for the selected keycount)

  6. Copies any default files not specified in the skin.ini config file, and appends them to the end of that skin.ini key section.

  7. Reports any potentially missing files. (Still finishes the merge)

  8. The skin.ini config file is edited so that the new keycount has the correct image paths, settings, and adds both authors to the authors section.

⚠️ Disclaimer

This tool is for personal use only. Merged skins may violate osu! community guidelines if not properly credited or distributed improperly. Make sure to credit all original authors and do not claim ownership of any assets you did not create. See DISCLAIMER.md for more details.

⤵️ Download Options (Windows)

:octocat: GitHub

🐍 Source Code

  1. Clone the repository and install all dependencies
  2. Run main.py using Python version 3.7+

About

osu!mania Skin Merger is a tool designed to merge keycounts from two different osu!mania skins into one. Making skinning easier, so you don't have to read through long skin.ini config files, or search for images in large folders!

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages