Guest
home
beatmaps
rankings
community
store
help
forum
  1. Forums
  2. osu!
  3. Development

Yet another beatmap mirror + data API.

posted
Total Posts
73
show more
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Thanks for reporting, I could find actual bug in code. But what I found was that search was performed during beatmap update, since duplicate records are not in database. It should not contain duplicate result for any other similar searches, except for that exact one, since its cached.
It will clear up eventually :)

1. Yup, found few other duplicate beatmaps too. Will be fixed in few moments.
2. Fixed, those duplicate entries from search will go away once cache entry expires ( could take a while :P )
Piotrekol
1,002 posts
Joined March 2010
Piotrekol
My friend can't run this program under 32Bit system(Win XP)
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Its .NET 4.5 app. It does not seem that it was released for WinXP.
So the only suggestion I could give now, is to upgrade.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Added option to view beatmap details on this site:


If anyone has suggestions, ideas; feel free to share. If possible I will implement them.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Added menu bar.
Moved settings to separate window.
Added ability to change concurrent download limit.
Added a bunch of links to 'Help' menu.
Recommended concurrent downloads are recommended to be kept bellow 6. Exception would be for people who have extremely good connection to beatmap mirror ( 8MB/s and up ).
Mine is set at 30 because I have direct 1Gbit connection to server.

And as always, updated files at:
http://miz.hexide.com/mirror/Beatmap%20Mirror.exe
http://miz.hexide.com/mirror/Beatmap%20Mirror.pdb

http://miz.hexide.com/dDld.png
http://miz.hexide.com/AbD9.png
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Added option to disable question window when closing app.
Added download finished animations to download queue.
Some minor tweaks that I forgot.
Debug build: ( provides useful information in case of crashes )
http://miz.hexide.com/mirror/Beatmap%20Mirror.exe
http://miz.hexide.com/mirror/Beatmap%20Mirror.pdb
Release: ( does not display debug console, slightly higher performance )
http://miz.hexide.com/mirror/Beatmap%20 ... elease.exe
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Spent good while configuring nginx and added some more feature to main api: ;)
  1. Raw access to beatmap file contents: /beatmaps/12191/content/raw /beatmaps/12191/content/raw/background.jpg
  2. File hash calculations for raw beatmap files: /beatmaps/12191/content/raw/hash/noise/1.png
  3. Raw file layout: /beatmaps/12191/content/raw/layout
  4. Now all invalid requests should receive API friendly 400 response.
  5. All responses are now cached for 24 hours.
Notes:
  1. If requested beatmap was not extracted prior to accessing raw files, they will be extracted once and "Location" header will be served to request.
  2. Documentations coming soon.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
It seems that there are allot of users that don't have user agent set. Who is writing apps/scripts/services that use this api, please specify user agent ( something relevant ) and if its public projects that has thread on this forum, please specify thread in Referrer header like "/t/137156".

Preferred minimal http request structure ( this is example ):
GET /search/maps.title.like.night HTTP/1.1
Host: api.osu.miz.hexide.com
User-Agent: Osu!Mirror
Referer: /t/137156
Connection: Keep-Alive
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Added some basic stats: http://api.osu.miz.hexide.com/stats
ALLOT MORE coming soon.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
And I broke everything. Api responses no longer contain "status" => "....".
Response code 200 = everything is good. 300 >= error.

Documentations will be updated in a moment.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Updated mirror app to support new api structure.

Debug build: ( provides useful information in case of crashes )
http://miz.hexide.com/mirror/Beatmap%20Mirror.exe
http://miz.hexide.com/mirror/Beatmap%20Mirror.pdb
Release: ( does not display debug console, slightly higher performance )
http://miz.hexide.com/mirror/Beatmap%20 ... elease.exe
Ephemeral
Inland Empire
3,945 posts
Joined April 2009
Ephemeral
this is an excellent, well documented service. thank you for hosting it!
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Well looks like project is pretty stable state.
All features that I had in mind are implemented and documented.

