RETROTV

Una tele de tubo de los 90, en pequeño.
Enciende, sintoniza y entra en un canal que ya estaba emitiendo.

RETROTV es el firmware de una tele en miniatura hecha con una placa ESP32-S3 con pantalla de 2,8″. Cada canal es una programación en bucle que sigue la hora real: al sintonizar entras a mitad de capítulo, con la estática y el destello de una tele de los 90. Los vídeos salen de una microSD, y por Wi-Fi llegan el mando del móvil, la guía y los canales de un servidor en casa.

_{El encendido del firmware, fotograma a fotograma.}

Empieza aquí · Variantes · Qué hace · Documentación · Estado · Créditos

• Placa: Freenove ESP32-S3 Display 2.8″, FNK0104A (sin táctil) o FNK0104B (con táctil). Pines comprobados en la guía de hardware.
• microSD en FAT32 con esquema MBR. Las de más de 32 GB vienen en exFAT, que el firmware no lee: hay que formatearlas.
• Cable USB-C de datos. La placa usa el USB nativo del ESP32-S3; no hace falta ningún driver.
• Altavoz para el conector de la placa (JST de 1,25 mm, 2 pines). El proyecto usa uno de 40 × 28 mm.
• Un ordenador con Git, PlatformIO Core 6.x (el comando pio), ffmpeg y python3. Los ejemplos usan rutas de macOS; en Linux, cambia /Volumes/RETROTV por el punto de montaje de tu tarjeta.
• Opcional: una LiPo de una celda con JST 1,25 (antes de conectarla, lee la comprobación de polaridad), y los pulsadores y el LED de la carcasa (cableado). Para montar una carcasa completa: lista de materiales y orden de montaje.

Sin carcasa ni batería: solo la placa, el altavoz y la microSD. El clip de prueba lo genera tools/make_demo_clip.sh con ffmpeg, así que no hace falta ningún vídeo.

1. Descarga el código:

   git clone https://github.com/ipaud/RetroTV.git
   cd RetroTV

2. Formatea la microSD en FAT32 con esquema MBR y llámala RETROTV. En macOS: Utilidad de Discos → Borrar → formato «MS-DOS (FAT)» y esquema «Registro de arranque principal».

3. Crea el clip de demostración en la tarjeta:

   tools/make_demo_clip.sh /Volumes/RETROTV

   Escribe retrotv/media/demo/demo.mjpeg, demo.aac y su índice demo.idx (30 s; un segundo argumento cambia la duración). Es la carta testsrc de ffmpeg con un contador: cada segundo, un destello blanco y un pitido. Necesita ffmpeg; python3 crea el índice.

4. Expulsa la tarjeta y métela en la placa.

5. Conecta la placa por USB-C y graba el firmware. La primera vez, PlatformIO descarga la plataforma y tarda un rato:

   pio run -e pautv -t upload

   pautv sirve para la placa suelta. Para tu montaje, mira la tabla de variantes.

6. Mira el registro de la tele (abrir el puerto reinicia la placa):

   pio device monitor

7. Qué deberías ver: al arrancar, la tele crea /retrotv/config/channels.json con los canales de ejemplo y sintoniza el canal 1, RETROTV DEMO. Si el destello y el pitido coinciden, el audio y el vídeo van sincronizados. Con la placa suelta, un clic en BOOT pasa al canal siguiente y un doble clic vuelve al anterior. Los canales 2 y 3 están vacíos hasta que conviertas vídeos (salen como NO SIGNAL y la tele pasa al siguiente), el 8 es el teletexto y el 9 la carta de ajuste.

Si la subida falla porque no aparece el puerto: mantén BOOT, pulsa RESET, suelta BOOT y vuelve a lanzarla. Si dice No serial data received, basta con repetirla.

1. Convierte tus vídeos (solo los que tengas derecho a usar). Sin terminal: con RetroTV Importar, una app de Mac que va en la propia tarjeta (descarga o importer/install.sh /Volumes/RETROTV), se suelta una carpeta y sale un canal nuevo; también prepara las tarjetas nuevas en exFAT. O a mano, a la carpeta del canal 2, «CANAL 1»:

   tools/convert_video.sh ~/Videos/MiSerie /retrotv/media/channel01 /Volumes/RETROTV

   Formatos, opciones (pista de audio, calidad, recorte 4:3) y tiempos: convertir capítulos.

2. Ordena los canales editando /retrotv/config/channels.json: nombres, números, carpetas, teletexto, carta de ajuste y canal del mando. Referencia completa: canales. Ejemplo: data/example-config/channels.json.

3. Añade la Wi-Fi (solo 2,4 GHz) en /retrotv/config/wifi.json, a partir de wifi.example.json. Con ella llegan la hora, el mando web en http://retrotv.local y los canales del servidor en casa. Sin Wi-Fi, la tele funciona igual desde la SD. Detalle: Wi-Fi.

Todas usan la misma placa. Cambian la carcasa, cómo se maneja y el entorno de PlatformIO que se graba.

• Cableado de teclas y LED: la guía de hardware. Las teclas van entre su GPIO y GND, y el LED, con una resistencia de ~1 kΩ, al TXD del conector UART (GPIO43).
• «Hey Retro»: su modelo no se distribuye en el repositorio porque se entrenó con datos de uso no comercial. Sin él, la app de standby compila igual y solo escucha «Hola ESP» y las palmadas. Cómo entrenar el tuyo, cómo se graba la app y lo medido: la guía del wake word. tools/standby_flash.sh está escrito para macOS.
• Compilar y grabar cada entorno, con sus opciones: desarrollo.

