FreeRadio — NVDA Add-on

FreeRadio es un complemento de radio por Internet para el lector de pantalla NVDA. Su principal objetivo es proporcionar a los usuarios un fácil acceso a miles de estaciones de radio por Internet. Toda la interfaz y todas las funciones se han diseñado teniendo en cuenta la accesibilidad total para NVDA.

El Directorio de Radio Browser

FreeRadio utiliza la base de datos abierta de Radio Browser por su catálogo de estaciones. Radio Browser es un directorio gratuito impulsado por la comunidad que alberga más de 50.000 estaciones de radio por Internet de todo el mundo. No se requiere registro ni cuenta y su API está abierta a todos. Cada estación incluye información sobre dirección, país, género, idioma y bitrate; las estaciones se clasifican según los votos de los usuarios. FreeRadio se conecta a esta API a través de servidores espejo ubicados en Alemania, Países Bajos y Austria; Si un servidor es inaccesible, pasa automáticamente al siguiente.

Añadir una estación a Radio Browser

Si una estación que está buscando no aparece en el directorio de Radio Browser, puedes enviarlo tú mismo a https://www.radio-browser.info/add. No es necesario tener cuenta ni registrarse.

Llene el formulario en esta página:

• Stream URL (requerido) — la URL directa del flujo de audio, terminando en .mp3, .aac, .ogg o similar. Esta no es la dirección del sitio web de la estación; esta es la dirección del flujo bruto de transmisión que pegarías en un reproductor multimedia. La mayoría de las estaciones publican la URL de su flujo de transmisión en su sitio web o en su sección "Escuchar en directo".
• Station name (requerido) — el nombre de la estación como debería aparecer en el directorio.
• Homepage — la dirección del sitio web de la estación.
• Country and language — seleccione el país y el idioma de transmisión en las listas desplegables.
• Tags — palabras clave separadas por comas, por genre o topic, por ejemplo news, jazz, classical. Estos se utilizan para buscar y filtrar.
• Logo URL — un enlace directo a la imagen del logotipo de la estación, si está disponible.

Después del envío, la estación se revisa y se añade al directorio público. Una vez aceptado, aparecerá automáticamente en los listados de países y de búsqueda de FreeRadio, ya que el directorio se actualiza desde la API en directo.

Requisitos

• NVDA 2024.1 o posterior
• Windows 10 o posterior
• Conexión a Internet

Instalación

Descarga el archivo .nvda-addon, pulsa Intro y reinicia NVDA cuando se te solicite.

Atajos de teclado

Todos los atajos se pueden reasignar desde el Menú NVDA → Preferencias → Gestos de Entrada → FreeRadio. Estos atajos funcionan desde cualquier lugar, independientemente de qué ventana tenga el foco.

Los atajos siguientes/anteriores sólo recorren la lista de favoritos; No funcionan con la lista de todas las estaciones. Cuando una lista tiene el foco en la ventana del navegador, las teclas de flecha izquierda y derecha tienen el mismo propósito — ver la sección de Atajos en el cuadro de diálogo.

Navegador de Estaciones

FreeRadio también añade un subMenú FreeRadio en el Menú Herramientas de NVDA. Desde allí puede abrir directamente el Navegador de Estaciones y los Ajustes de FreeRadio.

La ventana abierta con Ctrl+Win+R contiene cinco pestañas: Todas las estaciones, Favoritos, Grabación, Temporizador y Canciones favoritas. Puedes navegar entre las pestañas con Ctrl+Tab.

Cuando se abre la pestaña Todas las estaciones, las 1000 estaciones más votadas se cargan automáticamente desde Radio Browser. Al seleccionar un país de la lista desplegable, se actualiza la lista para mostrar estaciones de ese país. Al escribir en el cuadro de búsqueda se realiza instantáneamente una búsqueda completa en toda la base de datos de Radio Browser simultáneamente por nombre, país y género.

La lista desplegable Dispositivo de salida en la parte inferior de la ventana del navegador (fuera de las pestañas) enumera todos los dispositivos de salida de audio reconocidos por BASS. Al seleccionar un dispositivo, se redirige inmediatamente la salida de audio a él y se guarda la elección de forma permanente; el mismo dispositivo se utiliza automáticamente en la siguiente sesión. Si el dispositivo seleccionado no está conectado, el complemento vuelve automáticamente al valor predeterminado del sistema. Este control solo funciona cuando el BASS backend está activo.

