https://github.com/yanorei32/yr32-skinbuilder

A simple, lightweight, TRUE open-source osu! skin
https://github.com/yanorei32/yr32-skinbuilder

osu osu-skin osugame shellscript

Last synced: 3 months ago
JSON representation

A simple, lightweight, TRUE open-source osu! skin

• Host: GitHub
• URL: https://github.com/yanorei32/yr32-skinbuilder
• Owner: yanorei32
• License: bsd-2-clause
• Created: 2021-05-30T06:30:19.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2025-06-10T03:43:59.000Z (4 months ago)
• Last Synced: 2025-06-10T04:29:36.138Z (4 months ago)
• Topics: osu, osu-skin, osugame, shellscript
• Language: Shell
• Homepage:
• Size: 8.01 MB
• Stars: 22
• Watchers: 4
• Forks: 5
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# yr32's osu! skin

![Build](https://img.shields.io/github/actions/workflow/status/yanorei32/yr32-skinbuilder/release.yml?branch=master&style=for-the-badge&logo=github)

![License](https://img.shields.io/github/license/yanorei32/yr32-skinbuilder.svg?style=for-the-badge&color=blue)

![Top Language](https://img.shields.io/github/languages/top/yanorei32/yr32-skinbuilder.svg?style=for-the-badge)

## A simple, lightweight, open-source osu! skin

![Demo](https://github.com/yanorei32/yr32-skinbuilder/raw/contents/demo.gif)

## Installation (latest)

Prebuild binaries can be downloaded from this link.

https://github.com/yanorei32/yr32-skinbuilder/releases

### Officially supported platforms

* **osu! (Windows) (complete)**

* **osu!lazer (Windows / Linux / Android) (complete)**

* McOsu (Windows) (partially)

### No longer supported platforms

* opsu! (Windows / Android)

## Recommended settings

### osu!

| Key                                                    | Value |

|:-------------------------------------------------------|:------|

| Gameplay/GENERAL/Background dim                        | 90% + |

| Gameplay/GENERAL/Dont't change dim level during breaks | true  |

| Skin/SKIN/Ignore all beatmap skins                     | true  |

| Skin/SKIN/Always use skin cursor                       | true  |

### osu!lazer

| Key                                                          | Value |

|:-------------------------------------------------------------|:------|

| Gameplay/Beatmap/Beatmap skins                               | false |

| Gameplay/Beatmap/Beatmap colours                             | false |

| Gameplay/Beatmap/Beatmap hitsounds                           | false |

| Gameplay/Background/Background dim                           | 90% + |

| Gameplay/Background/Background blur                          | 50% + |

| Gameplay/Background/Lighten playfield during breaks          | false |

| Gameplay/Background/Fade playfield to red when health is low | false |

## Self-build .osk file from shellscript

### Officially supported build paltforms

* Arch Linux

* Debian GNU/Linux

* WSL2 (Windows / Ubuntu)

* Termux (Android)

### Pre-requirements for build

* ffmpeg

* curl

* zip / unzip

* imagemagick

* bc

* inkscape

### Build .osk file

```bash

git clone https://github.com/yanorei32/yr32-skinbuilder

cd yr32-skinbuilder

./build.sh

```