Über den Syui Mirror

📌 Was ist der Syui Mirror?

Der Syui Mirror ist ein vollständig eigener Beatmap-Mirror, optimiert für maximale Geschwindigkeit...

Ideal für Spieler, Websites, Tools und jeden, der eine schnelle, zuverlässige osu!-Datenquelle benötigt.

Search Docs

✨ Features

• 🔍 Leistungsstarke Beatmap-Suche...
• 📦 Mirror/Download von .osz-Dateien
• 🎧 Audio-Extraktion & Streaming
• 🖼️ Lokales Caching von Coverbildern
• 📁 Zugriff auf .osu Metadateien
• 📊 Difficulty-Rechner API
• 🚀 Voll-Asynchron
• ♻️ Auto-Refresh (7 Tage)
• 💡 Entwickelt für hohe Parallelität

🧭 API Übersicht

Die wichtigsten API-Routen:

🔍 Suche

/api/search?query=&amount=…&offset=…&mode=&status=

📥 Download

/d/{set_id}

🗂️ Metadaten

/osu/{beatmap_id}
    /c/{beatmap_id}?modstr=HDHR
    /api/b/{beatmap_id}
    /api/s/{set_id}
    /api/md5/{checksum}

🎧 Audio

/audio/{set_id}

🖼️ Cover/Thumb

/beatmaps/{set_id}/covers/cover
/thumb/{file}

Alle Endpunkte unterstützen Cache & 304.

🔎 Erweiterte Filtersuche

Der Search-Parser unterstützt Felder:

artist=Camellia
title="Blue Zenith"
ar>9
bpm<120
stars>=6
playcount>10000
tags=remix drum
    

Auch kombiniert:

artist=xi bpm>180 stars>5 ar>=9

🛠️ Technischer Aufbau

Der Mirror läuft auf:

• FastAPI
• uvloop + httptools
• MariaDB
• httpx / aiohttp
• FS-Cache
• Redis

💻 Für Entwickler

Der Mirror ist offen nutzbar und liefert JSON.

Beispiel: Beatmaps abrufen

GET /api/search?query=artist=camellia&mode=0&amount=50

Beispiel: Metadaten laden

GET /api/s/1234567

Beispiel: .osz herunterladen

GET /d/123456

Beispiel: Audio Preview

GET /audio/123456

Beispiel: Cover

GET /beatmaps/123456/covers/cover

Syui Mirror - powered by Eternityglow

Dies ist kein offizieller osu!-Dienst.