Los controles de Volumen (0–200) y Efectos en la misma área se puede ajustar en cualquier momento cuando la ventana está abierta. Desde la lista de Efectos, Coro, Compresión, Distorsión, Eco, Flanger, Gargle, Reverberación, EQ: Bass Boost, EQ: Treble Boost y EQ: Vocal Boost se puede activar simultáneamente; Los cambios se aplican instantáneamente al flujo activo. Estos controles solo son completamente funcionales cuando el BASS backend está activo.

Cuando uno o más efectos de EQ están habilitados, aparece un control de ganancia para cada banda activa. La ganancia se puede configurar entre −15 dB y +15 dB; los valores predeterminados son Bass +9 dB, Treble +9 dB, y Vocal +6 dB. Los controles de ganancia se muestran solo para las bandas de EQ que están marcadas actualmente y se ocultan automáticamente cuando un efecto de EQ no está marcado. Los valores de ganancia se guardan globalmente y se restauran en la siguiente sesión.

El botón Reproducir/Pausar También se encuentra en la parte inferior de la ventana. Si no se reproduce ninguna estación, se inicia la estación seleccionada; si ya se está reproduciendo una emisora, la reproducción se interrumpe.

Cuando se selecciona una estación en la lista, el botón Detalles de la estación muestra información como el país, el idioma, el género, el formato, el bitrate, el sitio web y el flujo URL en un cuadro de diálogo separado. Cada campo aparece en su propio cuadro de texto de solo lectura; puedes moverte entre los campos con Tab y copia toda la información al portapapeles de una vez con el botón Copiar todo al portapapeles. Este botón está disponible en las pestañas Todas las estaciones y Favoritos.

Atajos en el cuadro de diálogo

Las siguientes teclas solo funcionan cuando la ventana del Navegador de Estaciones está activa.

Teclas F

Lista y Atajos de Navegación

Atajos de Volumen

Atajos de la Tecla Alt

Favoritos

La lista de favoritos es una colección de emisoras personales almacenada permanentemente. Para añadir una estación, selecciónela de la lista y pulse el botón Añadir a favoritos o usa el atajo Alt+V. El mismo atajo elimina una estación que ya está en la lista cuando se selecciona.

Los favoritos se pueden jugar con Ctrl+Win+→ y Ctrl+Win+←; estos atajos funcionan incluso cuando la ventana del navegador no está abierta.

Para eliminar una emisora ​​de la lista de favoritos, selecciónela y pulse el botón Eliminar estación o la tecla Suprimir. Después de la eliminación, el foco y la selección pasan automáticamente a la siguiente estación de la lista. Si la estación eliminada fue la última, el foco se mueve a la estación anterior. Si la lista queda vacía, el foco se mueve al botón Reproducir.

Exportar e Importar Favoritos

La pestaña Favoritos incluye dos botones para hacer copias de seguridad y restaurar tu lista de estaciones:

Exportar favoritos… — guarda toda tu lista de favoritos en un archivo. Un cuadro de diálogo te permite elegir entre dos formatos: - JSON (.json) — una copia de seguridad completa que conserva los nombres de las estaciones, las URLs del Stream de transmisión y todos los metadatos. Recomendado para restaurar tu lista más adelante o moverla a otro equipo. - Lista de reproducción M3U (.m3u) — un formato de lista de reproducción estándar compatible con la mayoría de reproductores multimedia y aplicaciones de radio. Ten en cuenta que M3U no almacena todos los metadatos de la estación, por lo que restaurar desde M3U puede resultar en menos detalles que una copia de seguridad JSON.

Importar favoritos… — carga estaciones desde un archivo JSON o M3U exportado previamente. Después de seleccionar el archivo, se te pregunta cómo agregar las estaciones: - Sí (Fusionar) — añade las estaciones importadas a tu lista existente sin eliminar ningún favorito actual. Las estaciones duplicadas no se añaden dos veces. - No (Reemplazar) — borra completamente tu lista de favoritos actual y la reemplaza con el contenido del archivo importado. - Cancelar — regresa al navegador sin realizar ningún cambio.

Tras una importación exitosa, la lista de favoritos, la lista de estaciones de grabación programada y la lista de estaciones del temporizador se actualizan automáticamente.

