Skip to content

Releases: Lekuruu/osu.py

1.1.2

27 Aug 11:41
Compare
Choose a tag to compare

Fixed a small bug with mod flags.

Full Changelog: 1.1.1...1.1.2

1.1.1

27 Aug 11:15
Compare
Choose a tag to compare

This release will now properly read the uninstall_id and disk_signature from the system, just like the stable client would.
The setup.py file should also be a bit more reliable now.

Full Changelog: 1.1.0...1.1.1

1.1.0

26 Aug 15:53
Compare
Choose a tag to compare

API Updates

This release aims to make the WebAPI class more usable. That means that things like:

  • Rankings/Scores
  • Comments
  • Replays
  • Avatars
    and more...

are now supported.

Scores

Here is an example of how to get a beatmap's leaderboards:

game.api.get_scores(
    beatmap_checksum='be1c44c57ad5340c863971481afe561b',
    beatmap_file='Imperial Circus Dead Decadence - Uta (Kite) [Himei].osu',
    set_id=410162
)

This will return a ScoreResponse object, which contains things like

  • Beatmap Status
  • Total Scores
  • Average Rating
  • Personal Best
  • Scores

You can also get the top scores for a specific mod, by setting the rank_type attribute to SelectedMod and setting the mods attribute to your mods.

Fetching a replay

You can either get a replay from a Score object, by running score.get_replay(), or you can directly call the get_replay function over the api.

replay_data = game.api.get_replay(
    replay_id=4295091256
    mode=Mode.Osu
)

Please be aware that this will not return a full .osz file, but rather the raw replay data.
Support for .osz files will be added in the future (i hope)

Posting and fetching comments

A feature many people are not aware exists are the comments. By watching a replay, your client will automatically fetch the beatmap's comments and will show them in a nico nico douga style.

You can fetch and post comments like this:

game.api.post_comment(
    text='hi',
    time=1000,
    beatmap_id=75
)

comments = game.api.get_comments(
    beatmap_id=75
)

print(comments)

Full Changelog: 1.0.5...1.1.0

1.0.5

26 Aug 11:48
Compare
Choose a tag to compare

This release should fix issues with connecting to private servers like akatsuki.gg. It was just a little oversight in the login request, which I should have noticed earlier...

Full Changelog: 1.0.4...1.0.5

1.0.4

01 Jul 20:45
Compare
Choose a tag to compare

Fix setup.py packages

This release fixes the setup.py install script, which didn't install the full package before.

1.0.3

01 Jul 19:10
Compare
Choose a tag to compare

Fix float version parsing

This version fixes a bug when parsing the latest version of osu!, so that it now accepts float values.

1.0.2

01 Jul 18:31
Compare
Choose a tag to compare

PyPI Release

You can now access osu.py on PyPI:

pip install osu

https://pypi.org/project/osu/

1.0.1

01 Jul 18:07
Compare
Choose a tag to compare

This should hopefully fix the project name for pypi.

1.0.0

01 Jul 18:01
Compare
Choose a tag to compare

This is the first release of osu.py.
Features include:

  • Player stats
  • Chat messages
  • Spectating
  • Tourney clients

My next goal is to publish this package to pypi and maybe add some multiplayer support.

Full Changelog: https://github.com/Lekuruu/osu.py/commits/1.0.0