Über den Syui Service

Ein eigenständiger Beatmap-Service für das Eternityglow-Netzwerk - mit Suche, API und Download für custom hochgeladene Maps.

ℹ️ Wichtiger Hinweis

Syui ist kein Mirror von osu.ppy.sh. Hier findest du ausschließlich Beatmaps, die direkt über Eternityglow eingereicht und gehostet wurden. Bancho/offizielle osu!-Beatmaps werden nicht gespiegelt.

📌 Was ist Syui?

Syui ist der interne Beatmap-Service des Eternityglow-Netzwerks. Alle Maps, die du hier findest, wurden direkt von Community-Mappern hochgeladen und werden von uns gehostet - nicht gespiegelt.

Der Service stellt Suche, Download und Metadaten für diese custom Uploads bereit und versorgt damit unseren Game-Server, das Web-Frontend und Community-Tools.

Suche Docs

✨ Features

🔍 Leistungsstarke Beatmap-Suche mit Query-Parser
📦 Download eingereichter .osz-Dateien
🎧 Audio-Extraktion & Preview-Streaming
🖼️ Cover- und Thumbnail-Auslieferung
📁 Zugriff auf .osu-Metadateien
📊 Difficulty-Rechner API
🚀 Voll-Asynchron (FastAPI)
💡 Für hohe Parallelität ausgelegt

🧭 API Übersicht

Die wichtigsten API-Routen. Alle Endpunkte liefern ausschließlich Daten zu custom Eternityglow-Maps:

🔍 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 und 304-Responses.

🔎 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 Service läuft auf:

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

💻 Für Entwickler

Die API ist frei nutzbar und liefert JSON. Beachte: die zurückgegebenen Daten beziehen sich ausschließlich auf Maps, die über Eternityglow eingereicht wurden.

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/preview

Beispiel: Cover

GET /beatmaps/123456/covers/cover

Syui Service - powered by Eternityglow

Dies ist kein offizieller osu!-Dienst und kein Mirror von osu.ppy.sh.