Reordenar Favoritos

Con una estación seleccionada en la pestaña Favoritos, pulse la coma para entrar en modo de desplazamiento; escuchará un pitido. Navegue hasta la posición de destino con las teclas de flecha, luego pulse la coma nuevamente. La estación se coloca en la posición elegida y la nueva organización queda inmediatamente registrada. Al pulsar la coma nuevamente en la misma posición se cancela el desplazamiento.

Atajos de Teclado Directos para Estaciones Favoritas

Cada estación de la lista de favoritos está registrada como un script independiente en el cuadro de diálogo Gestos de Entrada de NVDA, dentro de la categoría Estaciones FreeRadio. Puedes asignar cualquier atajo de teclado a cualquier estación y pulsarlo desde cualquier lugar — sin necesidad de abrir la ventana del navegador.

Para asignar un atajo:

1. Abre el Menú NVDA → Preferencias → Gestos de Entrada.
2. Expande la categoría Estaciones FreeRadio.
3. Busca la estación por nombre, selecciónala y pulsa Añadir.
4. Pulsa la combinación de teclas deseada y confirma.

El atajo inicia la estación de inmediato. Si la estación se elimina de favoritos, su entrada desaparece de la categoría y cualquier atajo asignado se borra automáticamente por NVDA. Cuando se añade una nueva estación a favoritos, aparece en la categoría al instante — no es necesario volver a abrir el cuadro de diálogo Gestos de Entrada.

Añadir una Estación Personalizada

Para añadir una estación que no está en Radio Browser, use el botón Añadir una estación personalizada. En el cuadro de diálogo que aparece, ingresa el nombre de la estación y la URL del flujo de transmisión para añadirla directamente a tus favoritos. Las estaciones personalizadas se pueden escuchar y reorganizar como cualquier otro favorito.

Perfil de Audio de la Estación

La pestaña Favoritos incluye dos botones para administrar los ajustes de audio por estación:

Guardar perfil de audio para esta estación — guarda el nivel de volumen actual y los efectos activos (coro, EQ, etc.), y valores de ganancia de EQ como un perfil vinculado a esa estación específica. Cada vez que esa estación comienza a reproducirse, sus ajustes de volumen, efectos y ganancia guardadas se aplican automáticamente, anulando los valores predeterminados globales.

Borrar perfil de audio — elimina el perfil de audio guardado de la estación seleccionada. Después de borrar, la estación vuelve a los ajustes globales de volumen, efectos y ganancia de EQ. Este botón solo está activo cuando la estación seleccionada ya tiene un perfil guardado.

Los dos botones están ubicados debajo de la lista de favoritos y solo se activan cuando se selecciona una estación de la lista.

Reconocimiento de Música

Pulse tres veces Ctrl+Win+I activa el reconocimiento de música basado en Shazam para el flujo que se está reproduciendo actualmente. El reconocimiento sólo comienza cuando no hay metadatos ICY (información de la pista transmitida por la estación) disponibles; si hay metadatos presentes, se copian al portapapeles en su lugar.

El reconocimiento funciona de la siguiente manera: se captura una breve muestra de audio a partir del flujo usando ffmpeg, se aplica el algoritmo de huellas digital de Shazam y el resultado se envía a los servidores de Shazam. Si el reconocimiento tiene éxito, el título de la canción, el artista, el álbum y el año de lanzamiento serán anunciados por NVDA y copiado automáticamente al portapapeles. Si la opción Guardar las canciones favoritas en un archivo de texto esta activado, el resultado del reconocimiento también se añade a likedSongs.txt.

Retorno de audio: Suenan dos pitidos ascendentes cuando comienza el reconocimiento y dos pitidos descendentes cuando finaliza. Suena un pitido corto cada 2 segundos mientras el proceso está en progreso.

Requisito: ffmpeg.exe requerido. Un ffmpeg.exe colocado en la carpeta del complementos se utiliza automáticamente; si está en una ubicación diferente, la ruta se puede establecer en las Opciones. Descargar ffmpeg desde ffmpeg.org.

Espejo de Audio

El atajo Ctrl+Win+M pone los espejos del flujo que se está reproduciendo actualmente en un segundo dispositivo de salida de audio simultáneamente. Esto es útil para escuchar en dos dispositivos diferentes al mismo tiempo, como altavoces y auriculares.

