README.md

metadata

title: Unified API
emoji: 🧠
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false

PopCorn Unified API

Single API space for the PopCorn Mini App — combines all features:

• Archive — orchestrate archiver spaces, track progress, check duplicates, stats
• Stream — per-account proxied streaming with account-specific datasets
• Movies / Series — TMDB-powered browse, search, genres, trending
• Auth — Telegram Mini App login
• User — profiles, watch history, lists
• Social — friends, chat, watch parties
• Store — products, assets, purchases (stars/kernels)
• Comments — ratings, reviews, likes

Architecture

upload-bot → /api/v1/archive/file → api → user[N]/archiver/receive → git push → HF dataset
                                          ↓
                                   /api/v1/archive/progress/update ← archiver reports
                                          ↓
                                   frontend polls /api/v1/archive/progress

frontend → /api/v1/stream/movie/{id} → api → user[N]/proxy/stream/{dataset}|{file}

Accounts

Key	Name	Dataset	Proxy	Archiver
user1	Mshary	multimedia-cryptography-benchmarks/archive	...-benchmarks-proxy.hf.space	...-benchmarks-archiver.hf.space
user2	Abdullah	rayig/archive	rayig-proxy.hf.space	rayig-archiver.hf.space
user3	Abdulaziz	ToolKit-backend/archive	toolkit-backend-proxy.hf.space	toolkit-backend-archiver.hf.space
user4	Tariq	Dgntsn.../archive	...-proxy.hf.space	...-archiver.hf.space