Versión 1.0.0 para Tiresias. Visor accesible, seguimiento en tiempo real y caja de herramientas para las consolas de Windows.
El complemento captura el contenido de una consola y lo presenta en un cuadro de texto de solo lectura, cómodo para voz y braille. En él puede recorrer con libertad historiales grandes sin depender del cursor de la terminal ni mover su posición de lectura.
El complemento no hace nada en modo seguro ni con la pantalla de bloqueo o el escritorio seguro.
Instale el archivo consoleLog.tiresias-addon desde Complementos, Administrador de complementos, Instalar desde archivo o desde la tienda de complementos, y reinicie Tiresias si se le pide.
Como el original, el complemento no impone combinaciones de teclas, para no chocar con Tiresias, las terminales u otros complementos. Asígnelas así:
| Orden | Qué hace | Gesto por defecto |
|---|---|---|
| Muestra el visor de consola | Captura la consola en primer plano y abre su visor (o trae al frente el que ya tenga abierto). Mientras lee emite un pitido por segundo. | Sin asignar |
| Copia el contenido completo de la consola al portapapeles (rápido) | Copia todo el contenido procesado sin abrir el visor. | Sin asignar |
| Pega el contenido del portapapeles mediante clic derecho en la consola enfocada | Hace clic derecho en el centro de la consola (pega en Console Host y otras terminales) y devuelve el puntero a su sitio. | Sin asignar |
| Abre el lanzador de consolas de Windows | Abre una terminal en la carpeta seleccionada del Explorador o en el escritorio. | Sin asignar |
Sitúe el foco en una terminal y ejecute la orden del visor. Si la ventana no es una consola se anuncia «Esta no es una ventana de consola.».
El contenido se abre al principio del documento, en una ventana maximizada (o con el tamaño y la posición que recuerde). El título incluye el nombre de la consola, su proceso y su ventana. La barra de estado indica la línea, la columna y el estado del seguimiento.
Puede tener abiertos tantos visores como ventanas de consola. Cada uno conserva su captura, su seguimiento y su ciclo de vida. Si vuelve a ejecutar la orden desde una consola que ya tiene visor, se trae al frente el existente en lugar de duplicarlo. En terminales con pestañas o paneles se sigue el área de texto que tenía el foco al abrir el visor.
| Tecla | Acción |
|---|---|
| Alt | Activa la barra de menús (Archivo, Edición, Ver, Plugins y Ayuda) |
| Control+F | Busca texto (sin distinguir mayúsculas) |
| F3 / Mayúsculas+F3 | Coincidencia siguiente / anterior (da la vuelta al llegar al final) |
| Control+G | Va a una línea |
| Control+S | Guarda el documento en UTF-8 (Archivo, Guardar como) |
| Control+C | Copia la selección |
| Control+A | Selecciona todo |
| Control+P | Abre las opciones del complemento |
| F1 | Anuncia la línea y la columna |
| F2 | Muestra la ayuda de teclas |
| F5 | Captura de nuevo la consola (Ver, Actualizar contenido) |
| Control+Mayúsculas+F | Activa o desactiva el seguimiento automático (Ver, Seguimiento automático) |
| Control+Fin | Va al final, a lo más reciente |
| Escape o Alt+F4 | Cierra el visor |
El menú Ayuda tiene además «Documentación del complemento», que abre este documento. Las herramientas usan primero el texto seleccionado; si no hay selección, procesan todo el documento.
Active Ver, Seguimiento automático o pulse Control+Mayúsculas+F. El seguimiento:
Así una terminal rápida no crea hilos de lectura sin límite y, sobre todo, no se mueve el foco: si está leyendo una línea anterior, el cursor, la selección y el desplazamiento se quedan donde estaban; si estaba al final, el visor sigue el final. Una línea de progreso o un indicador que cambia se actualiza en su sitio.
El intervalo es adaptativo: si una captura tarda, el periodo aumenta temporalmente (hasta 10 segundos) y vuelve poco a poco al configurado cuando la terminal se recupera. Si una captura falla durante el seguimiento, el intervalo se duplica y no se muestra ningún mensaje; con F5 sí se avisa del error.
El modo Conservar historial acumula las líneas que desaparecen cuando el búfer de la terminal se desplaza. Las aplicaciones de pantalla completa que redibujan su interfaz (monitores de procesos, editores) se actualizan en su sitio cuando no hay un solapamiento fiable.
El límite predeterminado del documento es de 5 millones de caracteres. Al alcanzarlo se quitan líneas completas por el principio. Puede cambiarlo o usar cero para no limitarlo; un documento sin límite puede consumir mucha memoria durante procesos largos.
Con las alertas activadas, cada captura nueva se revisa en busca de los patrones configurados: si aparece alguno se reproduce el sonido «Exclamación» de Windows y se anuncia «Alerta detectada» con la línea. Solo se analiza el texto nuevo (como mucho sus cinco últimas líneas) y se da una alerta por captura, así una alerta antigua no se repite. Las regiones en modo «Monitorizar cambios» de las definiciones de ventana anuncian sus cambios.
En NVDA, el original incorporaba una versión limitada del cambio oficial de NVDA (PR #20177) para que una ráfaga de salida no bloqueara el lector. Tiresias no se bloquea con las ráfagas: su voz es asíncrona, agrupa los cambios de la consola y lee como mucho el número de líneas de su opción «Máximo de líneas que se leen de una vez». Pero una salida continua sí puede saturar la voz: se encolan lotes y lo que se oye va cada vez más retrasado respecto a la pantalla.
Por eso la opción Proteger la voz frente a ráfagas de salida de las consolas adapta la intención del original a Tiresias. Viene desactivada de fábrica, porque Tiresias ya limita las ráfagas por sí mismo y con ella se dejan de leer líneas; actívala si la salida continua de un programa te deja la voz muy retrasada:
La captura completa sigue disponible en el visor: el límite solo afecta a la lectura automática de las consolas. A diferencia del original, se activa y desactiva al momento, sin reiniciar.
conhost.exe), Símbolo del sistema y Windows PowerShell clásico: se lee el historial completo del búfer con la API de consola, por bloques. Si no es posible (consola de administrador, o Tiresias ejecutado con consola propia) se usa UI Automation y, en último caso, las líneas visibles.Las terminales modernas se leen con el patrón de texto de Microsoft UI Automation; la compatibilidad depende de que cada emulador exponga el contenido de su sesión. En terminales con pestañas se prioriza el área de texto visible de la ventana original.
El texto se procesa según la terminal detectada (perfiles): por ejemplo, en CMD no se limpian códigos ANSI y en htop se condensan los símbolos repetidos de sus barras.
Abre una terminal en la carpeta seleccionada del Explorador (o en la carpeta abierta) o, desde el escritorio, en la carpeta del icono enfocado o en el propio escritorio. Si se ha seleccionado un archivo se usa su carpeta. Cada consola se puede abrir normal o como administrador:
La primera vez se buscan las consolas instaladas en segundo plano (se anuncia «Buscando las consolas instaladas...»). Puede recordar la última opción utilizada y mostrar también las consolas no instaladas (marcadas «no instalada»). En el lanzador, Intro abre la consola elegida y Escape cancela.
Se activan o desactivan en Opciones, Plugins y aparecen en el menú Plugins del visor, agrupadas por categorías si se desea. Los resultados en texto se muestran en un cuadro de lectura con «Copiar todo» y «Guardar como»; las listas, en una lista con filtro donde Intro copia el elemento elegido.
El chat y los informes pueden usar dos tipos de proveedor (Opciones, IA, o menú IA, Proveedor del chat):
gemini-3.6-flash; la lista de modelos Gemini y Gemma se pide a la API y se guarda un día en caché (si la consulta falla se usa la caché antigua o una lista de reserva). Los modelos retirados de configuraciones antiguas se cambian por el predeterminado.Cada turno se presenta como un artículo HTML con el autor como encabezado. La ventana tiene el historial, las casillas «Usar selección» y «Usar consola» (el contexto que se envía), los botones «Adjuntar .txt...» (archivos de texto de hasta 1 MB), «Auto-reparar error» (pide la corrección del error del registro o de la selección), «Abrir historial HTML» y «Limpiar chat», y el cuadro «Mensaje» con el botón «Enviar». El menú IA permite gestionar las claves de Google (una por línea), elegir el proveedor y el modelo, editar las instrucciones de sistema (con «Restablecer por defecto»), mantener o no el historial de la conversación (se envían los diez últimos turnos) y cerrar el chat. Si el chat ya está abierto, al elegirlo de nuevo con texto seleccionado en el visor se usa esa selección.
| Tecla | Acción |
|---|---|
| F6 | Alterna entre el documento HTML y los controles o botones |
| H o 1 a 6 | Navega por los encabezados del documento (modo exploración de Tiresias) |
| Tabulador | Recorre los enlaces y elementos interactivos del HTML |
| Control+Intro | Envía el mensaje del chat |
| J / K | Anuncia el turno siguiente o anterior (fuera del cuadro de mensaje) |
| Escape | Cierra el chat o el informe |
Cuando llega una respuesta solo se anuncia «Respuesta lista. Pulse F6 para leerla.»: el foco y la posición de lectura no se mueven y el contenido no se fuerza por voz. Los enlaces se abren en el navegador. Si WebView2 no está disponible, el historial se muestra como texto y «Abrir historial HTML» abre la versión HTML en el navegador predeterminado. El informe tiene además «Copiar Markdown», «Guardar...» y «Abrir en el navegador».
Están en Preferencias, Opciones, Visor de consola y también en el visor (Archivo, Opciones o Control+P), en pestañas.
-_=! por defecto).Lista de casillas con todas las herramientas; las desmarcadas desaparecen del menú.
Las preferencias se guardan con la configuración de Tiresias (sección consoleLog, con perfiles y valores de fábrica). Las definiciones de ventana, las claves de Google cifradas, la caché de modelos y los HTML que se abren en el navegador se guardan en data\addonsData\consoleLog.
x-goog-api-key, nunca en la dirección de la petición.Compruebe que el foco está dentro de la terminal antes de ejecutar la orden. Si usa un emulador no reconocido, facilite su nombre de proceso, clase de ventana y versión al informar del problema.
La terminal debe exponer texto accesible. Pruebe F5, cambie a la pestaña correcta y verifique que el área admite el patrón de texto de UI Automation. Algunas interfaces aceleradas o sesiones remotas solo exponen la pantalla visible.
Confirme que Seguimiento automático está marcado. Aumente el intervalo si la terminal o el equipo están muy ocupados. Si la ventana original se cerró, cierre también el visor y ábralo desde una terminal activa.
Es lo previsto: se añade al final sin mover la lectura. Pulse Control+Fin para ir al final.
Reduzca el Límite del visor o desactive Conservar el historial. En sesiones muy largas guarde el contenido de vez en cuando.
La consola es de administrador y Tiresias no. Use el mismo nivel de privilegios; por seguridad, es preferible abrir la consola sin elevar siempre que se pueda.
Revise la clave, la conexión, el modelo elegido y la cuota de la API. Con los proveedores de Tiresias, revise Opciones, Inteligencia artificial.
consoleLog_config.json de NVDA.Autor: Héctor J. Benítez Corredera (xebolax@gmail.com). Repositorio del original: github.com/nvda-es/consoleLog.
consoleLog es software libre bajo la Licencia Pública General de GNU. Esta versión para Tiresias es una reescritura con la API de Tiresias.
La superficie HTML accesible del chat y de los informes adapta la idea de wx-accessible-webview, Copyright (c) 2026 Taylor Arndt y Community Access, bajo licencia MIT; su aviso está en LICENCIAS_TERCEROS.txt. Las utilidades de texto se inspiran en «Terminal Access for NVDA».