Categoría: Complementos estables

• Autor: Mateo Cedillo
• Versión actual: 0.5.1
• Compatibilidad con NVDA: de 2023.1 en adelante
• Descargar
• Ver código fuente en GitHub

Me inspiré en hacer este pequeño complemento, pues muchos sintetizadores de voz como ETI-Eloquence tienen ciertos defectos en cuanto al procesamiento de números. Por ejemplo, si se tiene dos números separados por espacios y el sintetizador lo interpreta erróneamente como si de un punto decimal se tratara.
Este complemento mejora la lectura de números a palabras para estos casos, soporta números grandes y, además, la librería de la que depende admite muchos idiomas.

Uso:

Este complemento tiene dos formas de usar números a palabras que se detallan a continuación:

• Modo en tiempo real: mientras NVDA hable y exista texto que contenga números dentro de él, la conversión mostrará su resultado y este se transmitirá por voz. Esto, por supuesto, se aplica en cualquier sintetizador de voz que uses.
• Modo manual: puedes escribir números, texto y/o números a la vez, interactuando mediante un cuadro de diálogo que te permitirá hacerlo. La ventana de diálogo tiene:
  • Un cuadro de edición para escribir tu entrada.
  • Un botón convertir. Al presionar este botón, se te mostrará un cuadro de mensaje con el resultado final.
  • Un botón cancelar: sale del diálogo de conversión.

Gestos de entrada:

• Alternar números a palabras (o modo en tiempo real): Gesto sin asignar por ahora para evitar interferencia con otros complementos.
• Abrir el diálogo de conversión (o modo manual): alt+shift+NVDA+n
• ¡Más características pronto!

Notas importantes:

• Como la librería soporta muchos idiomas, ten en cuenta que la conversión se realizará en el idioma de tu sintetizador de voz. Siendo así, el idioma de la conversión se cambia automáticamente cuando cambies el del sintetizador.
• La librería num2words puede convertir hasta 27 números seguidos. Si el texto tiene más de 27 números, lo sabrás con un pitido y un mensaje de voz indicándotelo.
• Actualmente, la verbalización de un número convertido con el cursor no está implementada y, como consecuencia, se deletreará el número convertido.

Contacto:

Si quieres ayudar a mejorar este complemento, puedes enviar un correo a [email protected] o puedes hacer tus contribuciones en el repositorio de GitHub.

Historial de cambios:

0.1

• Versión inicial. Es posible que encuentres algunos errores menores. Si es así, por favor házmelo saber.

• Autor: Noelia Ruiz Martínez
• Versión actual: 17.0.0 estable
• Ver este complemento en el sitio web de la comunidad internacional
• Descargar versión estable más reciente (compatible con NVDA 2023.1 y
  posterior)
• Descargar versión beta más reciente (compatible con NVDA 2023.1 y
  posterior)
• Ver código fuente en GitHub

Este complemento se usa para acortar URLs desde NVDA mediante is.gd.

El diálogo de acortar URL

Ve al menú NVDA, submenú Herramientas, y activa el elemento Acortar URL.

Alternativamente, puedes asignar un gesto desde el diálogo Gestos de entrada
de NVDA.

El diálogo Acortar URL incluye los siguientes controles:

• Una lista para seleccionar una de las URLs guardadas. Desde esta lista,
  pulsa shift+tab para buscar, y tab para pulsar uno de los siguientes
  botones.
• Copiar URL acortada. También se puede activar pulsando intro en la lista
  de URLs.
• Nueva: abre un diálogo para escribir una URL a acortar. Se puede
  proporcionar un nombre para mostrar desde este diálogo.
• Renombrar: abre un diálogo para proporcionar un nuevo nombre para mostrar
  la URL seleccionada en la lista.
• Eliminar: abre un diálogo para eliminar la URL seleccionada.
• Borrar URLs guardadas: abre un diálogo para borrar las URLs guardadas de
  la carpeta de configuración.
• Cerrar.

Cambios para 1.0.0

• Versión inicial.

• Autores: George Kerscher, Noelia Ruiz Martínez
• Versión actual: 19.0.0 estable
• Compatibilidad con NVDA: de 2023.1 en adelante
• Ver este complemento en la web de la comunidad internacional
• Descargar versión estable
• Ver código fuente en GitHub

En el consorcio DAISY, se desarrollan buenas prácticas para que los
publicadores y autores proporcionen descripciones extendidas (largas).

Las buenas prácticas usan el elemento details de HTML que sigue a la imagen,
o un enlace a otro archivo que contenga la descripción extendida.

En ambos casos, el usuario tendría que desplazarse a los detalles o al
enlace y activarlo.

Tener un atajo que sitúe el foco en el enlace o los detalles es ideal.

Nuestras buenas prácticas recomiendan que tanto el enlace como los detalles
vayan inmediatamente después de la imagen, y si se sigue el enlace, se debe
proporcionar un enlace de vuelta a la ubicación exacta. Esto garantiza que
el usuario no se perderá.

Sin embargo, es probable que los autores sitúen la descripción extendida
(larga) casi en cualquier parte. En estos casos, el usuario querría volver a
la imagen, de ahí la necesidad de una forma de regresar a la imagen
original.

Este complemento proporciona ambas características, como apoyo a esta
incidencia abierta en el repositorio de NVDA.

Órdenes

