osu-Scripts

Scripts to help with tournament moderation/administration.

Player Verification Formatter
Takes a list of player names or IDS and outputs their name, ID and ISO country code.

Input (players.txt) | Output (playersOut.txt)
------------------- | ---------------------------
idke                | idke, 4650315, US
Vaxei               | Vaxei, 4787150, US
FreddieBenson       | Freddie Benson, 7342622, US
FlyingTuna          | FlyingTuna, 9224078, KR

Avatar Grabber
Takes a list of player IDS and outputs a <playerusername>.jpg for each player. Ready to be used in the tourney client.

Mappool Formatter
Takes in a list of beatmap URLs and outputs a bunch of info about the map.

Input (mappool.txt)         | Output (mappoolOut.txt)
--------------------------- | ---------------------------------------------------------------------------------------
https://osu.ppy.sh/b/397535 | https://osu.ppy.sh/b/397535	Kuba Oms	My Love	Insane	W h i t e	3.81	128	224
https://osu.ppy.sh/b/714001 | https://osu.ppy.sh/b/714001	Reol	No title	jieusieu's Lemur	VINXIS	6.85	200	70
https://osu.ppy.sh/b/351189 | https://osu.ppy.sh/b/351189	cYsmix feat. Emmy	Tear Rain	Insane	jonathanlfj	3.79	128	240
https://osu.ppy.sh/b/736215 | https://osu.ppy.sh/b/736215	Panda Eyes & Teminite	Highscore	Game Over	Fort	7.37	110	257

Note: mappoolOut.txt is tab separated and can be pasted into Excel / Google Sheets

Nginx Generator Takes a list of subdirectories and URLs from input file redirects.txt and outputs a formatted nginx.conf file.

Input (redirects.txt)
---------------------
subdirectory1;url1
subdirectory2;url2
subdirectory3;url3
subdirectory4;url4
subdirectory5;url5

Qualifier Lobby Score Grabber Takes a match mp ID and extracts each player's score for every map played.

Input                                          | Output (scores.txt)
-----------------------------------------------|------------------------------
py "Qualifier Lobby Score Grabber.py" 63914035 | 10764012	644782	454702	583059	422898	273094	625559	818564	724987	660406	290249
                                               | 10625283	998179	932252	448007	699542	480633	478420	644893	1053060	638284	916920

Note: scores.txt is tab separated and can be pasted into Excel / Google Sheets. Note: The first result is the player ID, followed by each map they played in chronological order.

Usage

Create a file named settings.py containing your osu! api key in the format:
apiKey = '<api token>'

Player Verification Formatter

1. Create a file named players.txt containing one player name per line.
2. Run the script: python "Player Verification Formatter.py".
3. A file named playersOut.txt will be created containing the output.

Avatar Grabber

1. Create a file named players.txt containing one player name per line.
2. Run the script: python "Avatar Grabber.py".
3. A directory names icons/ will be created containing files for each users avatar.

Mappool Formatter

1. Create a file named mappool.txt containing one beatmap URL per line. URLs can be old or new style, but must link to a beatmap, not a map set. E.g. https://osu.ppy.sh/b/397535 or https://osu.ppy.sh/beatmapsets/163112#osu/397535.
2. Run the script: python "Mappool Formatter.py".
3. A file named mappoolOut.txt will be created containing the output.

Customisation

To change what's output from the files, only a basic understanding of Python is required.

Take a look at the osu! API Reference V1 and look up if the information you want is returned by the api. Then edit the script where it accesses the values in playerJson or bmapJson.

E.g. From playerJson['username'] to playerJson['<some other value>']