Skip to content

osudroid/osu-droid

Folders and files

NameName
Last commit message
Last commit date
Feb 13, 2024
Feb 5, 2025
Nov 13, 2024
Dec 18, 2024
Mar 5, 2025
Aug 14, 2024
Mar 4, 2025
Oct 28, 2024
Mar 6, 2025
Sep 25, 2024
Jul 21, 2021
Feb 27, 2025
Mar 21, 2020
Apr 24, 2024
Feb 11, 2025
Jun 7, 2020
Oct 16, 2021
Feb 13, 2024
Sep 3, 2021
Dec 13, 2020
Oct 16, 2021
Dec 8, 2020

Repository files navigation

osudroid

osu-droid

Official International Discord Android CI CodeFactor

osu!droid is a free-to-play circle clicking rhythm game for Android devices. It was a game hatched many years ago by the osu! community. This project is now being developed by a small group of fans and also with the help of foreign friends.

Status

osu!droid is still work-in-progress. Some features are going to be implemented in the future but it's still playable and fun!

Downloading the source code

Clone the repository:

git clone https://github.com/osudroid/osu-droid.git

Open the folder in Android Studio.

To update the source code to the latest commit, run the following command inside the osu-droid directory:

git pull

Coding Languages:

You can code for the project in Java or Kotlin.

Building

In Android Studio you can Build a debug release to test your changes. The output directory of your .apk is inside build/output of osu-droid's directory.

Or if you prefer the command line and you are on Linux, run chmod +x gradlew and ./gradlew assembleDebug inside the directory to build the debug .apk files but make sure that you are using Java 8.

Contributing

We welcome any sort of contributions, as long as they're helpful. Those who aren't able to contribute code may instead suggest small changes like grammar fixes, new features or report client issues via Feature request or GitHub issues.

License

osu-droid is licensed under the Apache License 2.0. Please see the licence file for more information.