• NVDA+alt+d: mueve el cursor al elemento identificado con aria-details.
• NVDA+alt+shift+d: mueve el cursor al elemento original. Por ejemplo, una
  imagen con más detalles, como una descripción larga. Si se ha pulsado
  NVDA+alt+d varias veces para desplazarse a anotaciones relacionadas, será
  posible regresar a cada origen.

Las órdenes anteriores pueden modificarse desde el menú NVDA, submenú
Preferencias, diálogo Gestos de entrada, categoría Modo exploración.

Cambios para 2.0

• Se ha añadido la posibilidad de retroceder por varios orígenes de
  anotaciones.
• Se requiere NVDA 2023.1 o posterior.

• Autor: Cyrille Bougot
• Versión actual: 6.3 estable
• Compatibilidad con NVDA: de 2019.2 en adelante
• Ver este complemento en la web de la comunidad internacional
• Descargar versión estable
• Ver código fuente en GitHub

Este complemento reúne diversas funciones para depuración y pruebas en NVDA.

Características

• Un diálogo mejorado para reiniciar que permite indicar algunas opciones
  extra cuando se reinicia NVDA.
• Un script de conmutación y un backport de la función «Reproducir un sonido
  para los errores registrados» de NVDA.
• Un explorador de propiedades de los objetos.
• Un modo de descripción extendida para los scripts: cuando está activado,
  el modo ayuda de entrada anuncia información de los scripts que no tienen
  descripción.
• Órdenes para ayudar con la lectura y el análisis del registro.
• En el espacio de trabajo de la consola Python, una función para abrir el
  código fuente de un objeto.
• Un script personalizado de inicio para la consola Python
• Una orden para registrar la pila de llamadas de la función speech.speak.

Diálogo reiniciar mejorado

La orden NVDA+shift+q abre un diálogo para indicar algunas opciones extra
antes de reiniciar NVDA. Las opciones que pueden especificarse corresponden
a las opciones de línea de órdenes que se pueden usar con nvda.exe,
como -c para la ruta de configuración, --disable-addons para
deshabilitar los complementos, etc.

Reproducir un sonido para los errores registrados

La opción «Reproducir un sonido para los errores registrados» se
introdujo en NVDA 2021.3 y permite especificar si NVDA reproducirá un sonido
de error en caso de que se registre un error.

Este complemento proporciona una orden adicional (NVDA+control+alt+e) para
conmutar este ajuste. Puedes elegir:

• «Sólo en versiones de prueba de NVDA» (por defecto) para que NVDA
  reproduzca sonidos de error sólo si la versión actual de NVDA es una
  versión de prueba (alfa, beta o ejecutada desde el código fuente).
• «Sí» para habilitar los sonidos de error sea cual sea tu versión de NVDA.

En versiones de NVDA anteriores a la 2021.3, este complemento proporciona el
backport de esta característica y la posibilidad de controlarla con la orden
de teclado. La casilla de verificación del panel de opciones avanzadas, sin
embargo, no se incluye.

Explorador de propiedades de los objetos

Esta función permite anunciar algunas propiedades del objeto actual en el
navegador de objetos sin abrir el visualizador del registro.

Para enumerar las propiedades de un objeto, mueve el navegador de objetos
hacia él y usa las siguientes órdenes:

• Selecciona la propiedad anterior y la anuncia para el navegador de
  objetos.
• Selecciona la siguiente propiedad y la anuncia para el navegador de
  objetos.
• Anuncia la propiedad seleccionada actualmente para el navegador de
  objetos; al pulsar dos veces rápidamente, muestra esta información en un
  mensaje explorable.

Estas tres órdenes vienen sin asignar por defecto; tendrás que asignarlas
desde el diálogo Gestos de entrada para poder usarlas.

La lista de propiedades soportadas es la siguiente: nombre, rol, estado,
valor, nombre de clase de la ventana, id de control de la ventana, manejador
de la ventana, ubicación, clase Python, orden de resolución de métodos de la
clase Python.

Esta función es una mejora de un ejemplo de la guía de desarrollo de
NVDA.

Modo de descripción extendida de scripts

Cuando el modo de descripción extendida de scripts está activado, el modo de
ayuda de entrada (NVDA+1) se modifica de la siguiente manera. Si un script
no tiene descripción, se anuncian su nombre y su clase. Si un script tiene
descripción, esta se anuncia como siempre. El gesto para activar o
desactivar esta función es NVDA+control+alt+d.

Ejecutar un gesto asociado a un script sin descripción en el modo ayuda de
entrada también crea una entrada para este script en el diálogo de
administración de gestos. Esta entrada se ubica en una categoría dedicada
llamada «Scripts sin descripción (¡Modifica bajo tu responsabilidad!)». Esto
permite añadir, eliminar o cambiar fácilmente los gestos nativos de NVDA
para estos scripts. Ten en cuenta, sin embargo, que el script puede no tener
una descripción intencionadamente para que el usuario no pueda
modificarlo. El script puede estar pensado para coincidir con un atajo de
una aplicación concreta. Por ejemplo, el script script_toggleItalic en
NVDAObjects.window.winword.WordDocument está asignado a control+k, y no
debería modificarse, ya que el gesto se pasa a la aplicación para ejecutar
realmente ese atajo de teclado.

Ejemplo de uso

Control+shift+k también conmuta la cursiva en Word, incluso si NVDA no lo
anuncia de forma nativa. Para que el resultado de pulsar control+shift+k se
anuncie como control+k, deberías seguir los siguientes pasos:

