Circleload
📩 Command line osu! beatmap downloader
Circleload is a versatile CLI to easily download osu! beatmaps.
It supports filtering by gamemode and ranked status, different mirrors and
multiple downloads.
https://user-images.githubusercontent.com/38820196/142741654-67cc917a-ef51-4032-882a-463c5a14df6f.mp4
Install
Prebuilt Binaries
See the latest release.
amd64
is for 64bit and 386
is 32bit. arm64
is for 64bit ARM like the M1.
Manual build
For users with Go installed (minimum version 1.17):
go install github.com/TorchedSammy/Circleload@latest
Or:
git clone https://github.com/TorchedSammy/Circleload
cd Circleload
go get
go build
Usage
Basic usage is very simple. Circleload can take 3 types of arguments:
- A search query:
./circleload "1,000,000 times"
- Beatmap (set) URL:
./circleload https://osu.ppy.sh/beatmapsets/1588063
- Beatmap set ID:
./circleload 1588063
It can also take a variable amount of these, for mass download use.
Filters
For a search query, Circleload supports providing filters.
Supported filters:
mode
: Beatmap gamemode. Accepts osu
, standard
, taiko
, mania
, and catch
status
: Ranked status. Accepts ranked
, loved
, graveyard
, pending
, approved
, qualified
and wip
License
MIT