Über den Syui Mirror

📌 Was ist der Syui Mirror?

Der Syui Mirror ist ein vollständig eigener Beatmap-Mirror, optimiert für maximale Geschwindigkeit, permanentes Caching und flexible Suchfeatures. Er lädt Beatmaps, Cover, Audio und Metadaten direkt vom osu!-CDN, cached sie lokal und stellt sie als Mirror sofort zur Verfügung.

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

Search

✨ Features

• 🔍 Leistungsstarke Beatmap-Suche mit Query-Parser (artist=, ar>, bpm<…)
• 📦 Mirror/Download von .osz-Dateien
• 🎧 Audio-Extraktion & Streaming (.mp3/.ogg)
• 🖼️ Lokales Caching von Coverbildern & Thumbnails (mit ETag/304 Support)
• 📁 Zugriff auf .osu Metadateien
• 📊 Difficulty-Rechner API (Mods, AR/OD Overrides usw.)
• 🚀 Voll-Asynchron (FastAPI + aiohttp/httpx + MariaDB)
• ♻️ Auto-Refresh bei veralteten Dateien (7-Tage Intervall)
• 💡 Entwickelt für hohe Parallelität (uvloop, httptools, caching)

🧭 API Übersicht

Die wichtigsten API-Routen, die du in Tools, Websites oder Bots nutzen kannst:

🔍 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 Caching, proper MIME Types und 304-Response Handling.

🔎 Erweiterte Filtersuche

Der Search-Parser unterstützt dynamische Feldabfragen:

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 (voll async)
• uvloop + httptools für maximale Geschwindigkeit
• MariaDB für Beatmapsets & Beatmaps
• httpx / aiohttp für parallele Downloads
• lokalem FS-Cache für:
  • .osz
  • .osu
  • Audio
  • Covers / Thumbnails

💻 Für Entwickler

Der Syui Mirror ist offen nutzbar für Websites, Tools oder Community-Projekte. Alles liefert JSON (oder Raw-Text, wenn du die osu!direct Kompatibilität brauchst).

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.