joaquin
f5d6745ed0
Full-stack IPTV management system with Xtream Codes API compatibility, multi-account provider fan-out, Jellyfin local library integration, real-time dashboard, EPG support, and A/V-sync-safe stream recovery.
45 lines
1.3 KiB
Markdown
45 lines
1.3 KiB
Markdown
# KiraTV
|
|
|
|
Sistema de proxy y gestión IPTV con soporte multiusuario y fan-out de streams.
|
|
|
|
## Stack
|
|
|
|
- **Backend**: Python 3.13 + FastAPI + asyncio
|
|
- **Base de datos**: PostgreSQL 17 + SQLAlchemy 2 + Alembic
|
|
- **Cache / estado**: Redis 8
|
|
- **Frontend**: React 18 + Vite + TailwindCSS
|
|
- **Proxy inverso**: Nginx
|
|
|
|
## Características
|
|
|
|
- Compatible con API Xtream Codes (TiviMate, Smarters, IPTV Pro…)
|
|
- Fan-out de streams: N usuarios ven el mismo canal → 1 solo slot del proveedor
|
|
- Soporte multi-cuenta del mismo proveedor con balanceo de slots
|
|
- Catálogos personalizados por usuario (live, VOD, series)
|
|
- Integración Jellyfin: biblioteca local como categorías KiraTV
|
|
- EPG XMLTV con merge por tvg-id
|
|
- Dashboard en tiempo real (WebSocket): qué usuario ve qué canal y qué slot usa
|
|
- Reconexión automática con detección de stall y A/V sync garantizado
|
|
|
|
## Instalación
|
|
|
|
```bash
|
|
cp .env.example /opt/kirastream/.env
|
|
# Editar .env con tus valores reales
|
|
|
|
cd /opt/kirastream/frontend
|
|
npm install && npm run build
|
|
|
|
cd /opt/kirastream
|
|
python3 -m venv venv
|
|
venv/bin/pip install -r backend/requirements.txt
|
|
venv/bin/python -m alembic upgrade head
|
|
```
|
|
|
|
## Configuración
|
|
|
|
Ver `.env.example` para todas las variables disponibles.
|
|
|
|
La configuración de Nginx está en `nginx/kirastream.conf`.
|
|
El servicio systemd está en `kirastream.service`.
|