Add README

This commit is contained in:
JeremyStar™ 2024-08-10 00:02:01 +02:00
parent 13fdc34017
commit 2aefa560f1
Signed by: JeremyStarTM
GPG key ID: E366BAEF67E4704D

33
README.md Normal file
View file

@ -0,0 +1,33 @@
# osu!boot
osu!boot is an unofficial wrapper around [osu!lazer](https://github.com/ppy/osu), allowing it to be downloaded and launched on Linux and other UNIX-like operating systems without any hassle.
## Dependencies
- wget (downloading)
- FUSE 2 (AppImage, for some reason it still uses legacy FUSE 2)
## Usage
You can either clone the repository and run the script from there or download the script every time you want to launch osu!lazer.
### Cloning
This method allows you full control over which version you want to run and when to update.
```bash
git clone https://git.staropensource.de/JeremyStarTM/osuboot.git "${HOME}/.local/share/osuboot"
"${HOME/.local/share/osuboot/osuboot.sh"
```
### Oneliner
This method allows you to be fully up to date, while potentially compromising your security as it directly executes the script without allowing to check it's source.
`wget --quiet -O- https://git.staropensource.de/JeremyStarTM/osuboot/raw/branch/develop/osuboot.sh | bash`
## Configuration
You can configure osu!boot to your liking using environment variables.
- `OSUBOOT_COLORLESS`: If set, will not override `COLOR_SPECIAL`, `COLOR_DEFAULT`, `COLOR_SUCCESS`, `COLOR_FAILURE`, `COLOR_OTHER` and `RESET`. You can use this to customize colors or to disable colors alltogether
- `OSUBOOT_DRYRUN`: If set, will performs a trial run, without downloading or launching the game
- `OSUBOOT_SKIP_CHECKING_DEPS`: If set, skips dependency checks, see [Dependencies](#dependencies)
- `OSUBOOT_SKIP_CHECKING_NET`: If set, skips network connectivity checks
- `OSUBOOT_MAX_CACHE_TIME`: Maximum age of the cached `osu.AppImage` file in days
- `OSUBOOT_DOWNLOAD_URL`: URL to download `osu.AppImage` from
## License
osu!boot is licensed under the GNU Affero General Public License v3.