How tracnitww/libretv works
Project type and purpose
• LibreTV is a lightweight full-stack application combining a static front-end (HTML/CSS/JS) with serverless back-end proxy functions.
• Purpose: provide free, no-login video search and playback by aggregating multiple third-party video sources and proxying HLS streams.
File structure
• Front-end:
– index.html, player.html, watch.html, about.html, privacy.html, watch.html
– css/styles.css, js/*.js, libs/manifest.json, service-worker.js
• Back-end / proxy:
– /api/proxy/[...path].mjs (Edge function for Vercel/Cloudflare)
– /functions/ & netlify/functions/proxy.mjs (Netlify Functions)
– middleware.js, proxy.lua (for Nginx/OpenResty)
• Deployment/config:
– Dockerfile, docker-compose.yml, nginx.conf, netlify.toml, vercel.json
– GitHub Actions workflows (.github/workflows/*.yml)
– package.json (dev server via npm run dev)
Extract architectural insights from README
• Static assets served over CDN or containerized Nginx in Docker.
• Client uses HLS.js + DPlayer to play streams.
• All API calls (search, detail, HLS) go through serverless functions or proxy middleware to avoid CORS and hide source URLs.
• Optional password protection via PASSWORD env var.
• Supported hosts: Cloudflare Pages, Vercel, Netlify, Docker.