← Volver al Blog
Wails React TypeScript TailwindCSS Go Open Source Desktop

Cómo construí RadioCubana: una app de escritorio open source para escuchar todas las emisoras de Cuba

Un reto personal que se convirtió en un proyecto real: construir una app de escritorio con Wails, React y TypeScript que agrega más de 100 emisoras cubanas en un solo lugar.

· 8 min de lectura Ariel Hechavarria

Si hay algo que nos une a los cubanos dentro y fuera de la isla, es la radio. Escuchar Radio Rebelde, Radio Reloj o Radio Progreso nos conecta con nuestra tierra, nuestra música y nuestra identidad.

Hace un par de días me propuse un reto personal: construir una aplicación de escritorio que permitiera escuchar todas las emisoras cubanas en un solo lugar, con una interfaz moderna, rápida y con opciones como modo oscuro, favoritos y búsqueda.

El resultado es RadioCubana, una app open source construida con Wails, React, TypeScript y TailwindCSS. En este artículo quiero compartir el proceso, las tecnologías que usé y los desafíos que enfrenté.

🚀 El objetivo

Crear una aplicación que:

  • Ofrezca reproducción en vivo de más de 100 emisoras cubanas (nacionales, provinciales y municipales).
  • Tenga una interfaz limpia y responsive.
  • Incluya modo oscuro/claro con persistencia.
  • Permita buscar y filtrar por nombre, categoría y provincia.
  • Guarde favoritos entre sesiones.
  • Muestre información detallada de cada emisora (descripción, provincia, municipio, imagen).

Además, quería que los datos estuvieran siempre actualizados, así que desarrollé un scraper automático que extrae información de Wikipedia, EcuRed y el portal oficial de Radio Cubana.


🛠️ Tecnologías utilizadas

Backend (aplicación de escritorio)

  • Wails: Un framework que combina Go en el backend con React en el frontend para crear aplicaciones nativas rápidas y livianas.
  • Go: Para la lógica del backend (mínimo en este caso, ya que la app es principalmente frontend con Go embebido).

Frontend

  • React 18 + TypeScript: Para una interfaz robusta y tipada.
  • TailwindCSS: Para estilos rápidos y consistentes, con soporte para modo oscuro.
  • Zustand: Para el manejo de estado global (con persistencia en localStorage).
  • Heroicons: Para iconos profesionales.

Scraper de datos

  • Node.js + TypeScript: Para el script que obtiene las emisoras.
  • Axios + Cheerio: Para hacer peticiones HTTP y parsear HTML.
  • API de Wikipedia: Para obtener resúmenes e imágenes.
  • Scraping personalizado de EcuRed y del portal radiocubana.cu.

🧠 Desafíos y cómo los resolví

1. Obtener la lista completa de emisoras

No existía una API pública con todas las emisoras. Tuve que:

  • Scrapear Wikipedia (tabla de emisoras cubanas).
  • Scrapear el portal oficial (paginación de 4 páginas).
  • Scrapear EcuRed para obtener descripciones e imágenes.

Solución: Creé un scraper en Node.js que unifica las tres fuentes, elimina duplicados y enriquece cada emisora con la mejor información disponible (priorizando EcuRed sobre Wikipedia).

2. Manejar la reproducción de audio en vivo

Las emisoras usan streams en formato MP3/AAC. Usé el elemento <audio> de HTML5, que maneja la reproducción sin problemas y no requiere dependencias externas.

3. Persistencia de favoritos y modo oscuro

Con Zustand y el middleware persist, los favoritos y la preferencia de tema se guardan automáticamente en el localStorage entre sesiones.

4. Experiencia visual atractiva

  • Dos modos de visualización: lista y cuadrícula.
  • Imágenes generadas para emisoras sin logo (usando ui-avatars.com).
  • Modal de información con descripción detallada de cada emisora.

📦 El código

El proyecto es 100% open source. Puedes explorarlo, clonarlo, contribuir o usarlo como inspiración.

🔗 Repositorio: github.com/arielhechavarriaj/radioCubana


💡 Lecciones aprendidas

Wails es una alternativa real a Electron. Las apps son mucho más livianas y consumen significativamente menos memoria. Para proyectos pequeños y medianos, es una opción excelente que merece más atención de la comunidad.

El scraping requiere ética. Siempre respeté el robots.txt y añadí pausas entre peticiones para no saturar los servidores. Si usas datos de terceros, asegúrate de hacerlo de forma responsable.

TypeScript + Zustand + Tailwind es un combo imbatible para el frontend. La combinación de tipado fuerte con gestión de estado simple y CSS utilitario acelera el desarrollo sin sacrificar mantenibilidad.


🎯 Próximos pasos

  • Añadir notificaciones de escritorio cuando cambie la canción (si el stream lo permite).
  • Integrar atajos de teclado globales (espacio para play/pause, flechas para cambiar de emisora).
  • Publicar la app en la Microsoft Store para facilitar la instalación.

Si tienes sugerencias, issues o quieres contribuir, el repositorio está abierto. La mejor manera de crecer profesionalmente es compartir lo que hacemos y aprender de los demás.