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.