# 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`.