Traductor Avanzado para NVDA

Complemento profesional para NVDA que facilita la traducción de textos en múltiples idiomas utilizando diversos servicios de traducción tanto gratuitos como de pago.

Índice

• Descripción
• Características principales
• Requisitos
• Instalación
• Módulos de traducción
• Uso básico
• Capa de comandos
• Interfaz de traducción
• Traducción de archivos
• Reproducción de audio TTS
• Configuración
• Gestión de claves API
• Caché de traducciones
• Historial de traducciones
• Actualización de idiomas
• Menú de NVDA
• Seguridad
• Compilación
• Estructura del proyecto
• Autor
• Licencia
• Agradecimientos

Descripción

Traductor Avanzado es un complemento para el lector de pantalla NVDA que permite traducir textos de forma rápida y eficiente. Ofrece 9 módulos de traducción online para uso en tiempo real, incluyendo servicios gratuitos como Google Translate, DeepL Free y Microsoft Bing, además de 4 módulos de inteligencia artificial (OpenAI GPT, Claude, Google Gemini y DeepSeek) disponibles exclusivamente para la traducción de archivos y documentos.

El complemento está diseñado para ser accesible, modular y extensible, con una arquitectura que facilita la adición de nuevos servicios de traducción en el futuro.

¿Qué puedo hacer con Traductor Avanzado?

• Traducir texto seleccionado en cualquier aplicación con un atajo de teclado.
• Traducir el contenido del portapapeles sin necesidad de abrir ningún diálogo.
• Traducción simultánea en tiempo real de todo lo que NVDA verbalice (solo módulos online).
• Traducir archivos completos en formatos TXT, HTML, CSV, SRT, Markdown, PO/POT y DOCX, eligiendo el servicio (online o IA), idioma origen y destino.
• Usar inteligencia artificial (OpenAI, Claude, Gemini, DeepSeek) para traducir documentos con mayor calidad y contexto.
• Escuchar la traducción con un reproductor de audio TTS integrado.
• Detectar automáticamente el idioma de un texto seleccionado.
• Gestionar un historial completo de todas las traducciones realizadas.
• Almacenar traducciones en caché para evitar repetir consultas y mejorar la velocidad.
• Gestionar múltiples claves API con rotación automática cuando una clave se agota.

Características principales

Requisitos

• NVDA versión 2025.1 o superior.
• Conexión a internet para los servicios de traducción en línea.
• Claves API para los servicios que lo requieran (DeepL API, LibreTranslate, OpenAI, Claude, Gemini, DeepSeek).

Instalación

1. Descargar el archivo .nvda-addon desde la página de releases.
2. Abrir el archivo descargado (doble clic o desde el menú de NVDA > Herramientas > Administrador de complementos).
3. Confirmar la instalación y reiniciar NVDA.

También disponible en la tienda oficial de complementos de NVDA.

Módulos de traducción

Módulos gratuitos (sin clave API)

Módulos con clave API

Módulos de Inteligencia Artificial (solo traducción de archivos)

ℹ️ Nota: Los módulos de IA están disponibles exclusivamente para la traducción de archivos y documentos a través del menú "Traducir archivo". No están disponibles para la traducción simultánea ni los atajos de teclado, ya que sus tiempos de respuesta (2-10 segundos) no son adecuados para la traducción en tiempo real.

Los resultados pueden variar en calidad según el modelo y el prompt configurado. Se recomienda verificar las traducciones importantes.

Nota: Los módulos marcados con * en la interfaz del complemento requieren al menos una clave API configurada para funcionar.

Uso básico

Traducir texto seleccionado

1. Seleccionar texto en cualquier aplicación.
2. Pulsar NVDA+Shift+Y.
3. La traducción se verbalizará automáticamente.

Traducción simultánea

1. Pulsar NVDA+Shift+T para activar la capa de comandos.
2. Pulsar T para activar/desactivar la traducción simultánea.
3. Todo lo que NVDA verbalice se traducirá automáticamente al idioma destino configurado.

Nota: La traducción simultánea solo funciona con los 9 módulos online (Google, DeepL, LibreTranslate, Microsoft Bing). Los módulos de IA no están disponibles para esta función.

