{"id":13622127,"url":"https://github.com/itdelatrisu/opsu","last_synced_at":"2026-03-14T15:19:28.804Z","repository":{"id":18204088,"uuid":"21337107","full_name":"itdelatrisu/opsu","owner":"itdelatrisu","description":"opsu! ~ an open-source osu! client","archived":false,"fork":false,"pushed_at":"2023-05-23T20:08:41.000Z","size":133441,"stargazers_count":780,"open_issues_count":243,"forks_count":122,"subscribers_count":67,"default_branch":"master","last_synced_at":"2025-11-15T03:04:35.762Z","etag":null,"topics":["game","java","lwjgl","music","osu"],"latest_commit_sha":null,"homepage":"https://itdelatrisu.github.io/opsu/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/itdelatrisu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2014-06-30T02:14:50.000Z","updated_at":"2025-11-04T10:09:17.000Z","dependencies_parsed_at":"2024-01-14T08:08:47.433Z","dependency_job_id":"61ad929d-0127-4de3-9f14-b61d00a3f961","html_url":"https://github.com/itdelatrisu/opsu","commit_stats":null,"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"purl":"pkg:github/itdelatrisu/opsu","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itdelatrisu%2Fopsu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itdelatrisu%2Fopsu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itdelatrisu%2Fopsu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itdelatrisu%2Fopsu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itdelatrisu","download_url":"https://codeload.github.com/itdelatrisu/opsu/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itdelatrisu%2Fopsu/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30508039,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-14T14:51:43.155Z","status":"ssl_error","status_checked_at":"2026-03-14T14:47:41.964Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["game","java","lwjgl","music","osu"],"created_at":"2024-08-01T21:01:14.515Z","updated_at":"2026-03-14T15:19:28.793Z","avatar_url":"https://github.com/itdelatrisu.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"# [opsu!](https://itdelatrisu.github.io/opsu/)\n**opsu!** is an unofficial open-source client for the rhythm game\n[osu!](https://osu.ppy.sh/), written in Java using\n[Slick2D](http://slick.ninjacave.com/) and  [LWJGL](http://lwjgl.org/)\n(wrappers around OpenGL and OpenAL).\n\nopsu! runs on Windows, OS X, and Linux.\nA [libGDX port](https://github.com/fluddokt/opsu) also supports Android devices.\n\n## Getting Started\nGet a copy of opsu! from the [releases](https://github.com/itdelatrisu/opsu/releases)\npage.  APK releases can be found [here](https://github.com/fluddokt/opsu/releases).\n\n### Java Setup\nThe Java Runtime Environment (JRE) 7 or higher must be installed in order to run\nopsu!. The download page is located [here](https://www.java.com/en/download/).\n\n### Beatmaps\nopsu! requires \"beatmaps\" to run, which contain the songs and gameplay data.\nThese can be downloaded directly through opsu! in the downloads menu, or\nmanually from the [osu! website](https://osu.ppy.sh/p/beatmaplist) (requires\nregistration) and mirror sites like [Bloodcat](http://bloodcat.com/osu/).\nPlace any manually downloaded beatmaps (in .osz format) in the `Import/`\ndirectory for opsu! to unpack them automatically.\n\nIf osu! is installed, opsu! will attempt to read beatmaps from the osu!\ninstallation location.  The beatmap directory can also be changed by setting\nthe \"BeatmapDirectory\" value in the generated configuration file.\n\n### First Run\nopsu! will parse all beatmaps when launched, which can take a while for the\nfirst time.  If no beatmaps are found, the game will prompt you to download some\nto get started.\n\nGame settings can be changed in the options menu, accessed by clicking the\n\"Other Options\" button in the song menu.  The \"Music Offset\" value will likely\nneed to be adjusted initially, or whenever hit objects are out of sync with the\nmusic.\n\n### Directory Structure\nThe following files and folders will be created by opsu! as needed:\n* `.opsu.cfg`: The configuration file.  Most (but not all) of the settings can\n  be changed through the options menu.\n* `.opsu.db`: The beatmap cache database.\n* `.opsu_scores.db`: The scores and player database.\n* `.opsu.log`: The error log.  All critical errors displayed in-game are also\n  logged to this file, and other warnings not shown are logged as well.\n* `Songs/`: The beatmap directory (not used if an osu! installation is detected).\n  The parser searches all of its subdirectories for .osu files to load.\n* `Skins/`: The skins directory.  Each skin must be placed in a folder within\n  this directory.  Any game resource (in `res/`) can be skinned by placing a\n  file with the same name in a skin folder.  Skins can be selected in the\n  options menu.\n* `Replays/`: The replay directory.  Replays of each completed game are saved\n  as .osr files, and can be viewed at a later time or shared with others.\n* `Import/`: The import directory.  All beatmap packs (.osz) and skin\n  packs (.osk) are unpacked to the proper location.  All replays (.osr) are\n  moved to the replay directory, and their scores saved to the scores database.\n* `Screenshots/`: The screenshot directory. Screenshots can be taken by\n  pressing the F12 key.\n* `Natives/`: The native libraries directory.\n* `Temp/`: The temporary files directory.  Deleted when opsu! exits.\n\n## Building\nopsu! is distributed as both a [Maven](https://maven.apache.org/) and\n[Gradle](https://gradle.org/) project.\n\n### Maven\nMaven builds are built to the `target` directory.\n* To run the project, execute the Maven goal `compile`.\n* To create a single executable jar, execute the Maven goal `package -Djar`.\n  This will compile a jar to `target/opsu-${version}.jar` with the libraries,\n  resources and natives packed inside the jar.\n  * Setting the \"XDG\" property (`-DXDG=true`) will make the application use XDG\n    folders under Unix-like operating systems.\n  * Setting the \"exclude\" property to \"ffmpeg\" (`-Dexclude=ffmpeg`) will exclude\n    FFmpeg shared libraries from the jar.\n\n### Gradle\nGradle builds are built to the `build` directory.\n* To run the project, execute the Gradle task `run`.\n* To create a single executable jar, execute the Gradle task `jar`.\n  This will compile a jar to `build/libs/opsu-${version}.jar` with the libraries,\n  resources and natives packed inside the jar.\n  * Setting the \"XDG\" property (`-PXDG=true`) will make the application use XDG\n    folders under Unix-like operating systems.\n  * Setting the \"excludeFFmpeg\" property (`-PexcludeFFmpeg`) will exclude\n    FFmpeg shared libraries from the jar.\n\n## Contributing\nSee the [contributing guidelines](CONTRIBUTING.md).\n\n## Credits\nThis software was created by Jeffrey Han\n([@itdelatrisu](https://github.com/itdelatrisu/)).  All game concepts and\ndesigns are based on work by [osu!](https://osu.ppy.sh/) developer Dean Herbert\n([@ppy](https://github.com/ppy)).  Other credits can be found [here](CREDITS.md).\n\n## License\n**This software is licensed under GNU GPL version 3.**\nYou can find the full text of the license [here](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitdelatrisu%2Fopsu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitdelatrisu%2Fopsu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitdelatrisu%2Fopsu/lists"}