• Abre un documento de Word.
• Activa el modo de descripción extendida de scripts con NVDA+control+alt+d.
• Entra en el modo ayuda de entrada con NVDA+1.
• Pulsa control+K para anunciar el script de cursiva y añadirlo al diálogo
  de gestos.
• Sal del modo ayuda de entrada con NVDA+1.
• Abre el diálogo Gestos de entrada.
• En la categoría «Scripts sin descripción (¡Modifícalos bajo tu
  responsabilidad!)», selecciona la orden «toggleItalic en
  NVDAObjects.window.winword.WordDocument».
• Añade el atajo control+shift+k y valida.
• Si quieres, sal del modo de descripción extendida de scripts con
  NVDA+control+alt+d.

Fallo conocido: Un script añadido para una clase concreta es visible incluso
si el administrador de gestos se abre en otro contexto.

Órdenes de lectura y análisis del registro

El modo lector del registro proporciona órdenes facilitar la lectura y el
análisis del registro. En la ventana del visualizador del registro, el
lector del registro está habilitado por defecto, por lo que los comandos de
lectura del registro están disponibles de inmediato. En otras áreas de
lectura de texto, tales como un editor (por ejemplo, Notepad++) o una página
web (por ejemplo, una incidencia de GitHub), es necesario pulsar
NVDA+control+alt+l para activar el modo de lectura del registro y usar sus
órdenes. Cuando acabes con las tareas de análisis y lectura del registro,
puedes desactivar de nuevo el modo lector del registro con
NVDA+control+alt+l.

Las órdenes disponibles en el modo de lectura del registro se describen a
continuación.

Órdenes de navegación rápida

Existen órdenes de navegación de una sola letra, similares a las usadas en
modo exploración, que permiten moverse por distintos tipos de mensajes en el
registro:

• m: cualquier mensaje
• e: ERROR
• i: IO
• d: DEBUG
• f: INFO
• g: DEBUGWARNING
• w: WARNING

Pulsando la letra te moverás a la siguiente coincidencia de ese mensaje. Al
combinar la letra con la tecla shift, te desplazarás a la coincidencia
anterior.

Abrir un archivo en tu editor

En el registro, alguna línea puede hacer referencia al código fuente:

• Una línea relacionada con una traza contiene la ruta y la línea en el
  archivo, por ejemplo:
  File "virtualBuffers\__init__.pyc", line 226, in _getStoryLength
• La línea de cabecera de un mensaje registrado contiene la función que ha registrado el mensaje, p.ej.:
  INFO - config.ConfigManager._loadConfig (22:45:26.145) - MainThread (16580):

Puedes querer que se abra el archivo que contiene el código para comprender
el contexto de la traza o el mensaje registrado. Pulsa la C para abrir el
archivo.

Para que esta característica funcione, necesitas configurar el comando de tu
editor favorito. Si no estás ejecutando NVDA desde el código fuente, la
ubicación del código también debería estar configurada. Para más información
sobre la configuración, consulta el párrafo de configuración de la caja de
herramientas de desarrollo y pruebas de NVDA.

Extensión de la consola Python

Función openCodeFile

En la consola, puedes llamar a la siguiente función para ver el código fuente que define la variable myVar:
openCodeFile(myVar)

Para que esta característica funcione, necesitas configurar el comando de tu
editor favorito. Si no estás ejecutando NVDA desde el código fuente, la
ubicación del código también debería estar configurada. Para más información
sobre la configuración, consulta el párrafo de configuración de la caja de
herramientas de desarrollo y pruebas de NVDA.

Se puede llamar a la función openCodeFile en objetos definidos en el
código de NVDA o en objetos definidos por los complementos. No se puede
llamar en objetos cuyo código fuente no está disponible, tales como los
incorporados en Python.

Si todavía no has importado el objeto en la consola, también puedes pasar su
nombre como parámetro a la función openCodeFile.

A continuación hay ejemplos de llamadas al código de NVDA:

• Ver la definición de la función speech.speech.speak:
  openCodeFile(speech.speech.speak)
  o con el nombre pasado como parámetro:
  openCodeFile("speech.speech.speak")
• Ver la definición de la clase TextInfo:
  openCodeFile(textInfos.TextInfo)
• Ver la definición del método copyToClipboard de la clase TextInfo:
  openCodeFile(textInfos.TextInfo.copyToClipboard)
• Ver la definición de clase del objeto con el foco:
  openCodeFile(focus)
• Abrir el archivo api.py que define el módulo api:
  openCodeFile(api)

Script de inicio de la consola Python

Puedes definir un script personalizado, que se ejecutará en el espacio de
nombres de la consola Python al abrirla por primera vez, o si se recarga el
complemento (NVDA+control+f3) después de haber abierto ya la consola.

Por ejemplo, el script te permite ejecutar importaciones y definir alias que podrás usar directamente en la consola, como se muestra a continuación:

# Various import that I want in the console.
import globalVars as gv
import core
import ui
# Aliases
ocf = openCodeFile

El script de la consola Python debería encontrarse en la siguiente ubicación: RutaConfiguraciónNVDA\ndtt\consoleStartup.py
Por ejemplo:
C:\Users\myUserName\AppData\Roaming\nvda\ndtt\consoleStartup.py

Registrar la pila de llamadas de la función de voz

