FinchGramServices
直播目录

谁会开直播，都在一张开放的清单里

一个直播源目录：会开直播的 Telegram 频道和创作者、Owncast 和 PeerTube 服务器，以及广播机构自己提供的直播流。它只告诉你去哪里看，不告诉你现在谁在直播：这要由 app 自己去问每个直播源。

地址
https://services.finchgram.com/live/v1/
契约（OpenAPI）契约说明
API

四个接口

通过 HTTPS 提供只读的 JSON，不需要密钥，也不用 cookie。响应带有 ETag，可以缓存五分钟，任何网页都能读取。

  • GET/v1/directory这个目录是什么：它的名称、规则在哪里，以及收录了多少直播源
  • GET/v1/categories直播源所属的分类，附各语言的名称
  • GET/v1/sources所有直播源，可按种类、分类、语言、国家或关键词筛选
  • GET/v1/sources/{id}单个直播源
目录收录

直播源0

还没有直播源

目录一开始是空的：每个直播源都要通过 pull request 加进来。

添加第一个
参与贡献

添加直播源

一个直播源就是一个文件 data/live/sources/<id>.json，通过 pull request 添加。自动检查会对照契约校验它；合并之后，目录从下一次部署起就会提供它。

如何添加直播源

对每个直播源的要求

  • 所有者自己公开的地方：Telegram 用户名、Owncast 服务器、PeerTube 频道
  • HLS 流只能来自播出它的广播机构，或经其许可
  • 播放时不需要密钥、登录或其他应用的请求头
  • 成人内容须明确标注
自建

运行你自己的目录

把这个仓库 fork 过去，用你自己的域名部署到 Cloudflare Workers 上；或者用你喜欢的任何服务器提供同样的 JSON。目录就是一张谁都能维护的清单：能读一个目录的 app，就能读所有目录。

源码