skins/how-to-use.md

Table of Contents

• How to Use This Repository
• 1. Create Your Account on git.sulejmani.xyz
• 2. Generate an Access Token
• 3. Create a New Repository
• 4. Set Up Secrets for Deployment
• 5. Clone the Repository
• 6. Prepare Your Skins
• 7. Change Skin Order, add descriptions, and ignore Skins.
• Skin Order
• Ignore Skins
• 8. Upload Your Skins
• 9. Monitor Upload Progress
• 10. Update Skins in the Future
• 12. Adding your skin to https://git.sulejmani.xyz/osc/skins
• 13. Troubleshooting
• Add Skin order, add skin descriptions
• Committed all the files but nothing is happening
• Skin names wrong

How to Use This Repository

If anything is unclear, just shoot me a message on Discord.

1. Create Your Account on git.sulejmani.xyz

(If you don't want to share your mail with me DM me on Discord)

Sign up here: https://git.sulejmani.xyz/user/sign_up

Check your email and click the confirmation link to activate your account.

Then confirm your password to complete the process.

---

2. Generate an Access Token

Go to https://git.sulejmani.xyz/ and open your Settings.

Under the Applications section, create a new token.

• Check all permissions (as shown in the image)
• Give it a clear and recognizable name

Once the token is generated, copy and save it securely, you won’t be able to see it again.

---

3. Create a New Repository

Still on https://git.sulejmani.xyz/, click the + icon in the top right corner to create a new repo.

• Name it however you like
• Use skins-template as the template
• Enable all template items

You now have your own copy of the template repo.

---

4. Set Up Secrets for Deployment

Go to your repository's Settings.

Then under Actions open the Secrets tab and add this:

Secret Name	Secret Value
TOKEN	The token you just created

Then under Actions open the Variables tab and add these two:

Variable Name	Variable Value
CONTAINER_REGISTRY	git.sulejmani.xyz
OSUID	Your osu player id

So in my case my osu profile is https://osu.ppy.sh/users/13792719 and I use 13792719

---

5. Clone the Repository

If you don’t have Git installed, download it here: 👉 https://git-scm.com/downloads/win

Choose where to clone the repo (e.g. D:/git/) and run:

git config --global user.name "Your Name"
git config --global user.email "{yourusername}@sulejmani.xyz" # or your real mail if you dont mind anyone looking 

git lfs install

git clone https://git.sulejmani.xyz/{yourusername}/{yourrepositoryname}.git

---

6. Prepare Your Skins

In your cloned repo, open hardlink-songs-folder.bat.

Edit the source and target paths. For example, if:

• Your osu! skins are in E:\osu!\skins
• Your repo is in D:\git\skins

Then update the line on the script like this:

robocopy "E:\osu!\skins" "D:\git\skins\Skins" /MIR /COPYALL /SEC /B /XJ /DCOPY:T /J

For the git Path the Skins folder needs to have a capital S

Run the batch file by double-clicking it.

---

7. Change Skin Order, add descriptions, and ignore Skins.

Skin Order

This is optional, but recommended. In the workflows folder, open skins.json.

Edit the order and descriptions as you like.

here's an example:

{
  "order": [
    "- Barely still Jace",
    "- Jace"
  ],
  "descriptions": {
    "- Barely still Jace": "My main skin.",
    "- Jace": "My secondary skin, only really used for EZ."
  }
}

Make sure the order matches the skins folder name in the Skins folder.

Ignore Skins

There is a .gitignore file in the root of the repo. You can add any skins you don't want to be uploaded.

Here's an example:

*WhiteCat*
*Vaxei*

So in this example if a Skin has WhiteCat or Vaxei in the name, it will be ignored.

---

8. Upload Your Skins

Open a terminal (cmd or PowerShell) in your repo directory:

cd D:\git\skins  # update this to your actual path

Then run:

git add .
git commit -m "Adding skins"
git config --global credential.helper cache
git push

Your skins will now be uploaded.

---

9. Monitor Upload Progress

Go to your repo's Actions tab.

You’ll see the workflow progress there.

If something goes wrong, check the logs—or just ping me on Discord.

---

10. Update Skins in the Future

To update your skins later:

1. Re-run hardlink-songs-folder.bat
2. Run the same upload commands:

git pull
git add .
git commit -m "Updating skins"
git push

---

11. Handle duplicate skin.ini names

You might see Skins that show up with the exact same name in your README.md, this isn't a problem but if you would want to fix that you would need to go in to your skin and rename the name part of your skin.ini.

---

12. Adding your skin to https://git.sulejmani.xyz/osc/skins

After you did every step it should be in https://git.sulejmani.xyz/osc/skins after a couple minutes, if it doesn't show up please message me on Discord.

---

13. Troubleshooting

Add Skin order, add skin descriptions

Edit .gitea/workflows/skins.json like described in step 6.

Committed all the files but nothing is happening

Make sure the skins folder is called Skins and not skins.

Skin names wrong

The Scirpt takes skin names based off of the skin.ini file in the skin, to fix that change it in the skin.ini file.