A veces, puedes querer saber qué parte del código es responsable de
verbalizar algo. Para ello, puedes habilitar el registro de traza de pila de
la función de voz pulsando NVDA+control+alt+s. Cada vez que NVDA hable, se
grabará una traza de pila en el registro.

Nota: puedes modificar directamente el archivo del script para parchear otra
función. Consulta las instrucciones en el propio archivo para más detalles.

Configuración de herramientas de depuración y pruebas de NVDA

Las órdenes del lector del registro y la extensión de la consola Python
pueden requerir una configuración específica. Para usar funciones que
permiten visualizar el código fuente en tu editor, primero deberías
configurar la línea de órdenes de tu editor. Si es necesario visualizar un
archivo de NVDA y no lo ejecutas desde el código fuente, también tienes que
configurar la ruta al código fuente de NVDA.

Configuración de la línea de órdenes del editor

Para usar la orden Abrir código fuente o la orden de consola
openCodeFile, primero debes configurar el comando al que se llamará para
abrir el archivo en tu editor favorito. Para ello, abre la consola de NVDA
(NVDA+control+Z), teclea la siguiente línea y pulsa intro:
config.conf['ndtt']['sourceFileOpener'] =
r'"C:\path\to\my\editor\editor.exe" "{path}":{line}' Por supuesto, deberías
modificar esta línea en función de la ubicación y el nombre real de tu
editor, y su sintaxis para abrir archivos. {path} será sustituida por la
ruta completa del archivo que se abrirá, y {line} por el número de línea
donde se situará el cursor. Por ejemplo, para configurar Notepad++ habría
que escribir el siguiente comando: config.conf['ndtt']['sourceFileOpener']
= r'"C:\Program Files\Notepad++\notepad++.exe" "{path}" -n{line}'

Configuración de la ruta al código fuente de NVDA

Cuando un archivo relacionado con el núcleo de NVDA aparece en una traza, la
línea tiene este formato: File "config\profileUpgrader.pyc", line 30, in
upgrade

Si no ejecutas NVDA desde el código fuente, puedes indicar una ubicación
alternativa donde buscar el archivo de código fuente, como por ejemplo el
lugar donde has clonado el repositorio de NVDA. En este caso, debes
configurar la ruta donde tengas situados los archivos con el código fuente
de NVDA.

Para ello, abre la consola de NVDA (NVDA+control+Z), teclea la siguiente
línea y pulsa intro: config.conf['ndtt']['nvdaSourcePath'] =
r'C:\RutaEjemplo\GIT\nvda\source' Por supuesto, sustituye la ruta al código
fuente de NVDA con la correcta.

Asegúrate, no obstante, de que la versión de tu archivo fuente (por ejemplo,
commit de Git) es la misma que la de la instancia de NVDA en ejecución.

Registro de cambios

Versión 3.0

• En un registro, ahora se puede pulsar la C en una línea de cabecera de
  mensaje para abrir el módulo o función que lo emitió.
• En la consola, la función openCodeFile puede recibir como parámetro el
  objeto o una cadena que contenga su nombre.
• Nueva función: archivo de inicio de la consola de NVDA: si existe, el
  archivo tuCarpetaDeConfiguraciónDeNVDA\ndtt\consoleStartup.py se ejecutará
  al abrir la consola Python por primera vez o cuando se recarguen los
  complementos.
• Diversas correcciones menores para la función de la consola Python
  openCodeFile y la orden para abrir el archivo de código fuente
  correspondiente a una línea del registro.
• Corregido un problema al intentar anunciar roles y estados en el
  explorador de objetos en versiones antiguas de NVDA.
• El complemento ya no causa problemas con el interceptor de árbol al usar
  UIA en Edge.

Versión 2.1

• Diversas correcciones de fallos y refactorización y limpieza del código
  para tener en cuenta todos los casos de uso: todas las versiones
  soportadas, instalado vs. ejecutado desde el código fuente,
  etc. (colaboración de Łukasz Golonka)
• Reescritura del módulo compa (colaboración de Łukasz Golonka)
• Ahora, el diálogo para reiniciar se puede abrir sólo una vez.
• Los atajos del explorador de objetos ahora vienen por defecto sin asignar
  y deben ser asignados por el usuario.
• En el explorador de objetos, una pulsación doble para llamar al script que
  indica la propiedad del objeto ahora muestra la información indicada en un
  mensaje explorable.

Versión 2.0

• Nueva función: diálogo de reiniciar mejorado para indicar algunas opciones
  extra al reiniciar NVDA.
• Nueva función: modo de descripción extendida.
• Función para reproducir sonidos de error armonizada entre las versiones
  anterior y posterior a la 2021.3 de NVDA.
• Nueva función: las órdenes del lector del registro ahora están disponibles
  en el visualizador del registro y, opcionalmente, en cualquier cuadro de
  edición y en páginas web.
• Nueva función: en la consola Python, está disponible una función
  openCodeFile para ver el código fuente de un objeto.
• Algunas funciones están ahora deshabilitadas en modo seguro por motivos de
  seguridad.
• Se ha extendido el rango de compatibilidad del complemento (de 2019.2 a
  2021.1).
• Las liberaciones ahora se llevan a cabo con una acción de GitHub en lugar
  de AppVeyor.

Versión 1.0

• Versión inicial.

https://www.nvaccess.org/files/nvda/documentation/userGuide.html#CommandLineOptions

https://www.nvaccess.org/files/nvda/documentation/userGuide.html#PlayErrorSound

