FinchGramServices
라이브 방송 디렉터리

누가 라이브 방송을 하는지, 하나의 공개 목록으로

라이브 방송 소스를 모은 디렉터리입니다. 라이브 방송을 하는 Telegram 채널과 크리에이터, Owncast와 PeerTube 서버, 그리고 방송하는 쪽이 직접 제공하는 스트림이 실립니다. 디렉터리는 어디를 보면 되는지만 알려 주며, 지금 누가 라이브 방송 중인지는 앱이 각 소스에 직접 물어봅니다.

주소
https://services.finchgram.com/live/v1/
명세(OpenAPI)명세 설명
API

엔드포인트 4개

HTTPS로 제공하는 읽기 전용 JSON이며, 키도 쿠키도 필요 없습니다. 응답에는 ETag가 붙고 5분 동안 캐시해도 되며, 어떤 웹 페이지에서든 읽을 수 있습니다.

  • GET/v1/directory디렉터리 정보: 이름, 규칙이 있는 곳, 실린 소스의 수
  • GET/v1/categories소스를 나누는 카테고리와 언어별 카테고리 이름
  • GET/v1/sources종류, 카테고리, 언어, 국가, 검색어로 필터링할 수 있는 소스 목록
  • GET/v1/sources/{id}소스 하나
디렉터리 내용

소스0

아직 소스가 없습니다

디렉터리는 빈 상태로 시작하며, 모든 소스는 풀 리퀘스트로 들어옵니다.

첫 소스 추가하기
기여하기

소스 추가하기

소스는 data/live/sources/<id>.json 파일 하나이며, 풀 리퀘스트로 추가합니다. 검사를 거쳐 명세에 맞는지 확인하고, 병합되면 다음 배포부터 디렉터리에 실립니다.

소스 추가 방법

모든 소스가 갖춰야 할 조건

  • 소유자가 공개한 곳: Telegram 사용자 이름, Owncast 서버, PeerTube 채널
  • HLS 스트림은 방송하는 쪽이 직접 제공하거나 허락한 것만
  • 재생에 키, 로그인, 다른 앱의 헤더가 필요한 것은 제외
  • 성인 콘텐츠는 성인용으로 표시
셀프 호스팅

디렉터리 직접 운영하기

저장소를 포크해 내 도메인으로 Cloudflare Workers에 배포하거나, 원하는 어떤 서버에서든 같은 JSON을 제공하세요. 디렉터리는 누구나 관리할 수 있는 목록이며, 하나를 읽는 앱은 모든 디렉터리를 읽을 수 있습니다.

소스 코드