<div align="center"
<img src="media/osu-collect.png" alt="osu!collect banner" width="640"
<h1</h1
<p style="font-size: 22px" <bFree osu!collector downloader in your terminal</b</p
Features · Install · Usage · Import · Configuration · FAQ · Wiki
</div
osu!collect is a terminal app that downloads osu! beatmap collections from osu!collector. Paste a collection link, pick a folder, and every map batch-downloads using multiple mirrors in rotation with automatic failover. You also get a ready-to-import collection.db and ability to update the collections later.
<div align="center"
<img src="media/osu-collect-home.png" alt="osu!collect: paste an osu!collector collection, pick mirrors and a download folder" width="49%" <img src="media/osu-collect-downloading.png" alt="osu!collect downloading a collection with live per-map progress, speed and ETA" width="49%"
</div
Features
- Free, no account needed, whereas the official osu!Collector app is paid.
- Nine mirrors with automatic failover: osu!collect keeps downloading even when a few mirrors are throttled. See Mechanics.
- Search for maps without a collection: per-diff criteria, auto-routed between the osu! api and nzbasic's community database. See Criteria.
- A real osu! collection, verified: integrity-checked collection.db, ready to import directly into your preferred osu! client. See Verification.
- Keep collections up to date: re-check a downloaded collection later, download only new or missing beatmaps. See Guide.
Installation
One-line install (recommended)
Linux x64 / macOS Apple Silicon:
curl -fsSL https://raw.githubusercontent.com/uwuclxdy/osu-collect/main/install.sh | bashWindows x64 (PowerShell):
iwr https://raw.githubusercontent.com/uwuclxdy/osu-collect/main/install.bat -OutFile "$env:TEMP\osu-install.bat"; & "$env:TEMP\osu-install.bat"