_{Renders de la tele90 v9: tres piezas y cuatro teclas.}

_{Renders de la tele90 v10 sin botones: frontal y cuerpo, que cierran con 8 imanes, y solo el LED en el frontal.}

La carcasa es un diseño propio y sus archivos (STL) no están publicados, ni los de la v9 ni los de la v10. Una v10 con teclas vendrá más adelante. Medidas y piezas: la guía de hardware.

• 📺 Canales en emisión. Cada canal es una programación en bucle anclada a la hora real: al sintonizar entras en el capítulo y el segundo que tocan, y si vuelves luego, ha seguido avanzando.
• 🎞️ Vídeo fluido. MJPEG de 320 × 240 a 20 fps con sonido AAC sincronizado, leído por delante de la SD.
• ⚡ Zapeo de verdad. Estática con siseo y destello de tubo entre canales, OSD con número y nombre, carta de ajuste, NO SIGNAL y un apagado que recoge la imagen en una línea.
• 📟 Teletexto con la guía real. Qué echa ahora cada canal, cuánto le queda y qué viene después.
• 📱 Mando web. http://retrotv.local en el móvil: canales, volumen, lista con logos, guía y ajustes, sin app ni nube. Cuatro diseños de mandos de época.
• 📡 Canales por red. RETROTV Server, en un ordenador o un NAS de casa, convierte archivos y directos públicos (3Cat, RTVE, Pluto TV) al formato de la tele.
• 👏 Palmadas y mensajes (firmware voice). Tres palmadas apagan y encienden; una grabadora deja mensajes de hasta 15 s en un canal MENSAJES. Todo dentro de la tele, sin Internet.
• 🔋 Portátil. LiPo dentro, avisos de batería en pantalla y en el mando, y reposo con la batería agotada.

_{Escenas del canal 0, el vídeo de bienvenida del proyecto (no está en el repositorio).}

flowchart LR
  SD["microSD<br/>tus vídeos"] --> TV["RETROTV<br/>ESP32-S3"]
  SRV["RETROTV Server<br/>ordenador o NAS · FFmpeg"] -- "MJPEG + AAC por Wi-Fi" --> TV
  WEB["3Cat · RTVE · Pluto TV<br/>HLS públicos"] --> SRV
  PHONE["Móvil<br/>mando web"] -- "retrotv.local" --> TV
  NTP["NTP"] -. "hora" .-> TV

Todos los detalles, los modos de apagado, la batería y el LED: controles. El mando del móvil, con sus diseños, la guía y el emparejamiento: mando web.

_{Los cuatro mandos del móvil, capturados de la página real con canales y logos inventados.}

RETROTV es un proyecto personal en desarrollo. Se ha probado en una sola placa, una FNK0104A sin táctil; el detalle de cada prueba está en el plan de pruebas.

Probado en la placa: vídeo local a 20 fps con audio sincronizado, canales en emisión, zapeo, mando web y ajustes, canales por red y directos, lectura y carga de la batería, palmadas, STANDBY VOZ, grabadora y mensajes, el LED del frontal y, en pruebas, «Hola ESP» y «Hey Retro».

Pendiente o sin medir:

• RetroTV Importar: probada en un Mac con Apple Silicon sobre tarjetas simuladas (imágenes FAT32 y exFAT), la parte Intel con Rosetta; falta una microSD de verdad, un Mac con Intel y el primer arranque de una copia descargada (TEST_PLAN).
• Las cuatro teclas montadas en la carcasa: su lógica solo está probada en el ordenador.
• El táctil: solo existe en la FNK0104B y no se ha probado en ninguna.
• Apagar con tres palmadas con la tele encendida (TV21).
• Autonomía y consumo: las cifras de batería son estimaciones sin medidor, salvo la carga del 81 al 99 % en unas 2 h 45 min. El aviso del LED con la batería baja aún no se ha visto con una descarga real.
• «Hola ESP» y «Hey Retro» son experimentales: aciertos y falsos positivos medidos en una sola sala y con una sola voz (resultados).

Límites conocidos:

• Solo Wi-Fi de 2,4 GHz y microSD en FAT32 (no exFAT; RetroTV Importar convierte una tarjeta exFAT, borrándola).
• Las órdenes del mando web no llevan PIN: cualquiera en tu Wi-Fi puede cambiar de canal. Los ajustes sí piden emparejar el móvil, y solo uno a la vez.
• Las contraseñas Wi-Fi quedan en texto plano, en wifi.json de la SD o en include/secrets.h.
• No hay comandos de voz: las palabras de activación solo encienden la tele.
• La carcasa no está publicada.

• arduino-libhelix es GPL-3.0. Si en el futuro se distribuye el binario del firmware a terceros, habrá que revisar las obligaciones de GPL o sustituir el decodificador AAC. Para uso personal no hay ningún problema.
• standby/src/MicroWakeWord.* es GPL-3.0 (adaptado de ESPHome; texto en LICENSES/GPL-3.0.txt), y con él la app de standby compilada; lo mismo que con arduino-libhelix.
• Código de RETROTV: licencia MIT (LICENSE), salvo los archivos marcados con otra licencia.
• Carcasa: tele90 v9 y v10, diseño propio; sus archivos no están en este repositorio.
• Contenido: series, películas, logos de canales y directos son de sus dueños y no forman parte del proyecto. El repo no incluye ni enlaza vídeos: cada uno pone en la SD los suyos o los que tenga derecho a usar.