LautBox Cover API

Automatischer Cover-Generator für Radiosender und Musik-Streaming. Unterstützt laut.fm, Shoutcast und manuelle Song-Abfragen.

Zur Dokumentation Forum-Thread
Blitzschnell

Caching & API-Limits für optimale Performance

Zuverlässig

Automatisches Fallback-Bild bei Fehlern

Flexibel

Mehrere Modi für verschiedene Anwendungsfälle

Base URL

https://cover.lautbox.eu/

API Endpunkte

laut.fm Station

GET ?mode=lautfm

Ruft das Cover des aktuell laufenden Songs einer laut.fm Station ab.

Parameter
Parameter Typ Pflicht Beschreibung
mode string Ja Muss "lautfm" sein
station string Ja Name der laut.fm Station
Beispiel
https://cover.lautbox.eu/?mode=lautfm&station=1chaos71

Datenbank Station

GET ?mode=database

Lädt eine Station anhand ihrer Datenbank-ID und ruft das aktuelle Cover ab.

Parameter
Parameter Typ Pflicht Beschreibung
mode string Ja Muss "database" sein
id integer Ja Datenbank-ID der Station
Beispiel
https://cover.lautbox.eu/?mode=database&id=1

Manueller Song

GET ?mode=song

Sucht das Cover für einen beliebigen Song anhand von Artist und Titel.

Parameter
Parameter Typ Pflicht Beschreibung
mode string Ja Muss "song" sein
artist string Ja Name des Künstlers
title string Ja Titel des Songs
Beispiel
https://cover.lautbox.eu/?mode=song&artist=Coldplay&title=Yellow

Shoutcast Server

GET ?mode=shoutcast

Verbindet sich mit einem Shoutcast-Server und ruft das aktuelle Cover ab.

Parameter
Parameter Typ Pflicht Beschreibung
mode string Ja Muss "shoutcast" sein
protocol string Ja "http" oder "https"
ip string Ja IP-Adresse oder Domain
port integer Ja Port des Servers
sid integer Ja Stream-ID
Beispiel
https://cover.lautbox.eu/?mode=shoutcast&protocol=http&ip=example.com&port=8000&sid=1

Icecast Server

GET ?mode=icecast

Liest die Now-Playing-Metadaten eines Icecast-Servers (über status-json.xsl) aus und ruft das passende Cover ab.

Parameter
Parameter Typ Pflicht Beschreibung
mode string Ja Muss "icecast" sein
protocol string Ja "http" oder "https"
host string Ja Hostname oder IP des Icecast-Servers
port integer Ja Port des Servers (z.B. 8000, 443)
mount string Ja Mount-Point (z.B. /stream.mp3)
Beispiel
https://cover.lautbox.eu/?mode=icecast&protocol=https&host=stream.example.com&port=443&mount=/stream.mp3

AzuraCast Server

GET ?mode=azuracast

Spricht die Now-Playing-API eines AzuraCast-Servers direkt an und liest strukturierte Artist-/Title-Daten aus.

Parameter
Parameter Typ Pflicht Beschreibung
mode string Ja Muss "azuracast" sein
host string Ja Hostname des AzuraCast-Servers
station string Ja Shortcode/Name der Station
Beispiel
https://cover.lautbox.eu/?mode=azuracast&host=azura.example.com&station=mystation

Response

Content-Type: image/jpeg

Header: X-User-Agent: LautBoxCover/2.0.0

Bei Fehlern oder wenn kein Cover gefunden wurde, wird automatisch ein Fallback-Bild zurückgegeben.

HTML Beispiel

<img src="https://cover.lautbox.eu/?mode=lautfm&station=chillout" alt="Album Cover" width="300" height="300" />

LautBox Cover API v2.0.0

Entwickelt für die laut.fm Community | info@lautbox.eu