Commit inicial: gr-locutor (Locutor IA - GRP)

Locuciones de radio con voz IA local (XTTS-v2) integradas a G Radio Player: interfaz Rust/GTK4 de configuración, motor de generación y enriquecimiento de texto en Python, daemon de monitoreo que dispara locuciones sin pausar playlist-refill. Requiere radio-player >= 0.4.11.
2026-08-23 01:58:56 -05:00
commit 2f6b5340f5
23 changed files with 4031 additions and 0 deletions
@@ -0,0 +1,45 @@
+# 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).