Al pulsar por primera vez, aparece un cuadro de diálogo de selección que enumera los dispositivos de salida disponibles. Una vez elegido el dispositivo, comienza la puesta en espejo y la reproducción principal continúa sin interrupción. Al pulsar el atajo nuevamente se detiene la la puesta en espejo.

Casos de uso: - Altavoces + auriculares — Dejar que un invitado siga el mismo programa con los auriculares mientras tu escuchas a través de los altavoces de la computadora. - Configuración de grabación — Dirija la salida principal a los altavoces y la segunda salida a una grabadora externa o interfaz de audio para captura externa. - Multihabitación — Reproduzca simultáneamente a través de un altavoz Bluetooth y el altavoz incorporado; no se necesita software adicional para transportar el audio a otra habitación. - Monitoreo remoto — En una sesión de pantalla compartida o de escritorio remoto, tanto el lado local como el remoto pueden escuchar el mismo flujo simultáneamente.

Nota: La puesta en espejo de audio solo está disponible cuando el BASS backend está activo. Si se cambia el volumen mientras la puesta en espejo está activo, ambas salidas se actualizan simultáneamente.

Grabación

Las grabaciones se guardan de forma predeterminada en Documentos\FreeRadio Recordings\. El nombre del archivo incluye el nombre de la estación (o el título de la canción, en modo de grabación de canciones) y la hora de inicio de la grabación. La carpeta de grabaciones se puede cambiar en cualquier momento desde el Menú NVDA → Preferencias → Opciones → FreeRadio → Carpeta de grabaciones. Debido a que el motor de grabación se conecta directamente al flujo de transmisión, el audio se escribe en el disco tal como se recibe; no se aplica ningún procesamiento ni recodificación; La calidad de grabación es la misma que la calidad de transmisión.

Grabación instantánea: Mientras se reproduce una estación, pulse una vez Ctrl+Win+E. Pulse nuevamente para detener. La reproducción continúa sin interrupción.

Grabación de la canción: Pulse Ctrl+Win+E dos veces en sucesión rápida mientras se reproduce una estación que transmite metadatos ICY. La grabación comienza inmediatamente y lleva el nombre del título de la pista actual. Cuando cambia la pista, la grabación se detiene automáticamente y NVDA anuncia el nombre del archivo grabado. Si desea terminar la grabación antes del final de la pista, ppulse Ctrl+Win+E dos veces nuevamente. Si la estación actual no transmite metadatos ICY, la grabación de la canción no está disponible y NVDA te lo notificará.

Grabación programada: Abra la pestaña Grabación en el navegador. Seleccione una estación de sus favoritos, ingrese la hora de inicio en formato HH:MM y la duración en minutos, seleccione uno o más días activos y, luego elige el modo de recurrencia y el modo de grabación:

Días activos: Marque uno o más días de la semana. En el modo de Solo grabación, se crea una entrada separada para cada día seleccionado, colocada en la próxima ocurrencia de ese día. En el modo de Recurrencia, la grabación se repite únicamente en los días marcados. Si no se selecciona ningún día, la grabación no se restringe a días concretos.

Modo de recurrencia: - Grabar una vez — crea una grabación única para cada día seleccionado. Cada entrada se coloca en la próxima ocurrencia de ese día; si la hora de hoy ya pasó, la entrada se traslada automáticamente a la semana siguiente. - Repetir semanalmente — se repite cada semana en los días activos seleccionados hasta que se elimine de la lista de programación.

Modo de grabación: - Grabar mientras escuchas — reproduce y graba simultáneamente. Se inicia un backend de reproducción usando el orden de prioridad BASS → VLC → PotPlayer → Windows Media Player. - Solo grabación — Graba silenciosamente en segundo plano sin ninguna salida de audio; El motor de grabación se conecta directamente al flujo de transmisión.

NVDA anuncia cuándo comienza y cuándo termina una grabación. Si NVDA se reinicia mientras hay una grabación programada activa, la grabación se reanuda automáticamente al iniciar.

Desplazamiento temporal (rebobinar radio en directo)

El desplazamiento temporal permite rebobinar la emisora que estás escuchando, como un DVR o una cinta de casete: pausa el momento, retrocede unos minutos y vuelve al directo cuando quieras. La reproducción no tiene que detenerse: rebobinar y avanzar ocurren al instante en el mismo flujo de audio.