Interfaz de traducción

1. Pulsar NVDA+Shift+U para abrir la interfaz de traducción.
2. Escribir o pegar texto en el campo de origen.
3. Seleccionar idiomas de origen y destino.
4. Pulsar el botón Traducir o Enter.
5. El resultado aparece en el campo de destino.
6. Pulsar F3 para pegar la traducción en la aplicación activa.

Capa de comandos

La capa de comandos permite ejecutar acciones del complemento con una sola tecla. Se activa pulsando NVDA+Shift+T y se desactiva automáticamente después de ejecutar cualquier acción.

Lista completa de teclas

Nota: Todos los atajos son configurables desde el menú de NVDA > Preferencias > Gestos de entrada > Traductor Avanzado.

Interfaz de traducción

La interfaz de traducción (NVDA+Shift+U o tecla W en la capa de comandos) ofrece:

Controles y atajos

Botones

• Traducir: Ejecuta la traducción del texto origen.
• Intercambiar: Intercambia los idiomas de origen y destino.
• Limpiar: Limpia ambos campos de texto.
• Pegar al foco: Pega la traducción en la aplicación que tenía el foco antes de abrir la interfaz.
• Cerrar: Cierra la interfaz guardando la configuración de idiomas.

Traducción de archivos

El complemento soporta la traducción de archivos completos en los siguientes formatos, todos implementados sin necesidad de librerías externas:

¿Cómo traducir un archivo?

1. Ir al menú de NVDA > Herramientas > Traductor Avanzado > Traducir archivo.
2. Elegir el servicio de traducción: se muestran todos los módulos disponibles, tanto online como de IA.
3. Elegir el idioma de origen: seleccionar el idioma del archivo o "Autodetectar".
4. Elegir el idioma de destino: seleccionar el idioma al que se desea traducir.
5. Seleccionar el archivo a traducir.
6. Elegir la ubicación para guardar el archivo traducido.
7. El complemento mostrará un diálogo de progreso con el porcentaje de traducción.

💡 Consejo: Para archivos largos o que requieran mayor calidad, usa los módulos de IA (OpenAI, Claude, Gemini, DeepSeek). Para traducciones rápidas de archivos cortos, los módulos online son más eficientes.

Reproducción de audio TTS

El complemento incluye un reproductor de audio integrado que permite escuchar las traducciones mediante síntesis de voz de Google.

Controles del reproductor

El reproductor es compatible con NVDA 2025.1 (Python 3.11, 32 bits) y NVDA 2026.1 (Python 3.13, 64 bits), cargando automáticamente la versión correcta de la biblioteca wx.media.

Configuración

Accesible desde la capa de comandos (tecla P) o desde el menú de NVDA.

Pestaña General

Pestaña Módulos de Traducción

• Selector de módulo: Elige el servicio de traducción activo.
• Gestor de APIs: Para los módulos que requieren API, permite:
• Añadir (F1): Registrar una nueva clave API.
• Editar (F2): Modificar una clave existente.
• Eliminar (F3): Borrar una clave.
• Por defecto (F4): Establecer la clave activa.

Pestaña Configuración de IA

Esta pestaña permite personalizar el comportamiento de los módulos de inteligencia artificial (OpenAI, Claude, Gemini, DeepSeek).

Cada servicio de IA guarda su propia configuración de prompt y modelo de forma independiente.

Gestión de claves API

Servicios que requieren API

Para usar DeepL API, LibreTranslate, OpenAI, Claude, Gemini o DeepSeek, necesitas obtener claves API de sus respectivos proveedores:

Rotación automática de claves

Si configuras múltiples claves para un mismo servicio, el complemento rotará automáticamente a la siguiente clave cuando una falle o se agote su cuota. Esto es especialmente útil para servicios con límites de uso gratuito.

Caché de traducciones

La caché almacena las traducciones realizadas en archivos JSON dentro del directorio de configuración de NVDA (TranslateAdvancedCache/). Cada aplicación tiene su propio archivo de caché.

