{
  "markdown": "# Selah-Clips\n\nSelah-Clips is a virtual media ecosystem for church media teams. A private Telegram channel is the media vault, used as zero-cost cloud storage; a backend turns it into an on-demand library where a mobile or web app can instantly preview, stream, and share video clips to WhatsApp, TikTok, and Instagram.\n\nIt works on a \"Space-FS\" on-demand streaming model ([spacefs.com](https://spacefs.com/)): raw video files are streamed from the hidden channel in byte-range chunks, so a phone holds only the part it is playing or sharing. No full-file downloads, no local disk footprint. Files up to 2 GB stream because a self-hosted Telegram Bot API server bypasses Telegram's 50 MB cloud limit.\n\n## Architecture\n\n```\n[ Admin / Content Creator ]\n         │  uploads video files via the Telegram client\n         ▼\n┌──────────────────────────┐\n│ Private Telegram Channel │  Selah-Clips media vault\n└───────────┬──────────────┘\n            │  channel_post updates via Bot API (polling)\n            ▼\n┌──────────────────────────┐\n│   Listener supervisor    │  one daemon, one bot per organization\n└───────────┬──────────────┘\n            │  copies title, file_id, size, duration, thumbnail\n            ▼\n┌──────────────────────────┐\n│        PostgreSQL        │  metadata catalog for the app UI\n└───────────┬──────────────┘\n            ▲\n            │  catalog listings fetched instantly\n            ▼\n┌──────────────────────────┐\n│   App Backend API Layer  │  converts file_ids into stream URLs, proxies bytes\n└───────────┬──────────────┘\n            │  HTTPS REST API / JSON\n            ▼\n┌──────────────────────────┐\n│  Selah-Clips Client App  │  preview, stream, and share (WhatsApp, TikTok, IG etc)\n└──────────────────────────┘\n```\n\nThe manager bot (not shown) drives self-serve onboarding: it creates a managed bot for an organization and captures the channel inside Telegram, so no token is ever copied.\n\n## Repo layout\n\n```\nbackend/    the API, ingestion/reconciliation/manager workers, and local dev infra\nfrontend/   the client app (coming later)\n```\n\nThe client app talks only to the backend API, and never sees the bot token.\n\nSee `backend/README.md` to get started.",
  "bytes": 2179,
  "sha": "45790ad52e0b2fcdfb2596361f3ba66770e369c8112781e4084314de94674c2e",
  "repo_slug": "gideon-nobbs7/selah-clips",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_gideon_nobbs7_selah_clips_docs_index_md_072ff0b8/readme"
}