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

Yet another beatmap mirror + data API.

posted
Total Posts
73
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Hello, I have decided to open up my mirror to public. Here you will find details how to use it and information about it.

General info:
  1. Mirror is updated every 6 hours
  2. Mirror contains only ranked beatmaps
  3. Server can upload at maximum 300mbps
How to access mirror and beatmaps:
  1. Direct link to files on the web: https://osu.hexide.com/list/
  2. Desktop application: https://mega.nz/#!pnpyTJjQ!yVtUeoGMbwz4HjJOqqb3lrfw1Me9zHQx68ZRlODC8y0 (-Source code-)
API LOCATION:
https://osu.hexide.com/

Statistical data:
SPOILER
Global network utilisation (maximum 300/300mbps):
Soon
Last edited by Hexide , edited 10 times in total.
Kyujuroku 96
246 posts
Joined August 2010
Kyujuroku 96
Added to the osu! Projects Compilation thread. Keep the good work!!!
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Started updating api to extend functionality. http://api.osu.miz.hexide.com/
Meantime search page will not be working.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Started working on small c# for multiple simultaneous beatmap downloads. It's still in extremely early stages https://github.com/Mizore/osu-mirror
Implemented few metadata lookups into api http://api.osu.miz.hexide.com/#/get/metadata/id ; http://api.osu.miz.hexide.com/#/get/metadata/id/raw

Search calls are coming soon.
Primula_old
Primula_old
This is really nice, thank you.
Will implement it into osu!np soon~
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide

Primula wrote:

This is really nice, thank you.
Will implement it into osu!np soon~
That would be great! If you will have any requests/recommendations, feel free to poke me.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Coded search api. There might still be some future updated, but that wont be soon. Currently it works pretty well.
http://api.osu.miz.hexide.com/#/get/search documentations are still being written.

Also, please don't kill server. :D
power007
88 posts
Joined June 2011
power007
Very cool ftp, fast speed. I'm going to download everything xD
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide

power007 wrote:

Very cool ftp, fast speed. I'm going to download everything xD
Cheers. :)
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Also did some big updates to how search works now.
In a nutshell, you need to pass one or more search parameters. Search query will look like "/search/[param]/[param]/[param]".

Each parameter is made of 4 peaces: "[table].[column].[operand].[value]" some examples of this would be:
  1. metadata.name.like.fade
  2. maps.size.gt.100000000
  3. maps.title.like.dance
Possible operands are:
  1. eq - equal
  2. lt - less than
  3. lteq - less than or equal
  4. gt - greater than
  5. gteq - greater than or equal
  6. like - like
There are also some limitations like:
  1. You cannot use lt, lteq, gt, gteq with VARCHAR columns
  2. You cannot use like with INT and DOUBLE columns
  3. You can only use eq with ENUM columns
For list of all columns, please refer to: http://api.osu.miz.hexide.com/#/db/maps and http://api.osu.miz.hexide.com/#/db/metadata

Hopefully this will be useful for someone. :)
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
If any graphic artists would be willing to help me out, it would be amazing. I need someone to change some colors in few bitmaps.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Implemented few more api requests:

http://api.osu.miz.hexide.com/beatmaps/ ... review/mp3
http://api.osu.miz.hexide.com/beatmaps/ ... image/tiny
http://api.osu.miz.hexide.com/beatmaps/ ... mage/small
http://api.osu.miz.hexide.com/beatmaps/ ... age/medium
http://api.osu.miz.hexide.com/beatmaps/ ... image/full

And simple documentations done: http://api.osu.miz.hexide.com/doc#/get/beatmaps/id/preview

Edit:
Added custom size support: http://api.osu.miz.hexide.com/beatmaps/89831/preview/image/custom/700x600
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Allot of progress on c# app for beatmap downloads.
Here are some images:
http://miz.hexide.com/XSgE.png
http://miz.hexide.com/bUdy.png

More coming soon! :)

If someone is interested in testing it out:

Main EXE: http://miz.hexide.com/mirror/Beatmap%20Mirror.exe
Debug symbols: http://miz.hexide.com/mirror/Beatmap%20Mirror.pdb

For paranoid: https://github.com/Mizore/osu-mirror
nanashiRei
228 posts
Joined April 2011
nanashiRei
I like the for paranoid part, going to start doing some icons for you today. :)
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
App now remembers last used download locations.
https://github.com/Mizore/osu-mirror/commit/ac62eaadb08b0a3a478117fba04c4355a3d43402
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
past few day change digest:

Fixed registry issue where data would be be saved to incorrect location.
Added support for enter clicks on text boxes to perform search instead of clicking 'Search' button.
Files no longer will contain first capital letter in their extension.
Files will no longer be taking up more space than they should Issue #1
Added sorting support for standard list-view.
Added MP3 file download support.
Download audio files will no longer have numbers at the start of their names.
Added support for changing count of threads used for downloading file ( currently only changeable in registry )
Updated files:
Main EXE: http://miz.hexide.com/mirror/Beatmap%20Mirror.exe
Debug symbols: http://miz.hexide.com/mirror/Beatmap%20Mirror.pdb

Also, GitHub page if you want to track progress: https://github.com/Mizore/osu-mirror
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Bringing mirror down for some core improvements, could take few hours.
Back

Some more updates: Should be done within few hours.
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Looks like everything is updated and restored :D , there are some major changes:
  1. Now ALL beatmap related images and other files will be under /content rather than /preview
  2. API is no longer user friendly, what i mean by that, calling /download on some beatmap will not start download with original beatmap name
  3. Removed /preview/mp3/full/download
  4. Removed /preview/image/tiny,small,medium,large (only full and custom options are left)
And as always, most recent file:
Main EXE: http://miz.hexide.com/mirror/Beatmap%20Mirror.exe
Debug symbols: http://miz.hexide.com/mirror/Beatmap%20Mirror.pdb

https://github.com/Mizore/osu-mirror
TheAussie
128 posts
Joined January 2011
TheAussie
the exe doesnt work just crashes...
Piotrekol
1,002 posts
Joined March 2010
Piotrekol

Takeda Shingen wrote:

the exe doesnt work just crashes...
and I thought I'm the only one...
this happens after clicking search
Hexide
70 posts
Joined January 2012
Topic Starter
Hexide
Hmm... Made small change in code as potential fix, how ever not sure if it will help.

Updated files:
Main EXE: http://miz.hexide.com/mirror/Beatmap%20Mirror.exe
Debug symbols: http://miz.hexide.com/mirror/Beatmap%20Mirror.pdb

P.S. There will be no search results if you will not enter at least one letter into any search field.
Piotrekol
1,002 posts
Joined March 2010
Piotrekol
working now.
(and found duplicate entry- http://puu.sh/3v6qW.png)
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,946 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.
show more
Please sign in to reply.

New reply

0
1 / 73