FinchGramServices
Live-Verzeichnis

Wer live geht, in einer offenen Liste

Ein Verzeichnis von Livequellen: Telegram-Kanäle und Creator, die live gehen, Owncast- und PeerTube-Server sowie Streams, die Sender selbst anbieten. Es zeigt, wo man nachschauen kann, nicht, wer gerade live ist: Das fragt eine App bei jeder Quelle selbst ab.

Adresse
https://services.finchgram.com/live/v1/
API-Vertrag (OpenAPI)Erklärung des API-Vertrags
API

Vier Endpunkte

Schreibgeschütztes JSON über HTTPS, ohne Schlüssel und ohne Cookies. Die Antworten enthalten ein ETag und dürfen fünf Minuten lang zwischengespeichert werden, und jede Webseite darf sie lesen.

  • GET/v1/directoryWas das Verzeichnis ist: sein Name, wo seine Regeln stehen und wie viele Quellen es führt
  • GET/v1/categoriesDie Kategorien, in die seine Quellen eingeordnet sind, in jeder Sprache benannt
  • GET/v1/sourcesDie Quellen, gefiltert nach Art, Kategorie, Sprache, Land oder Stichwörtern
  • GET/v1/sources/{id}Eine Quelle
Im Verzeichnis

Quellen0

Noch keine Quellen

Das Verzeichnis ist anfangs leer: Jede Quelle kommt per Pull-Request hinzu.

Die erste hinzufügen
Mitmachen

Eine Quelle hinzufügen

Eine Quelle ist eine einzige Datei, data/live/sources/<id>.json, die per Pull-Request hinzugefügt wird. Eine Prüfung gleicht sie mit dem API-Vertrag ab, und sobald sie übernommen ist, liefert das Verzeichnis sie ab dem nächsten Deployment aus.

So fügst du eine Quelle hinzu

Was jede Quelle sein muss

  • Ein Ort, den sein Inhaber öffentlich gemacht hat: ein Telegram-Benutzername, ein Owncast-Server, ein PeerTube-Kanal
  • Ein Stream über HLS nur vom Sender selbst oder mit seiner Erlaubnis
  • Nichts, was zum Abspielen einen Schlüssel, eine Anmeldung oder die Header einer anderen App braucht
  • Inhalte für Erwachsene, als solche gekennzeichnet
Selbst hosten

Betreibe dein eigenes Verzeichnis

Forke das Repository und stelle es unter einer eigenen Domain auf Cloudflare Workers bereit, oder liefere dasselbe JSON von einem Server deiner Wahl aus. Ein Verzeichnis ist eine Liste, die jeder führen kann: Eine App, die eines liest, liest sie alle.

Quellcode