37 lines
1.9 KiB
Markdown
37 lines
1.9 KiB
Markdown
# 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 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 perform 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
|
|
|
|
## Troubleshooting
|
|
### Removing the cached AppImage file
|
|
To remove the cached `osu.AppImage` file, simply run `rm -rf ${HOME}/.cache/osu.AppImage`
|
|
|
|
## License
|
|
osu!boot is licensed under the GNU Affero General Public License v3.
|