levbod: A Python repository from Ripple

Levbod

Le very basic osu!direct

A temporary osu!direct api when bloodcat goes offline

Origin: https://git.zxq.co/ripple/levbod
Mirror: https://github.com/osuripple/levbod

This software is an api with osu!direct features that can be used with the ripple static mirror. index.json's content is saved in a MySQL database, for performance reasons, and info of single beatmaps is read from the json files in b/ mirror's data folder.

Requirements

A MySQL server
Python 3.5
A working ripple static mirror.
Some Python dependencies

Installation

Make sure the mirror has downloaded all the beatmaps and it has created all the json files
Create an empty MySQL database (and user)
Import schema.sql in your database

$ mysql -u levbod -p levbod < schema.sql

Install levbod's dependencies using pip

$ pip install -r requirements.txt

Start levbod once to create a default config file and edit it

$ python3 levbod.py
$ nano config.json
...

Put index.json data in the database using convert.py (this might take a while depending on your disk speed)

$ python3 convert.py

Start the api server

$ python3 levbod.py

Nginx config

Optionally, you can configure nginx as a reverse proxy:

server {
    listen 80;
    server_name storage.ripple.moe;
    charset utf-8;

    # Ripple static mirror
    location ~ \.osz$ {
        add_header Content-Disposition 'attachment;filename="$basename";';
    }

    # Levbod reverse proxy
    location /levbod {
        rewrite ^/levbod/(.*) /$1  break;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header Host $http_host;
        proxy_redirect off;
        proxy_pass http://127.0.0.1:5588$uri$is_args$args;
    }
}

API Documentation

LICENSE

All code in this repository is licensed under the GNU AGPL 3 License. See the "LICENSE" file for more information

osuripple/levbod