osu! Tools on Docker

Runs osu-tools in a Docker container.

• Supports switching branches for both osu and osu-tools.

Example

Use the master branch

By default, running docker compose up --build will use the master branch.

git clone https://github.com/Eve-ning/osu-tools-docker.git
cd osu-tools-docker/
docker compose up

It will spin up a container osu-tools, which you can access via docker exec

docker exec -it osu.tools sh

It will run shell, which then you can use commands in osu-tools

dotnet PerformanceCalculator.dll difficulty 767046

ruleset: mania

╔═══════════════════════════════════════════════════════════════╤═══════════╤═════════╤════════════════╗
║beatmap                                                        │star rating│max combo│great hit window║
╟───────────────────────────────────────────────────────────────┼───────────┼─────────┼────────────────╢
║767046 - typeMARS - Triumph & Regret ([ A v a l o n ]) [Regret]│       5.48│ 3,994.00│           38.00║
╚═══════════════════════════════════════════════════════════════╧═══════════╧═════════╧════════════════╝

Use forks and branches

For example, if you want to use:

1. The osu branch: https://github.com/Eve-ning/osu/tree/osu-tools-docker-testbranch
2. The osu-tools branch: https://github.com/Eve-ning/osu-tools/tree/impl-strain-json

Your .env should look like

OSU_GIT="https://github.com/Eve-ning/osu.git"
OSU_GIT_BRANCH="osu-tools-docker-testbranch"
OSU_TOOLS_GIT="https://github.com/Eve-ning/osu-tools.git"
OSU_TOOLS_GIT_BRANCH="impl-strain-json"

Follow the same procedure above

dotnet PerformanceCalculator.dll difficulty 767046

As our osu branch inflates the SR, it should rise.

ruleset: mania

╔═══════════════════════════════════════════════════════════════╤═══════════╤═════════╤════════════════╗
║beatmap                                                        │star rating│max combo│great hit window║
╟───────────────────────────────────────────────────────────────┼───────────┼─────────┼────────────────╢
║767046 - typeMARS - Triumph & Regret ([ A v a l o n ]) [Regret]│      16.01│ 3,994.00│           38.00║
╚═══════════════════════════════════════════════════════════════╧═══════════╧═════════╧════════════════╝