Esta función está deshabilitada por defecto. Actívala desde el Menú NVDA → Preferencias → Opciones → FreeRadio → Activar búfer de desplazamiento temporal (rebobinar radio en directo, ~10 minutos), o actívala al instante en cualquier momento con Ctrl+Win+T.

Cómo funciona

Una vez habilitado, FreeRadio captura continuamente la emisora en reproducción a un búfer local rotativo en segundo plano. El búfer almacena aproximadamente los últimos 10 minutos de audio; el audio más antiguo se descarta automáticamente por el frente a medida que llega audio nuevo, de modo que el búfer siempre representa el "pasado reciente" relativo al borde del directo.

• Ctrl+Win+J — Retroceder 15 segundos. La primera pulsación te lleva de la reproducción en directo a la reproducción con desplazamiento temporal, comenzando 15 segundos detrás del borde del directo. Cada pulsación adicional retrocede 15 segundos más.
• Ctrl+Win+K — Avanzar 15 segundos en modo desplazamiento temporal. Al alcanzar el borde del directo, la reproducción vuelve automáticamente al stream en directo y NVDA anuncia «Volver al directo».
• Ctrl+Win+T — Activa o desactiva toda la función. Desactivarla mientras se está en modo de desplazamiento temporal vuelve inmediatamente al directo y detiene la captura en segundo plano de la emisora actual.

La captura en segundo plano sigue funcionando todo el tiempo que se está en modo de desplazamiento temporal, de modo que el borde del directo sigue avanzando incluso mientras escuchas algo de hace unos minutos, exactamente como un DVR real.

Habilitación y calentamiento del búfer

El búfer empieza a llenarse tan pronto como una emisora comienza a reproducirse (una vez habilitada la función), o en el momento en que habilitas la función mientras ya escuchas una emisora. Por ello, el retroceso solo es posible una vez que se hayan capturado realmente unos segundos de audio. Si pulsas Ctrl+Win+J inmediatamente después de cambiar de emisora, NVDA te avisará de que todavía no hay suficiente audio en el búfer. Espera unos segundos e inténtalo de nuevo.

Cambiar a una emisora diferente siempre reinicia el búfer para la nueva emisora; el audio almacenado de la emisora anterior se descarta.

Flujos compatibles

El desplazamiento temporal funciona con la misma gama de flujos que FreeRadio ya admite:

• Flujos HTTP/HTTPS simples (MP3, AAC, OGG, etc.), incluidos servidores de tipo Shoutcast/Icecast.
• Flujos HLS (.m3u8) — FreeRadio resuelve la lista de reproducción maestra de la emisora, sigue la lista de reproducción de medios y descarga segmentos en segundo plano para mantener el búfer lleno.

En el raro caso de que la lista de reproducción de una emisora no pueda leerse en absoluto (por ejemplo, un manifiesto .m3u8 roto o inalcanzable), NVDA te indicará que el retroceso no está disponible para esa emisora concreta.

Requisitos y limitaciones

• Requiere el BASS backend. El desplazamiento temporal no está disponible cuando el BASS está deshabilitado.
• El búfer tiene aproximadamente 10 minutos; no se puede retroceder más allá de ese límite.
• El búfer es por emisora: cambiar de emisora, detener la reproducción o reiniciar NVDA lo borra y empieza de nuevo.
• La reproducción con desplazamiento temporal usa su propio archivo de búfer local y no produce una grabación guardada. Si quieres conservar el audio de forma permanente, usa también la Grabación instantánea (Ctrl+Win+E).

Temporizador

Abra la pestaña Temporizador en el navegador de estaciones (Alt+4). Se pueden añadir dos tipos de temporizador:

Alarma — iniciar la radio: Comienza a reproducir automáticamente una estación seleccionada de sus favoritos a la hora especificada. Elija una estación e ingrese la hora en formato HH:MM.

Apagado — detener la radio: Detiene la reproducción a la hora especificada. Cuando suena el temporizador, el volumen se reduce gradualmente durante 60 segundos antes de que se detenga la reproducción. No es necesaria ninguna selección de estación; simplemente ingrese la hora.