https://www.nvaccess.org/files/nvda/documentation/developerGuide.html#toc22

• Autor: Neil Soiffer
• Versión actual: 0.6.6 estable
• Compatibilidad con NVDA: de 2024.1 en adelante
• Descargar versión estable
• Ver código fuente en GitHub

Nota: esta ficha ha sido elaborada a partir de la descripción traducida del complemento, y de la información disponible en la web de MathCat. El archivo léame del repositorio de GitHub no contiene información suficiente que nos permita hacer una traducción directa, como en otras ocasiones.
MathCat es un reemplazo de MathPlayer, que ha sido descontinuado. Proporciona soporte de voz y Braille, y también soporta los tres modos de navegación de MathPlayer.
La versión inicial de MathCat está sólo en inglés, pero se ha diseñado pensando en la posibilidad de añadir traducciones.
El autor de este complemento es el mismo desarrollador de MathPlayer, que comenzó a desarrollarlo en 2004 como complemento de Internet Explorer con el objetivo de convertir contenido en lenguaje MathML a algo que los usuarios ciegos puedan entender, independientemente de que lo escuchen o lo lean en braille. Durante bastante tiempo, constituyó la solución más completa de este tipo. Cuando Internet Explorer comenzó a restringir la ejecución de complementos, MathPlayer quedó como biblioteca de accesibilidad para lectores de pantalla. Aunque siempre ha sido gratuito, se trata de un software propietario.
MathCat no es realmente un complemento de NVDA, aunque en este caso se distribuya y se pueda usar como tal. Se trata de una biblioteca escrita en lenguaje Rust, cuyo objetivo es llegar a tantas tecnologías de asistencia como sea posible. A diferencia de MathPlayer, MathCat no es una solución que se pueda implementar en el navegador.

• Autores: Rui Fontes y Ângelo Abrantes
• Versión actual: 2024.11.02 estable
• Compatibilidad con NVDA: de 2019.3 en adelante
• Descargar
• Ver código fuente en GitHub

Este complemento usa el motor libre y de código abierto Tesseract OCR para realizar reconocimiento óptico de caracteres en un archivo de imagen, pdf, jpg, tif o de otro tipo, sin que sea necesario abrirlo. También puede escanear y reconocer un documento en papel mediante un escáner compatible con WIA. En las preferencias de NVDA, se añade la categoría TesseractOCR, donde se puede indicar el idioma usado durante el reconocimiento y los tipos de documentos a reconocer.

Atajos

Los atajos por defecto son:

• Windows+control+r: reconoce el documento seleccionado.
• Windows+control+shift+r: escanea y reconoce un documento desde el escáner.

A continuación, espera a que se abra el fichero ocr.txt con el texto reconocido. Si quieres conservar el texto reconocido, ¡no olvides guardar el documento con otro nombre y en otro lugar, ya que todos los archivos de la carpeta temporal se eliminan al comienzo del siguiente proceso OCR!
Estas órdenes pueden modificarse desde el diálogo Gestos de entrada, en la categoría «TesseractOCR».

Actualización automática

Este complemento incluye una función de actualización automática. La comprobación de una nueva versión se realizará cada vez que se cargue NVDA. Si la quieres, ve a NVDA, Preferencias, Opciones, y marca la casilla en la categoría del complemento.

Problemas conocidos

• Esta versión sólo funciona en Windows de 64 bits.
• Al elegir la opción «diversos» en el cuadro combinado «Tipo de documentos», el texto reconocido puede aparecer con muchas líneas en blanco. Este es un problema conocido de Tesseract y, sin consumir un montón de tiempo de procesamiento, todavía no he encontrado una solución. ¡Pero aún no me he rendido!

Idiomas soportados

Los idiomas soportados en esta versión son: africano, amárico, árabe, búlgaro, burmés, catalán / valenciano, chino simplificado, chino tradicional, croata, checo, danés, alemán, holandés, inglés, finés, francés, gallego, georgiano, griego, hebreo, hindi, húngaro, islandés, indonesio, irlandés, italiano, japonés, canarés, Kirghiz, coreano, letón, lituano, macedonio, nepalí, noruego, panyabí, persa, polaco, portugués, rumano / moldavo, ruso, serbio (latino), eslovaco, esloveno, español, sueco, tamil, tailandés, turco, ucraniano, urdu y vietnamita.

Tipos de imagen soportados

Este complemento soporta los siguientes tipos de archivos: pdf, jpg, tif, png, bmp, pnm, pbm, pgm, jp2, gif, jfif, jpeg, tiff, spix y webp.

• Autor: Asociación Comunidad Hispanohablante de NVDA, en colaboración con David CM. Idea original de Christopher Toth y Tyler Spivey
• Versión actual: 2024.12.15 estable, 2023.9.7-dev en desarrollo
• Compatibilidad con NVDA: de 2019.3 en adelante
• Descargar
• Descargar versión de desarrollo
• Ver código fuente en GitHub

Nota: para facilitar la descarga a usuarios que necesitan asistencia o
formación y tienen conocimientos limitados en informática, proporcionamos un
enlace alternativo a la versión estable más reciente que es fácil de
recordar y compartir. Puedes ir a nvda.es/tele y
descargar el complemento directamente, sin páginas web intermedias.

