# gr-locutor (Locutor IA - GRP)

Locuciones de radio generadas con voz IA local (XTTS-v2, sin depender de
APIs de voz en la nube), integradas a
[G Radio Player](https://git.gradio.net/cescobar/G-Radio-Player). Anuncia
temas, identifica la radio y agrega contenido (curiosidades, frases
motivacionales, datos de Wikipedia/MusicBrainz) sin cortar la música — se
inserta como un tema más en la cola.

> **¿Solo querés instalarlo?** Ver [`LEEME.md`](./LEEME.md) — guía paso a
> paso para usuarios finales (requisitos, instalación del paquete y del
> motor de voz, cómo habilitarlo en GRP).

## Componentes

| Parte | Qué es |
|---|---|
| `gr-locutor-config` (Rust/GTK4, `src/main.rs`) | Interfaz gráfica: elegir voz de referencia, parámetros (cada cuántos temas, ventana de locuciones adelantadas, % de identificación), botón de prueba y encendido/apagado del monitor |
| `assets/locutor-ia/generar.py` | Genera el audio de una locución con XTTS-v2 |
| `assets/locutor-ia/scripts/monitor-locuciones.py` | Daemon: decide cuándo tocan locución y dispara la generación, sin pausar `playlist-refill` |
| `assets/locutor-ia/scripts/enriquecer-locucion.py` | Arma el texto (opener + cuerpo + cierre con identificación de la radio) |
| `assets/locutor-ia/{curiosidades,frases-motivacionales,identificaciones}.txt` | Bancos de texto usados por el enriquecimiento |
| `instalar-locutor-amd64.sh` | Instala el motor XTTS-v2 en un venv aislado (`~/.gradio/locutor-venv/`), detecta GPU NVIDIA vs. CPU |

Requiere G Radio Player **0.4.11 o superior** ya instalado (expone la
bandera `locutor_auto` y el campo `fundido_exclude` que usa el locutor).

## Compilar

```bash
cargo build --release
```

## Empaquetar

```bash
./package-deb.sh 0.1.1
```

Genera `gr-locutor_<versión>_amd64.deb` con `Depends: gradio-player (>= 0.4.11)`.

## Licencia

Distribuido bajo los términos de la **GNU General Public License v3.0 o posterior**
(GPL-3.0-or-later). Ver el archivo [`LICENSE`](./LICENSE).