Wrapper for osu!lazer. Downloads and executes the AppImage automatically without requiring any manual work.
Find a file
2024-11-29 14:12:47 +01:00
LICENSE Rewrite 2024-08-09 23:29:12 +02:00
osuboot.sh Fix startup issue 2024-11-29 14:12:47 +01:00
README.md Add cached file path to README 2024-08-11 11:47:08 +02:00

osu!boot

osu!boot is an unofficial wrapper around osu!lazer, 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.

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
  • 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.