• Activar/desactivar: Desde la configuración o tecla G en la capa de comandos.
• Limpiar caché de app actual: Tecla X en la capa de comandos.
• Limpiar toda la caché: Tecla A en la capa de comandos.
• Es compatible con el formato de caché de versiones anteriores del complemento.

Historial de traducciones

El historial almacena las últimas 500 traducciones realizadas (origen y destino). Se accede con la tecla H en la capa de comandos y permite:

• Ver todas las traducciones realizadas.
• Navegar por la lista y ver el texto original y traducido.
• Copiar una traducción al portapapeles.
• Limpiar el historial completo.

Actualización de idiomas y documentación

El complemento puede descargar tanto traducciones (locale) como documentación traducida de forma independiente desde el repositorio de GitHub.

Cómo funciona

1. Al iniciar NVDA, el complemento comprueba automáticamente si hay actualizaciones disponibles.
2. Si las hay, el menú mostrará el número de actualizaciones pendientes (ejemplo: "Actualizar idiomas del complemento (3 disponibles)").
3. Al comprobar manualmente (tecla U o menú), se muestra un resumen detallado con los idiomas y tipos de actualización (locale, doc).
4. Al aceptar, se muestra un diálogo de progreso con información en tiempo real sobre cada descarga.
5. Al finalizar, se informa del número de paquetes actualizados correctamente.

Tipos de actualización

Los paquetes de idioma se gestionan en el directorio translates/ del repositorio. Consulta translates/README.md para instrucciones sobre cómo crear y gestionar paquetes.

Menú de NVDA

El complemento añade un submenú en Preferencias > Traductor Avanzado con las siguientes opciones:

Seguridad

Encriptación de claves API

Las claves API se almacenan encriptadas en el archivo apis.enc dentro del directorio de datos del complemento (TranslateAdvancedData/). La encriptación usa una clave derivada del nombre del equipo y usuario del sistema, lo que garantiza que las claves solo sean legibles en el equipo donde fueron configuradas.

Modo seguro de NVDA

Cuando NVDA se ejecuta en modo seguro (pantallas de inicio de sesión, UAC, etc.), todas las funciones del complemento se desactivan automáticamente por seguridad.

⚠️ Advertencia sobre copias portables de NVDA

Si creas una copia portable de NVDA para compartirla o distribuirla, ten en cuenta lo siguiente:

• La copia portable incluye todos los datos del complemento almacenados en la carpeta del usuario, incluyendo el directorio TranslateAdvancedData/.
• Dentro de esa carpeta se encuentran las claves API encriptadas (apis.enc), la configuración de modelos de IA, y la caché de traducciones.
• Aunque las claves están encriptadas, la encriptación está vinculada al equipo original. Si la copia portable se ejecuta en otro equipo, las claves podrían no desencriptarse correctamente. Sin embargo, el archivo sigue conteniendo datos sensibles.
• Antes de compartir una copia portable, elimina manualmente la carpeta TranslateAdvancedData/ dentro del directorio de configuración de la copia portable, o al menos elimina el archivo apis.enc para evitar que tus claves API puedan ser expuestas.

Ruta típica en la copia portable: [carpeta_portable]\userConfig\TranslateAdvancedData\

Migración desde versiones anteriores

Si actualizas desde una versión anterior del complemento, el sistema migrará automáticamente: - Las claves API del formato viejo (apis.json) al nuevo formato encriptado (apis.enc). - La caché de traducciones existente sin pérdida de datos. - La configuración guardada en config.conf de NVDA.

Compilación

Requisitos

• Python 3.11+
• SCons
• gettext

Compilar el complemento

bash scons

Esto genera el archivo .nvda-addon en el directorio raíz del proyecto.

Generar archivo de traducciones

bash scons pot

Publicar en GitHub

Ejecutar el script publicar.bat que ofrece un menú interactivo con las opciones:

1. Subida completa (limpiar, commit, push, tag, release automática)
2. Solo commit y push
3. Solo crear tag
4. Inicializar repositorio
5. Compilar localmente

Estructura del proyecto

