Versión 1.0.0. Autor: Héctor J. Benítez Corredera (xebolax@gmail.com).
zRadio BASS es un reproductor de radios por Internet para el lector de pantalla Tiresias. Usa la API pública de Radio Browser para acceder a decenas de miles de emisoras de todo el mundo y el motor de audio BASS para reproducirlas, sin instalar nada más.
Características:
Abra el menú de Tiresias, entre en Herramientas y elija zRadio BASS. También puede asignar un gesto a la orden «Muestra la ventana principal de zRadio BASS» (ver Órdenes globales).
Si la opción «Verificar la conexión a Internet al abrir la ventana» está activada (lo está por defecto) y no hay conexión, se avisa con el mensaje «zRadio necesita conexión a Internet para funcionar».
Tiene cuatro pestañas (General, Favoritos, Buscador e Historial) y, debajo, los controles de reproducción:
| Tecla | Acción |
|---|---|
| Intro o Espacio | Reproduce la emisora seleccionada en la lista |
| F1 | Dice la posición en la lista («3 de 120») |
| Aplicaciones o Mayúsculas+F10 | Menú contextual de la emisora |
| Control+1 a Control+4 | Van a la pestaña General, Favoritos, Buscador o Historial y ponen el foco en su lista |
| Alt+V | Va al control de volumen |
| Alt+Flecha arriba / Alt+Flecha abajo | En Favoritos (orden personal): sube o baja la emisora |
| Suprimir | En Favoritos elimina la emisora (pide confirmación); en Historial quita la entrada |
| Escape | Cierra la ventana; la radio sigue sonando |
Cuando una emisora empieza a sonar, el foco pasa al botón Detener; al pulsarlo, vuelve a la lista de la pestaña. La ventana recuerda la última pestaña usada y su tamaño.
Muestra las emisoras de un país. En el cuadro País están primero «Todas las populares» (las más votadas del mundo) y los países más habituales (España, México, Argentina, Colombia, Chile, Perú, Venezuela, Ecuador, Estados Unidos, Reino Unido, Francia, Alemania, Italia, Brasil y Portugal) y después todos los demás por orden alfabético. Elija uno y pulse Cargar emisoras (Alt+G); el país elegido se recuerda.
El cuadro Filtrar y el botón Buscar reducen la lista a las emisoras cuyo nombre contiene el texto (sin importar tildes ni mayúsculas). Tras filtrar, el botón pasa a llamarse Limpiar y vuelve a mostrar todas.
Para mover favoritos con Alt+Flecha arriba y Alt+Flecha abajo, use el orden personal, todas las categorías y ninguna búsqueda. El orden personal es el que usan las órdenes «Reproducir favorito 1» a «5» y «Siguiente/anterior favorito».
Cada vez que suena una emisora que está en favoritos, se cuenta la reproducción y se guarda la fecha; aparecen en la información de la emisora.
Muestra las últimas 100 emisoras escuchadas (la más reciente primero) con la fecha, la hora y el tiempo escuchado. Mostrar más añade otras 100, Quitar del historial (o Suprimir) borra la entrada seleccionada y Limpiar historial... borra todo o solo lo anterior a 7, 30 o 90 días.
En las listas de las cuatro pestañas, la tecla Aplicaciones abre un menú con:
En el Historial, además, Quitar del historial.
Grabar la emisora actual: desde Herramientas > Grabación o con la orden «Iniciar grabación de la emisora actual». Se graba lo que suena en un archivo WAV (calidad de CD, unos 10 MB por minuto) llamado Emisora_AAAAMMDD_HHMMSS.wav. La grabación no se ve afectada por el volumen, el silencio ni el ecualizador. Se detiene con «Detener grabación», al detener la radio o al cambiar de emisora.
Programar una grabación: indique la emisora y su URL (o pulse Elegir de favoritos...), la fecha y hora de inicio y de fin con el formato DD/MM/AAAA HH:MM (por ejemplo, 25/12/2026 18:30) y el nombre del archivo. Si hay una emisora sonando, el diálogo ya viene relleno con ella.
nombre (2).wav) hasta la hora de fin.Las grabaciones se guardan en la carpeta Música del usuario, salvo que elija otra en las opciones.
Como en el original, ninguna orden tiene un gesto asignado de fábrica. Asígnelos en el menú de Tiresias, Preferencias > Gestos de entrada, categoría zRadio BASS. Funcionan desde cualquier aplicación, con la ventana abierta o cerrada.
| Orden | Qué hace |
|---|---|
| Muestra la ventana principal de zRadio BASS | Abre la ventana (o la trae al frente) |
| Subir volumen de la radio | Sube el paso de volumen (5 % de fábrica) y dice el nuevo valor, o «Volumen al máximo» |
| Bajar volumen de la radio | Baja el volumen, o dice «Volumen al mínimo» |
| Detener reproducción de la radio | Detiene la radio |
| Pausar o reanudar la radio | Pausa o reanuda la emisora |
| Recargar la emisora actual | Vuelve a conectar con la emisora |
| Silenciar o restaurar el audio | Silencia o quita el silencio (se guarda) |
| Anunciar la emisora en reproducción | Dice «Emisora:» y su nombre |
| Anunciar el título de la canción que suena | Dice el título que envía la emisora |
| Anunciar información del estado del reproductor | Emisora, canción, volumen, silencio y grabaciones |
| Anunciar estado de grabación | Si se graba y cuánto tiempo lleva, y cuántas grabaciones hay programadas |
| Iniciar grabación de la emisora actual | Empieza a grabar lo que suena |
| Detener grabación actual | Detiene y guarda la grabación |
| Abrir diálogo para programar grabación | Abre «Programar grabación» |
| Ver las grabaciones programadas | Abre la lista de grabaciones programadas |
| Reproducir la última emisora escuchada | Vuelve a poner la última emisora |
| Reproducir favorito 1 a Reproducir favorito 5 | Reproduce el favorito de esa posición (orden personal) y dice su nombre |
| Reproducir siguiente favorito / Reproducir favorito anterior | Recorre los favoritos en círculo y dice «2 de 10. Nombre» |
Menú de Tiresias, Preferencias > Opciones, categoría zRadio BASS (o Herramientas > Configuración... en la ventana). El botón de valores de fábrica del cuadro de Opciones restablece todas.
| Opción | De fábrica | Qué hace |
|---|---|---|
| General | ||
| Verificar la conexión a Internet al abrir la ventana | Sí | Si no hay conexión, avisa en lugar de abrir la ventana |
| Recordar la última emisora reproducida | Sí | Permite «Reproducir la última emisora» |
| Reproducir la última emisora al iniciar Tiresias | No | Al arrancar Tiresias vuelve a sonar la última emisora |
| País de la pestaña General | España | País que se carga al abrir la ventana |
| Número máximo de resultados de búsqueda | 10000 | Límite de emisoras de la pestaña General y del Buscador |
| Ocultar las emisoras que no funcionan | No | Quita de las listas las emisoras que Radio Browser marca como caídas |
| Reproducción | ||
| Dispositivo de salida | Predeterminado de Windows | Tarjeta de sonido o auriculares por los que suena la radio (se cambia al momento, sin cortar) |
| Paso del volumen (%) | 5 | Cuánto suben o bajan las órdenes de volumen |
| Reconectar automáticamente si se corta la emisora | Sí | Hasta 5 intentos seguidos |
| Anunciar el título de cada canción nueva | No | Dice el título cuando la emisora lo cambia |
| Anunciar cuando la emisora empiece a sonar | No | Dice «Conectado:» y el nombre |
| Efectos de sonido | ||
| Graves, Medios y Agudos (dB) | 0 | Ecualizador de −12 a +12 dB en 100 Hz, 1000 Hz y 8000 Hz |
| Balance | 0 | De −100 (izquierda) a 100 (derecha) |
| Caché | ||
| Habilitar caché de resultados | Sí | Guarda las búsquedas y las listas de países, idiomas y etiquetas para no pedirlas otra vez |
| Duración de la caché (días) | 3 | De 1 a 30 días. El botón Vaciar la caché ahora la borra |
| Grabaciones | ||
| Carpeta para guardar las grabaciones | (vacía: carpeta Música) | Con Examinar... y Usar la carpeta por defecto |
El volumen, el silencio, la última emisora, la última pestaña, el tamaño de la ventana y los ajustes del Buscador y de Favoritos se guardan solos al momento.
zRadio BASS admite plugins: archivos .py que amplían el reproductor. Vienen dos:
En Herramientas > Plugins > Administrar plugins... se ven todos los plugins con sus datos (versión, autor, descripción, estado, origen, archivo y último error), se activan y desactivan con la casilla, se configuran (los que tienen opciones), se recargan y se abre la carpeta de plugins del usuario.
Para escribir uno, copie example_plugin.py (carpeta globalPlugins\zRadioBASS\plugins del complemento) en data\addonsData\zRadioBASS\plugins, cambie PLUGIN_ID y el nombre de la clase y pulse «Recargar plugins». Un plugin es una clase que hereda de PluginBase:
from zradiobass import PluginBase, EventType
class MiPlugin(PluginBase):
PLUGIN_ID = "mi_plugin"
PLUGIN_NAME = "Mi plugin"
PLUGIN_VERSION = "1.0.0"
PLUGIN_AUTHOR = "Yo"
PLUGIN_DESCRIPTION = "Dice el nombre de cada emisora"
def on_load(self):
self.subscribe(EventType.PLAYBACK_STARTED, self.al_empezar)
return True
def on_unload(self):
return True
def al_empezar(self, station):
self.app.speak("Suena " + station.name)
Del módulo zradiobass se pueden importar PluginBase, EventType, Station, Favorite, Category, PlaybackHistory, ScheduledRecording, SearchFilters, PlayerState, format_duration y log. En el plugin están self.app (con speak, message, player, db, api, config, play_station...), self.event_bus, self.subscribe (las suscripciones se cancelan solas al descargar), self.settings y self.save_settings() (opciones que se guardan), self.data_dir y los métodos opcionales get_menu_items, get_context_menu_items(contexto) (contexto "station" o "favorite"; el callback recibe la emisora), get_settings_panel(padre) (panel wx con un método save()), on_enable y on_disable. PLUGIN_DEPENDENCIES lista los plugins que deben cargarse antes.
Eventos: inicio, fin, pausa, reanudación y error de reproducción; inicio y fin de la carga; cambios de volumen y silencio; título de la canción; favoritos y categorías añadidos, quitados, cambiados o reordenados; búsquedas; apertura y cierre de la ventana y cambio de pestaña; carga, descarga y error de plugins; cambios de configuración; conexión a Internet; grabaciones iniciadas, detenidas y programadas; cambios en las grabaciones programadas y en el historial.
En la carpeta data\addonsData\zRadioBASS de Tiresias (no en la del complemento, que se sustituye al actualizar):
zradiobass.db: favoritos, categorías, historial, grabaciones programadas y listas de países, idiomas y etiquetas.cache\api_cache.db: caché de las búsquedas.estado.json: volumen, silencio, última emisora, pestaña, tamaño de la ventana, plugins desactivados y opciones de los plugins.statistics.json: estadísticas de uso.plugins: sus plugins.Las opciones están en la configuración de Tiresias (sección zRadioBASS).
globalPlugins\zRadioBASS\bass, junto con su aviso LICENCIA-BASS.txt.