Bienvenido al complemento TeleNVDA, que te permitirá conectarte a otro
equipo que ejecute el lector de pantalla gratuito NVDA. Puedes conectarte al
equipo de otra persona, o permitir a una persona de confianza que se conecte
a tu sistema para realizar un mantenimiento rutinario, diagnosticar un
problema, o enseñarte algo. Este complemento es una versión modificada del
complemento NVDARemote, y su mantenimiento está a
cargo de la comunidad hispanohablante de NVDA. Es totalmente compatible con
NVDA Remote. Estas son las diferencias actuales:

• Una opción permite bloquear los comandos remotos de voz que no sean texto.
• Soporte mejorado para servidores proxy y servicios ocultos TOR (es
  necesario el complemento Soporte
  Proxy).
• Posibilidad de cambiar la tecla f11 por otro gesto. Ahora funciona como un
  script común, por lo que puedes asignar otros gestos en el diálogo «Gestos
  de entrada».
• Capacidad de ignorar completamente el siguiente gesto inmediato, es útil
  si necesitas enviar a la máquina remota el gesto utilizado para alternar
  entre el equipo local y la máquina remota.
• Posibilidad de intercambiar pequeños ficheros (hasta 10 MB) entre usuarios
  conectados a la misma sesión.
• Posibilidad de redirigir puertos mediante UPNP.
• Posibilidad de usar un servicio de comprobación de puertos personalizado.
• Algunos retoques a la interfaz gráfica.
• Varias correcciones de fallos.

Antes de empezar

Es necesario tener instalado NVDA en ambos equipos, y obtener el complemento
TeleNVDA.

La instalación de NVDA y del complemento no varía con respecto a otras. Si
necesitas más información, puedes encontrarla en la guía de usuario de NVDA.

Actualizaciones

Cuando actualices el complemento, si has instalado TeleNVDA en el escritorio
seguro, es recomendable que lo actualices también allí.

Para hacerlo, primero actualiza el complemento normalmente. Después, abre el
menú de NVDA, preferencias, Opciones Generales, y pulsa el botón etiquetado
como «Utilizar opciones actualmente guardadas en la autentificación (logon)
y otras pantallas seguras (requiere privilegios de administrador)».

Iniciar una sesión remota a través de un servidor externo

En el equipo controlado

1. Abre el menú de NVDA, herramientas, remoto, conectar. O pulsa
   directamente NVDA+alt+retroceso página. Se puede modificar este gesto
   desde el diálogo Gestos de entrada de NVDA.
2. Elige cliente en el primer grupo de botones de opción.
3. Elige permitir que controlen este equipo en el segundo grupo de botones
   de opción.
4. En el campo equipo o servidor, introduce el servidor al que te vas a
   conectar, por ejemplo remote.nvda.es. Cuando el servidor use un puerto
   distinto al que este complemento utiliza por defecto, puedes introducir
   su dirección en formato <equipo>:<puerto>, por ejemplo
   remote.nvda.es:1234. Si te conectas a una dirección IPV6, introdúcela
   entre corchetes. Por ejemplo: [2603:1020:800:2::32].
5. Introduce una clave en el campo clave, o pulsa el botón generar clave. La
   clave es lo que otros usarán para controlar tu equipo. El equipo
   controlado y todos sus clientes deben usar la misma clave.
6. Pulsa aceptar. Hecho esto, escucharás un pitido y conectado. Si el
   servidor incluye un mensaje de bienvenida, este se mostrará en un cuadro
   de diálogo. Verás este diálogo cada vez que te conectes o sólo la primera
   vez, dependiendo de la configuración del servidor.

En el equipo desde el que se controla

1. Abre el menú de NVDA, herramientas, remoto, conectar. O pulsa
   directamente NVDA+alt+retroceso página. Se puede modificar este gesto
   desde el diálogo Gestos de entrada de NVDA.
2. Elige cliente en el primer grupo de botones de opción.
3. Selecciona controlar otro equipo en el segundo grupo de botones de
   opción.
4. En el campo equipo o servidor, introduce el servidor al que te vas a
   conectar, por ejemplo remote.nvda.es. Cuando el servidor use un puerto
   distinto al que este complemento utiliza por defecto, puedes introducir
   su dirección en formato <equipo>:<puerto>, por ejemplo
   remote.nvda.es:1234. Si te conectas a una dirección IPV6, introdúcela
   entre corchetes. Por ejemplo: [2603:1020:800:2::32].
5. Introduce una clave en el campo clave, o pulsa el botón generar clave. El
   equipo controlado y todos sus clientes deben usar la misma clave.
6. Pulsa aceptar. Hecho esto, escucharás un pitido y conectado. Si el
   servidor incluye un mensaje de bienvenida, este se mostrará en un cuadro
   de diálogo. Verás este diálogo cada vez que te conectes o sólo la primera
   vez, dependiendo de la configuración del servidor.

Avisos de seguridad de la conexión

Si te conectas a un servidor con un certificado SSL no válido, recibirás un
aviso sobre la seguridad de la conexión.

Esto puede significar que tu conexión es insegura. Si confías en la huella
del servidor, puedes pulsar «Conectar» para conectarte una vez, o «Conectar
y no volver a preguntar para este servidor» para conectarte y guardar la
huella.

Conexiones directas

La opción servidor en el diálogo conectar permite establecer una conexión
directa.

Una vez seleccionada, elige el modo en el que se comportará tu equipo
durante la conexión.

La otra persona se conectará usando el contrario.