TranslateAdvanced/ ├── .github/ │ └── workflows/ │ ├── build_addon.yml ← Build + Release automática │ └── submit_to_store.yml ← Generación de JSON para tienda NVDA ├── addon/ │ ├── doc/es/readme.md ← Documentación en español │ └── globalPlugins/TranslateAdvanced/ │ ├── __init__.py ← GlobalPlugin principal (20 scripts) │ ├── nucleo/ ← Módulos del núcleo │ │ ├── gestor_ajustes.py ← Configuración centralizada │ │ ├── gestor_cache.py ← Caché de traducciones │ │ ├── gestor_apis.py ← Claves API encriptadas │ │ ├── gestor_idiomas.py ← Catálogo de idiomas por servicio │ │ ├── gestor_historial.py ← Historial de traducciones │ │ └── gestor_actualizaciones.py ← Actualización de idiomas │ ├── traductores/ ← 13 módulos de traducción │ │ ├── base.py ← Clase abstracta base │ │ ├── google_web.py ← Google Translate WEB 1 │ │ ├── google_web_alt.py ← Google Translate WEB 2 │ │ ├── google_api_free.py ← Google API Free 1 │ │ ├── google_api_free_alt.py ← Google API Free 2 │ │ ├── deepl_free.py ← DeepL Free (JSON-RPC) │ │ ├── deepl_api.py ← DeepL API (Free + Pro) │ │ ├── libretranslate.py ← LibreTranslate API │ │ ├── microsoft_free.py ← Microsoft Bing Free │ │ ├── openai_api.py ← OpenAI GPT │ │ ├── claude_api.py ← Claude (Anthropic) │ │ ├── gemini_api.py ← Google Gemini │ │ └── deepseek_api.py ← DeepSeek │ ├── servicios/ ← Servicios auxiliares │ │ ├── detector_idiomas.py ← Detección de idioma │ │ ├── tts_google.py ← Text-to-Speech via Google │ │ └── intercepcion_voz.py ← Intercepción de speech de NVDA │ ├── formatos/ ← Procesadores de archivos │ │ ├── base.py ← Clase abstracta │ │ ├── formato_txt.py ← Texto plano │ │ ├── formato_html.py ← HTML │ │ ├── formato_csv.py ← CSV │ │ ├── formato_srt.py ← Subtítulos SRT │ │ ├── formato_md.py ← Markdown │ │ ├── formato_po.py ← Gettext PO/POT │ │ └── formato_docx.py ← Microsoft Word DOCX │ ├── guis/ ← Interfaces de usuario │ │ ├── dialogo_ajustes.py ← Configuración por pestañas │ │ ├── dialogo_traduccion.py ← Interfaz principal de traducción │ │ ├── dialogo_historial.py ← Historial de traducciones │ │ ├── dialogo_progreso.py ← Diálogo de progreso │ │ └── reproductor_audio.py ← Reproductor de audio TTS │ ├── utilidades/ ← Funciones auxiliares │ │ ├── red.py ← HTTP/SSL con reintentos │ │ ├── seguridad.py ← Encriptación y modo seguro │ │ ├── texto.py ← Procesamiento de texto │ │ ├── nvda_utils.py ← Utilidades de NVDA │ │ └── ayuda_contextual.py ← Sistema Ctrl+H │ └── datos/ ← Recursos │ ├── sonidos/ ← open.wav, close.wav │ └── lib/ ← wx.media (32 y 64 bits) ├── translates/ ← Paquetes de idioma │ ├── languages.json ← Registro de versiones │ └── README.md ← Instrucciones de gestión ├── buildVars.py ← Variables de compilación ├── sconstruct ← Script de compilación SCons ├── publicar.bat ← Script de publicación Windows ├── changelog.md ← Registro de cambios └── readme.md ← Este archivo

Autor

Héctor J. Benítez Corredera (xebolax@gmail.com)

• GitHub: github.com/hxebolax
• Donaciones: paypal.me/hjbcorredera

Licencia

Este complemento está cubierto por la Licencia Pública General de GNU v2.

Agradecimientos

A toda la comunidad de NVDA en español e internacional por su apoyo constante, pruebas y sugerencias que han hecho posible este complemento.