I also wrote small php class a while ago that could be used with api:
Class: https://gist.github.com/Mizore/5939745
Usage: https://gist.github.com/Mizore/5939747
wwared
3 posts
Joined October 2012
wwared
A bug report (I'm not sure if you have another place for these:
When doing a GET /beatmaps (http://api.osu.miz.hexide.com/beatmaps), the documentation says the result should include:
		name: "31066 DJ YOSHITAKA - SEED",
		title: "DJ YOSHITAKA - SEED",
		type: "osz",
However, the API actually responds with, for all the maps:
        "name": "1 Kenji Ninuma - DISCO PRINCE",
        "title": null,
        "type": "Kenji Ninuma - DISCO PRINCE",

For some reason "title" is always null and "type" contains the beatmap title (and there is no way to get the type information).
It doesn't seem like this happens on other API requests, but I haven't checked them all.

Thanks a lot for this service; it's very well documented!
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Whoops. Fixed. Issue was that i forgot to place comma in between 'title' and 'type' columns :v

It might still show broken version, should take up to hour for cache entry to expire.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Also fixed minor big that caused all images returned from api to be full size.
Fixed issue where beatmaps with no wallpaper would still return status 200 response.
Now instead of 404 response on beatmap images, stock icon would be returned (also resized and cropped)
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
If anyone is curious in API source code: http://git.hexide.com/Miz/osuapi

Also threw in database dump ( no data ).
http://git.hexide.com/Miz/osuapi/commit ... 90cd51dbb6
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Just realised that beatmaps were not updated for past 10 days (last successful update was on 2013-11-12 00:00:20).
Fixed issue and following beatmaps were updated:
Avail_old_1
Avail_old_1
It's kind of broken :(
Download MP3s opens the queue window, puts the song in it, and closes it. (Both on debug and release.)
Download Beatmap crashes the app in debug, freezes the app in release. :(
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide

Avail wrote:

It's kind of broken :(
Download MP3s opens the queue window, puts the song in it, and closes it. (Both on debug and release.)
Download Beatmap crashes the app in debug, freezes the app in release. :(
Possibly due to missing directories where downloads pointed to. That is the only thing that comes to my mind at the moment.

You could try using latest version: http://miz.hexide.com/mirror/BeatmapMir ... 3adfd2.exe
Avail_old_1
Avail_old_1
Everything is pointed to my downloads so I doubt it's a missing dir.
EDIT: Same thing happens with latest build..
EDIT2: Just noticed ( a couple hours late ) how the app actually downloaded the .mp3, well, a blank one.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide

Avail wrote:

Everything is pointed to my downloads so I doubt it's a missing dir.
EDIT: Same thing happens with latest build..
EDIT2: Just noticed ( a couple hours late ) how the app actually downloaded the .mp3, well, a blank one.
Does http://api.osu.miz.hexide.com/ open up properly for you?
Avail_old_1
Avail_old_1

Hexide wrote:

Does http://api.osu.miz.hexide.com/ open up properly for you?
Yup. Works fine.
Howl
1,121 posts
Joined June 2013
Howl

? :(
It crashes every time I try to open it :(
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Make sure you are using http://miz.hexide.com/mirror/BeatmapMir ... 3adfd2.exe and make sure you have http://www.microsoft.com/en-us/download ... x?id=30653 installed.
Howl
1,121 posts
Joined June 2013
Howl
After installing Framework 4.5 it works.
Thanks.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Small update:
Removed details window (because it was not about to get finished any time soon).
Added double click download.
Added option that would prevent/allow download queue window to be automatically hidden when download is finished.
Added bit more debug logging.
Updated address to project repository.
Release build: http://miz.hexide.com/mirror/BeatmapMirror.8077c5ce9.exe
Git: http://git.hexide.com/Miz/osumirror/compare/d903adfd2...8077c5ce9
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Whoops, looks like last successful beatmap update was at 2013-12-26 00:00:11. I updated php and forgot to install one module, which led to beatmaps not updating properly.

All is fixed. Might take couple hours to grab all new beatmaps.
Lense_old_1
1 post
Joined May 2012
Lense_old_1
I have a few things that could be improved:

5513 doesn't seem to be valid. When I download it I get an md5 of 57a75e4030beb6174089c6f91fcf9a5d while the info says 3fcfe7eae40a8fa86e2d151ee536735 (also md5 of the valid map from http://osu.ppy.sh/s/5513)
Edit: 19491, 8442, 14431, 17796, 41482, 17796, 18879, 12292, 13422, 1735 and 2533 all look invalid. Am I doing something wrong?

There are a number of spelling mistakes. If you want, I can make a list.

On http://api.osu.miz.hexide.com/doc#/get/beatmaps/id it says
"Request data: [0-9]+ Can be any integer, ranked beatmap id"
which is correct, but on every other page (e.g. http://puu.sh/6zh7e.png) it just says "beatmap id" which led me to use id instead of ranked_id everywhere.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Right, they don't seem to be entirely correct.
Ill fix it asap ( 3 - 4 days hopefully, since I'm in the middle of moving out )
Woddles
69 posts
Joined December 2012
Woddles
Hey, first of all I just wanted to say great job on the API. It's extremely helpful for me, having data request via MD5 hash.

One problem I ran into though, is when using the metadata request (Example: http://api.osu.miz.hexide.com/metadata/9e63d9a0b139c5953101e5eaf77af809), 'm_beatmap' and 'm_beatmapset' don't seem to be displaying (Image example).

Any chances this could be fixed? Would be extremely helpful so I only have to make a single request rather than multiple per map.

Thanks!
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide

Woddles wrote:

Hey, first of all I just wanted to say great job on the API. It's extremely helpful for me, having data request via MD5 hash.

One problem I ran into though, is when using the metadata request (Example: http://api.osu.miz.hexide.com/metadata/9e63d9a0b139c5953101e5eaf77af809), 'm_beatmap' and 'm_beatmapset' don't seem to be displaying (Image example).

Any chances this could be fixed? Would be extremely helpful so I only have to make a single request rather than multiple per map.

Thanks!
Hey, that data is missing because it was not present in beatmap at the time of parsing. It will show up when will become available. Also multiple requests is not a problem.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Sorry for down time, ISP blew up.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Fixed issue where all output which was returned from cache did not have 'Access-Control-Allow-Origin'.
Now all responses have it ( its set to `*` ).
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Just realized one feature was never documented or announced.
API supports AND OR logic for filtering, for example of supported queries:
  1. where m_title like dark OR m_artist like m2u - Wide range of beatmaps, containing beatmaps containing only `dark` in title or `m2u` as artist
  2. where m_title like dark AND m_artist like m2u - Only one result, beatmap which contains `dark` in title and `m2u` as artist
Also added into docs: http://api.osu.miz.hexide.com/doc#/get/search
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Fixed issue with new php5 version which caused beatmaps not to be updated.
These (http://miz.hexide.com/IKgZ8MaU.html) beatmaps could have been out of date for up to 7 days.
- Marco -
7,378 posts
Joined December 2011
- Marco -
I can't click on tools :c
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide

marcostudios wrote:

I can't click on tools :c
Nothings there. Never actually anyone requested anything.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
API LOCATION CHANGE:
https://osu.hexide.com/
Kirito_Beater
3 posts
Joined January 2013
Kirito_Beater
Hey Hexide, I can't access to http://osu.miz.hexide.com/beatmaps/ anymore since a month or so.
Is it a oversight or did you do it on purpose?
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
It's at https://osu.hexide.com
Kirito_Beater
3 posts
Joined January 2013
Kirito_Beater

Hexide wrote:

It's at https://osu.hexide.com
Nope sorry I didn't specify, I meant the beatmaps mirror.
There are just the API there (or am I missing something?).
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide

Kirito_Beater wrote:

Hexide wrote:

It's at https://osu.hexide.com
Nope sorry I didn't specify, I meant the beatmaps mirror.
There are just the API there (or am I missing something?).
Oh, the list for direct downloads. Will enable it in few moments.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
At https://osu.hexide.com/list/
Kirito_Beater
3 posts
Joined January 2013
Kirito_Beater

Hexide wrote:

At https://osu.hexide.com/list/
Wow that was fast!
Thank you,
Have a nice day. :)
ziniman
16 posts
Joined December 2011
ziniman
Hey, have you updated your mirror?
It seems that it's missing newer maps like this and this.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Hi, yes, it is not synchronizing with main beatmap repo. Will fix later today.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Back on online.

https://osu.hexide.com/doc
https://osu.hexide.com/stats

Beatmap archive is massively out of date, will look into synchronizing it later today.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Recovered.
Beatmaps still syncing, so far 84k done... ~25% done.

- Cleared stats
- Added missing documentation for /cache/
- Fixed issue where no JSON would be returned for /beatmaps/[0-9]+/content/raw/layout

Also nice to see that opsu! client is still using this API :)
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Pushed small update to desktop application:
https://git.hexide.com/miz/osumirror/co ... ..6f5d9a09

If someone wants a binary build:
https://mega.nz/#!pnpyTJjQ!yVtUeoGMbwz4 ... 8ZRlODC8y0
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Updated API, added support to filter beatmaps by:
* maps.hash_md5
* maps.hash_sha1
* metadata.hash_md5
* metadata.hash_sha1

* metadata.a_beatmapset_id
* metadata.a_beatmap_id
* metadata.a_approved
* metadata.a_total_length
* metadata.a_hit_length
* metadata.a_bpm
* metadata.a_max_combo

These all values come from original API (https://github.com/ppy/osu-api/wiki)

Something that app developers might want to implement is filter by: a_approved
Here are few examples:
* https://osu.hexide.com/search/maps.rank ... oved.eq.-2 - graveyeard
* https://osu.hexide.com/search/maps.rank ... roved.eq.1 - ranked

P.s. Data update is still in progress for beatmaps, not all maps have metadata.a_* fields populated.
Please sign in to reply.

New reply

0
23 / 73