Una vez seleccionado el modo, puedes usar el botón obtener IP externa para
obtener tu dirección IP externa y asegurarte de que el puerto que has
introducido en el campo puerto está abierto correctamente. Si está activado
en tu router, puedes redirigir el puerto usando UPNP antes de comprobar si
el puerto está abierto.

Si portcheck detecta que tu puerto (por defecto 6837) no está abierto,
aparecerá una advertencia.

Redirige tu puerto y prueba otra vez. Comprueba también que se permite el
proceso de NVDA en el firewall de Windows.

Nota: el proceso de abrir puertos, habilitar UPNP o configurar el firewall
de Windows está fuera del propósito de este documento. Consulta la
documentación que acompaña a tu router para más información.

Introduce una clave en el campo clave, o pulsa generar. La otra persona
necesitará tu IP externa junto con la clave para conectar. Si has
introducido un puerto distinto al que se usa por defecto (6837) en el campo
puerto, asegúrate de que la otra persona añade el puerto alternativo a la
dirección del equipo usando el formato <ip externa>:<puerto>.

Si quieres redirigir el puerto elegido usando UPNP, marca la casilla «Usar
UPNP para redirigir este puerto si es posible».

Una vez pulses aceptar, estarás conectado. Cuando la otra persona se
conecte, podrás usar TeleNVDA con normalidad.

Control sobre el equipo remoto

Una vez la sesión está conectada, el usuario del equipo controlador puede
pulsar f11 para empezar a controlar el equipo remoto (por ejemplo, enviando
pulsaciones de teclado o entrada Braille). Este gesto se puede cambiar desde
el diálogo Gestos de entrada de NVDA.

Cuando NVDA diga controlando equipo remoto, las teclas que pulses en tu
teclado o pantalla braille irán al equipo remoto. Más aún, si el equipo
controlador dispone de una pantalla braille, la información remota se
mostrará en ella. Pulsa f11 de nuevo para detener el envío de pulsaciones y
volver al equipo controlador.

Para mayor compatibilidad, asegúrate de que las distribuciones de teclado de
ambos equipos coinciden.

Compartir tu sesión

Para compartir un enlace que permita a alguien más unirse fácilmente a tu
sesión de TeleNVDA, selecciona Copiar enlace en el menú remoto. También se
pueden asignar gestos desde el diálogo Gestos de entrada para acelerar esta
tarea.

Puedes elegir entre dos formatos de enlace. El primero es compatible tanto
con NVDA Remote como con TeleNVDA, y es el más recomendado por ahora. El
segundo es compatible sólo con TeleNVDA.

Si estás conectado como controlador, este enlace permitirá a cualquiera
conectarse y ser controlado.

Si por el contrario has configurado tu equipo para ser controlado, el enlace
permitirá a la gente con la que lo compartas controlarlo.

Muchas aplicaciones permiten a los usuarios activar este enlace
automáticamente, pero si no se abre desde una aplicación específica, puedes
copiarlo y abrirlo desde el diálogo ejecutar.

Ten en cuenta que el enlace compartido puede no funcionar si lo copias desde
un servidor que funciona en modo de conexión directa.

Enviar ctrl+alt+supr

Aunque el envío de teclas esté activado, la combinación ctrl+alt+supr no se
puede enviar como el resto.

Si necesitas enviar ctrl+alt+supr, y el sistema remoto se encuentra en el
escritorio seguro, elige esta opción.

Enviar tecla de alternar entre equipo local y equipo remoto

Usualmente cuando pulsas el gesto asignado para cambiar entre el equipo
local y el remoto, este no se enviará al equipo controlado si no que
alternará entre la máquina local y el equipo remoto.

Si necesitas enviar este o cualquier gesto a la máquina remota, puedes
omitir este comportamiento para el siguiente gesto inmediato activando el
escript ignorar el siguiente gesto.

Por defecto, este script está asignado a la tecla control + f11. Este gesto
se puede cambiar desde el diálogo Gestos de entrada de NVDA.

Al llamar a este script, se ignorará el siguiente gesto y se enviará a la
máquina remota, incluido el gesto para activar el script ignorar el
siguiente gesto. Una vez enviado el siguiente gesto, regresará al
comportamiento habitual.

Control remoto de un equipo desatendido

A veces puedes querer controlar uno de tus propios equipos remotamente. Esto
es especialmente útil si te encuentras viajando, y quieres controlar el pc
de casa desde el portátil, o controlar un equipo en una habitación de tu
casa mientras estás fuera con otro pc. Con una preparación un poco avanzada
esto se hace posible.

1. Entra en el menú de NVDA, elige herramientas y a continuación
   remoto. Finalmente, pulsa intro en opciones.
2. Marca la casilla que dice «Conectar automáticamente al servidor de
   control al arrancar».
3. Elige usar un servidor de control remoto o alojar la conexión
   localmente. Si decides alojar la conexión, puedes intentar redirigir los
   puertos con UPNP marcando la casilla proporcionada.
4. Elige permitir que controlen este equipo en el segundo grupo de botones
   de opción.
5. Si creas tu propio servidor, tendrás que asegurarte de que el puerto
   introducido en el campo puerto (por defecto 6837) está abierto en el
   equipo controlado y los equipos controladores pueden conectarse a él.
6. Si quieres usar un servidor de control remoto, rellena los campos equipo
   o servidor y clave, pulsa tabulador hasta aceptar, y pulsa intro. Ten en
   cuenta que la opción generar clave no se encuentra disponible en esta
   situación. Es mejor escribir una clave que se pueda recordar para que
   puedas usarla fácilmente desde cualquier lugar remoto.

