Songtexte in LoboTune

Ein Server für LoboTune setzt die Songtext-Schnittstelle von LoboTune um. Sie besteht aus einer Anfrage:

GET <Adresse>/api/search?track_name=<Titel>&artist_name=<Interpret>

• Die Adresse darf einen Pfad haben: Aus https://example.org/songtexte wird https://example.org/songtexte/api/search?….
• Nur HTTPS. Adressen mit http:// nimmt die App nicht an.
• Optional genau ein Header mit einem Schlüssel, zum Beispiel X-Api-Key. Die App schickt ihn nur an diese Adresse, bei einer Weiterleitung auf einen anderen Host nicht.
• Antwort: Status 200 und eine JSON-Liste. Passt nichts, ist die Liste leer ([]). Mit 401 oder 403 meldet die App, dass ein gültiger Schlüssel fehlt.

[
  {
    "trackName": "Die Gedanken sind frei",
    "artistName": "Volkslied",
    "plainLyrics": "Die Gedanken sind frei,\nWer kann sie erraten?\n…",
    "syncedLyrics": null,
    "instrumental": false
  }
]

• trackName, artistName: Titel und Interpret des Treffers. Die App vergleicht sie mit dem laufenden Song.
• plainLyrics: der Text, Zeilen durch \n getrennt, Strophen durch eine Leerzeile.
• syncedLyrics: optional, Zeilen mit Zeitmarken wie [00:12.50]. LoboTune nimmt ihn nur, wenn plainLyrics fehlt, und zeigt ihn ohne Zeitmarken.
• instrumental: true für Stücke ohne Text.

Fehlende Felder sind erlaubt, unbekannte werden übergangen. Beim Speichern der Adresse fragt die App einmal mit track_name=lobotune&artist_name=lobotune und erwartet eine Liste; eine leere genügt. Danach fragt sie nur, wenn du den Songtext eines Songs öffnest, und schickt dabei dessen Interpret und Titel an deinen Server.

1. Öffne Einstellungen → Songtext-Server.
2. Trage unter Server-Adresse die Adresse deines Servers ein.
3. Verlangt dein Server einen Schlüssel, trage Header-Name und Header-Wert ein. Der Schlüssel wird auf dem Gerät verschlüsselt abgelegt und gehört nicht zur Sicherungsdatei.
4. Tippe auf Prüfen und verwenden. Die App übernimmt die Adresse erst, wenn der Server richtig antwortet.

Beispielserver eintragen zeigt, wie das Eintragen abläuft. Der Beispielserver liefert keine Songtexte, nur einen Hinweis. Mit Entfernen fragt LoboTune wieder niemanden nach Songtexten.