https://github.com/feri8256/fosu
A minimal concept unofficial client for the rhythm game osu! written in JavaScript
https://github.com/feri8256/fosu
game html-css-javascript html5 music node nodejs osu osugame rythm
Last synced: 2 months ago
JSON representation
A minimal concept unofficial client for the rhythm game osu! written in JavaScript
- Host: GitHub
- URL: https://github.com/feri8256/fosu
- Owner: Feri8256
- Created: 2025-02-18T18:14:19.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-03-04T20:09:45.000Z (2 months ago)
- Last Synced: 2025-03-04T21:22:54.191Z (2 months ago)
- Topics: game, html-css-javascript, html5, music, node, nodejs, osu, osugame, rythm
- Language: JavaScript
- Homepage:
- Size: 1.87 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# fosu
A minimal concept unofficial client for the rhythm game [osu!](https://osu.ppy.sh/) written in JavaScript
## Getting started
fosu requires Node.js runtime environment to be installed on your system
1. Download and install Node.js runtime with npm package manager from [here](https://nodejs.org/en/download)
2. Download this repository as a zip archive, then open the zip and copy the folder on your storage to a preferred location (avoid too deep directory structures if it's possible)
3. Navigate to the location from step 2 and run `INSTALL.bat`. This will install the dependencies of the client
4. You can create a shortcut for `START.bat` and put it on your desktop for easier and quicker access if you want
## Importing beatmaps and skins
This client offers two possible ways for content importing
- Copy your downloaded beatmap or skin files (`.osz` or `.osk`) to the imports folder, then start the client (this method is the recommended, and most user-friendly way)
- Copy beatmap folders from your official osu! installations `Songs` or `Skins` directory to fosu's `songs` or `skins` directory (for more advanced users)
> Important to note that before doing any of these import methods, close the browser client and the cmd window, then start the client again so it can detect the changes and perform all the necessary steps
> Only **png** and **wav** files accepted in skins. Any other file extensions and sprites with frame number or `@2x` suffix in their name are ignored and the default is used instead!
---
*fosu is not intended as a substitution to any of the official osu! releases (stable or lazer) and not meant to compete with other clones and implementations*