Add current users
30
README.md
Normal file
@@ -0,0 +1,30 @@
|
||||
# osu! Swiss Community
|
||||
|
||||
Welcome to the osu! Swiss Community skinhub, this repository archives and showcases lots of player-made skins.
|
||||
|
||||
Enjoy looking around, click file names to download the skins.
|
||||
|
||||
## How do I add my skins here?
|
||||
|
||||
If you're interested in adding your skins here please follow this tutorial [how-to-use](/how-to-use.md)
|
||||
|
||||
## Skins
|
||||
|
||||
<details>
|
||||
<summary>list instead of icons</summary><br>
|
||||
<a href="https://git.sulejmani.xyz/arlind/skins">Arlind</a><br>
|
||||
<a href="https://git.sulejmani.xyz/Skellers/ooga_booga">Skellers</a><br>
|
||||
<a href="https://git.sulejmani.xyz/marcel7/krasseskins">marcel7</a><br>
|
||||
</details>
|
||||
|
||||
<p align="center">
|
||||
<a href="https://osu.ppy.sh/users/13792719">
|
||||
<img src="https://a.ppy.sh/13792719" width="175" height="175">
|
||||
</a>
|
||||
<a href="https://osu.ppy.sh/users/8040245">
|
||||
<img src="https://a.ppy.sh/8040245" width="175" height="175">
|
||||
</a>
|
||||
<a href="https://osu.ppy.sh/users/13062430">
|
||||
<img src="https://a.ppy.sh/13062430" width="175" height="175">
|
||||
</a>
|
||||
</p>
|
||||
BIN
docs/activate_account.png
Normal file
|
After Width: | Height: | Size: 5.9 KiB |
BIN
docs/activation_mail.png
Normal file
|
After Width: | Height: | Size: 22 KiB |
BIN
docs/applications_generate_token.png
Normal file
|
After Width: | Height: | Size: 44 KiB |
BIN
docs/check_mail.png
Normal file
|
After Width: | Height: | Size: 12 KiB |
BIN
docs/copy_token.png
Normal file
|
After Width: | Height: | Size: 4.8 KiB |
BIN
docs/navigate_actions.png
Normal file
|
After Width: | Height: | Size: 9.2 KiB |
BIN
docs/navigate_repository_settings.png
Normal file
|
After Width: | Height: | Size: 43 KiB |
BIN
docs/navigate_settings.png
Normal file
|
After Width: | Height: | Size: 8.9 KiB |
BIN
docs/progress.png
Normal file
|
After Width: | Height: | Size: 36 KiB |
BIN
docs/register.png
Normal file
|
After Width: | Height: | Size: 9.9 KiB |
BIN
docs/secret1.png
Normal file
|
After Width: | Height: | Size: 10 KiB |
BIN
docs/secret2.png
Normal file
|
After Width: | Height: | Size: 11 KiB |
BIN
docs/start_create_new_repo.png
Normal file
|
After Width: | Height: | Size: 6.8 KiB |
BIN
docs/template_repo.png
Normal file
|
After Width: | Height: | Size: 40 KiB |
232
how-to-use.md
Normal file
@@ -0,0 +1,232 @@
|
||||
---
|
||||
|
||||
gitea: none
|
||||
include_toc: true
|
||||
|
||||
---
|
||||
|
||||
# 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](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/](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/](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 these two:
|
||||
|
||||
| Secret Name | Secret Value |
|
||||
| -------------------- | -------------------------- |
|
||||
| `TOKEN` | The token you just created |
|
||||
| `CONTAINER_REGISTRY` | `git.sulejmani.xyz` |
|
||||
|
||||

|
||||

|
||||
|
||||
---
|
||||
|
||||
## 5. Clone the Repository
|
||||
|
||||
If you don’t have Git installed, download it here:
|
||||
👉 [https://git-scm.com/downloads/win](https://git-scm.com/downloads/win)
|
||||
|
||||
Choose where to clone the repo (e.g. `D:/git/`) and run:
|
||||
|
||||
```bash
|
||||
git config --global user.name "Your Name"
|
||||
git config --global user.email "you@example.com"
|
||||
|
||||
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:
|
||||
|
||||
```bat
|
||||
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:
|
||||
|
||||
```json
|
||||
{
|
||||
"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:
|
||||
|
||||
```cmd
|
||||
cd D:\git\skins # update this to your actual path
|
||||
```
|
||||
|
||||
Then run:
|
||||
|
||||
```bash
|
||||
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:
|
||||
|
||||
```bash
|
||||
git pull
|
||||
git add .
|
||||
git commit -m "Updating skins"
|
||||
git push
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
|
||||
### 11. Adding your skin to https://git.sulejmani.xyz/osc/skins
|
||||
|
||||
After you did every step please DM @arlind on discord
|
||||
|
||||
---
|
||||
|
||||
## 12. 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.
|
||||