Para un uso avanzado, puedes también configurar TeleNVDA para que se conecte
a un servidor local o remoto en modo controlador. Si quieres esto,
selecciona controlar otro equipo en el segundo grupo de botones de opción.

Nota: las opciones relacionadas con conectar automáticamente al arrancar en
el diálogo de opciones no tienen efecto hasta que se reinicia NVDA.

Silenciar la voz del equipo remoto

Si no quieres oír la voz del ordenador remoto o sonidos específicos de NVDA,
es tan simple como ir al menú de NVDA, herramientas, remoto. Baja con flecha
abajo hasta oír silenciar equipo remoto, y pulsa intro. Ten en cuenta que
esta opción no desactivará la salida braille remota a la pantalla
controladora cuando el equipo controlador esté enviando pulsaciones.

Finalizar una sesión remota

Para finalizar una sesión remota, haz lo siguiente:

1. En el equipo controlador, pulsa f11 para dejar de controlar el equipo
   remoto. Deberías escuchar o leer el mensaje: «Controlando equipo
   local». Si en vez de eso oyes o lees un mensaje diciendo que estás
   controlando el equipo remoto, pulsa f11 nuevamente.
2. Accede al menú de NVDA, herramientas, remoto, y pulsa intro en
   desconectar.

Alternativamente, puedes pulsar NVDA+alt+avance página para desconectar la
sesión directamente. Este gesto se puede cambiar desde el diálogo Gestos de
entrada de NVDA. Para mantener a salvo a la otra persona, puedes pulsar este
gesto mientras envías teclas para desconectar el equipo remoto.

Enviar portapapeles

La opción enviar portapapeles en el menú remoto te permite enviar texto
desde tu portapapeles.

Cuando esté activada, cualquier texto en el portapapeles se enviará a los
otros equipos.

Enviar archivos

La opción Enviar archivo en el menú remoto permite enviar pequeños archivos
a todos los miembros de la sesión, incluyendo el equipo controlado. Ten en
cuenta que sólo puedes enviar archivos menores de 10 MB. No se permite
enviar o recibir archivos en pantallas seguras.

Ten en cuenta también que enviar archivos puede consumir demasiado tráfico
de red en el servidor, dependiendo del tamaño del archivo, los ordenadores
conectados a la misma sesión y la cantidad de archivos enviados. Contacta
con el administrador de tu servidor y pregúntale si se factura el
tráfico. En tal caso, plantéate otra plataforma para intercambiar archivos.

Cuando el archivo se reciba en los equipos remotos, aparecerá un cuadro de
diálogo Guardar como, lo que te permitirá elegir dónde guardarlo.

Configurar TeleNVDA para que funcione en el escritorio seguro

Para que TeleNVDA funcione en el escritorio seguro, el complemento debe
estar instalado en el NVDA que se ejecuta en el escritorio seguro.

1. En el menú de NVDA, selecciona preferencias, y a continuación opciones
   generales.
2. Pulsa tabulador hasta el botón Utilizar opciones actualmente guardadas en
   la autentificación (logon) y otras pantallas seguras (requiere
   privilegios de administrador), y pulsa Intro.
3. Responde sí a las advertencias sobre copiar la configuración y los
   complementos, y responde a la advertencia del control de cuentas de
   usuario que debería aparecer.
4. Cuando la configuración se haya copiado, pulsa intro para aceptar la
   confirmación. Pulsa tabulador hasta aceptar y pulsa intro de nuevo para
   salir del diálogo.

En cuanto TeleNVDA esté instalado en el escritorio seguro, si te controlan
en una sesión remota, el escritorio seguro tendrá soporte de voz y braille
cuando se entre en él.

Eliminación de las huellas de los certificados SSL

Si ya no quieres confiar en huellas de servidores en las que has confiado,
puedes eliminar todas las huellas de confianza pulsando el botón «Eliminar
todas las huellas de confianza» desde el diálogo de opciones.

Uso de un servicio personalizado de comprobación de puertos

Por defecto, TeleNVDA comprueba los puertos abiertos usando un servicio
proporcionado por la comunidad de NVDA en español. Puedes cambiar la URL del
servicio desde el diálogo de opciones. Asegúrate de que el puerto a
comprobar es parte de la URL personalizada y los resultados se devuelven en
el formato esperado. Se distribuye un script de muestra para la comprobación
de puertos en el repositorio de TeleNVDA, por lo que puedes alojar tu propia
copia si lo deseas.

Alteración de TeleNVDA

Este proyecto se encuentra cubierto por la licencia pública general GNU,
versión 2 o posterior. Puedes clonar este repositorio para hacer
alteraciones a TeleNVDA, siempre que leas, entiendas y respetes los términos
de esta licencia. El módulo MiniUPNP está cubierto por una licencia BSD de 3
cláusulas.

Dependencias de terceros

Se pueden instalar con Pip:

• Markdown
• scons

Para compilar el ejecutable manejador de URLs, es necesario disponer de
Visual Studio 2019 o posterior.

Para empaquetar el complemento para su distribución:

1. Abre una línea de órdenes y cambia a la raíz de este repositorio
2. Ejecuta la orden scons. El complemento creado, si no hubo errores, se
   encuentra en la carpeta actual.