Para ambos tipos, si la hora ingresada ya pasó, la acción se programa para el día siguiente. Si ya existe un temporizador a la misma hora (independientemente del tipo), no se permite añadir uno nuevo; se informa al usuario del conflicto y se le pide que elimine primero la entrada existente. Los temporizadores pendientes se enumeran en la pestaña; seleccione uno y pulse el botón Eliminar el temporizador seleccionado para cancelarlo.

Opciones

Las siguientes opciones se pueden configurar desde el Menú NVDA → Preferencias → Opciones → FreeRadio:

Silenciar Notificaciones

Cuando Silenciar notificaciones está habilitado en las Opciones, NVDA silencia los siguientes anuncios automáticos:

• Nombre de la estación cuando comienza a reproducirse una nueva estación
• Cambios de estado de reproducción: reproducir, pausar, detener
• Eventos de grabación: iniciado, detenido, terminado (grabaciones instantáneas, de canciones y programadas)
• Anuncios de cambio de pista ICY, incluso cuando Anunciar automáticamente los cambios de pista también está habilitado

Los siguientes anuncios no se ven afectados intencionalmente: mensajes de error, comentarios sobre favoritos (añadido / ya en la lista), resultados de reconocimiento de música y notificaciones de actualización.

La configuración se puede alternar desde el Menú NVDA → Preferencias → Opciones → FreeRadio, o instantáneamente en cualquier momento mediante un gesto de entrada no asignado (asignar uno desde el Menú NVDA → Preferencias → Gestos de Entrada → FreeRadio). Cuando está habilitado, NVDA anuncia una vez "Notificaciones silenciadas" o "Notificaciones reactivadas" para confirmar el cambio.

Anunciar automáticamente los cambios de pista

Cuando la opción Anunciar automáticamente los cambios de pista se activa en las Opciones, FreeRadio comprueba el flujo de metadatos ICY de la estación activa en segundo plano aproximadamente cada 5 segundos. Cuando cambia la pista, NVDA lee automáticamente el nuevo título; no es necesario pulsar ninguna tecla.

Al cambiar a una nueva emisora, la información de la primera pista se anuncia tan pronto como se establece la conexión. Si cambia a una estación que no transmite metadatos ICY, el sistema permanece en silencio y la información de la pista de la estación anterior no se repite.

Esta función está desactivada de forma predeterminada y se puede alternar desde el Menú NVDA → Preferencias → Opciones → FreeRadio.

Canciones favoritas

Cuando la opción Guardar las canciones favoritas en un archivo de texto está activado, la información de la pista se copia al portapapeles pulsando tres veces Ctrl+Win+I también se añade línea por línea a Documentos\FreeRadio Recordings\likedSongs.txt.

En las estaciones que transmiten metadatos ICY, el título de la pista y el artista se guardan directamente. En las estaciones sin metadatos ICY, el resultado del reconocimiento de Shazam se guarda en el mismo archivo; ambas fuentes comparten la misma lista. El archivo se crea automáticamente si no existe; cada entrada se añade al final del archivo y las entradas anteriores nunca se eliminan.

Pestaña de Canciones favoritas

La pestaña Canciones favoritas en el navegador de estaciones se muestran todas las pistas guardadas en likedSongs.txt. La lista se recarga automáticamente desde el archivo cada vez que se abre la pestaña.

Un campo Filtrar encima de la lista permite limitar las pistas mostradas en tiempo real. Escribe cualquier parte del título de una canción o nombre del artista y la lista se actualiza instantáneamente a cada pulsación. NVDA anuncia el número de resultados coincidentes tras cada cambio. Pulsa la flecha Abajo desde el campo Filtrar para mover el foco directamente a la lista.

Seleccionar una pista de la lista permite las siguientes acciones:

• Reproducir en Spotify: Intenta abrir la aplicación de escritorio de Spotify directamente. Si la aplicación no está instalada, vuelve al sitio web de Spotify y automáticamente comienza a reproducir el primer resultado.
• Reproducir en YouTube (Alt+O): Busca en YouTube la pista seleccionada y abre los resultados en el navegador predeterminado.
• Mostrar letra: Obtiene y muestra la letra de la pista seleccionada. Las letras se obtienen de lrclib.net (gratuito, sin cuenta requerida). Se anuncia un breve mensaje "Obteniendo letra…" mientras la búsqueda se ejecuta en segundo plano. Si se encuentran letras, se abren en un cuadro de diálogo de solo lectura donde puedes leerlas con NVDA y copiarlas al portapapeles. Si no se encuentran letras, NVDA lo anuncia. El botón se desactiva temporalmente mientras se realiza una búsqueda para evitar solicitudes duplicadas.
• Eliminar (Alt+M): Elimina la pista seleccionada de likedSongs.txt y actualiza la lista. La tecla Suprimir también activa este botón cuando la lista está enfocada.
• Refrescar (Alt+E): Vuelve a cargar la lista desde el archivo.

Los botones Spotify, YouTube, Mostrar letra y Eliminar sólo se activan cuando se selecciona una pista real en la lista.

Servicio de letras

FreeRadio usa lrclib.net para obtener letras — una base de datos gratuita y abierta que no requiere clave de API ni cuenta. El proceso de búsqueda analiza la cadena de pista almacenada en likedSongs.txt y prueba consultas progresivamente más amplias hasta encontrar letras:

1. Coincidencia exacta con el nombre completo del artista y el título limpio (los sufijos de ruido como "Remastered", "Live" o etiquetas de año se eliminan antes de buscar).
2. Coincidencia exacta con el nombre completo del artista y el título original (si la limpieza lo cambió).
3. Coincidencia exacta con solo el primer nombre de artista y el título limpio (para cadenas de múltiples artistas como "Artista A & Artista B").
4. Búsqueda difusa con el primer nombre de artista y el título limpio.
5. Búsqueda difusa con la cadena de pista sin procesar como último recurso.

Cuando hay letras en texto plano disponibles, se muestran tal cual. Cuando solo hay letras LRC sincronizadas por tiempo, se eliminan las marcas de tiempo y se muestra el texto plano. Las pistas instrumentales se reportan como no encontradas.

Reproducción

El complemento selecciona un backend de reproducción usando el siguiente orden de prioridad:

1. BASS — el backend predeterminado y principal. No se requiere instalación por separado; viene incluido con el complemento. BASS envía el audio directamente a la pila de audio de Windows y aparece en el mezclador de volumen de Windows como una fuente de audio independiente llamada "pythonw.exe", separada de NVDA. Esto significa que el audio de FreeRadio circula en un canal completamente separado del habla de NVDA: la radio no se corta, no se mezcla ni se ve afectada por la propia configuración de audio de NVDA mientras NVDA está hablando. El usuario puede ajustar el volumen de la radio independientemente de NVDA en el Mezclador de volumen de Windows. Admite HTTP, HTTPS y la mayoría de los formatos de flujo integrados. La puesta en espejo de audio solo está disponible con este backend.
2. VLC — se hace cargo si el BASS falla. Se busca automáticamente en ubicaciones de instalación comunes, carpetas de perfil de usuario y la RUTA del sistema.
3. PotPlayer — probado si no se encuentra VLC. Se busca automáticamente en ubicaciones de instalación comunes.
4. Windows Media Player — utilizado como último recurso; requiere que el componente WMP esté instalado en el sistema.

Comprobación de Actualización

FreeRadio busca automáticamente nuevas versiones a través de GitHub.

Comprobación automática: Se ejecuta silenciosamente en segundo plano 15 segundos después de que se inicia NVDA. Si se encuentra una nueva versión, se le notificará; si no se encuentra ninguno, no se muestra ningún mensaje.

Comprobación manual: Se puede activar a solicitud desde Herramientas NVDA → FreeRadio → Buscar actualizaciones…. Cuando se inicia de esta manera, el resultado se anuncia incluso si la versión está actualizada.

Cuando se encuentra una actualización: Se abre un cuadro de diálogo que muestra el número de versión y la versión instalada.

• Si hay un archivo .nvda-addon directamente descargable disponible en la release de GitHub, se muestra un botón Descargar y Instalar. Una vez confirmado, el archivo se descarga en segundo plano, NVDA anuncia cuándo comienza la descarga y La propia pantalla de instalación se abre automáticamente.
• Si no hay ningún enlace de descarga directa disponible,, un botón Abrir la página se muestra y la página de la release en GitHub se abre en el navegador predeterminado.

Para desactivar las comprobaciones automáticas: Deshabilitar la opción Buscar actualizaciones automáticamente al iniciar desde el Menú NVDA → Preferencias → Opciones → FreeRadio.

Licencia

GPL v2