Code File Catcher: una herramienta para dar contexto a tus consultas a la IA

Muchas veces, cuando queremos pedir ayuda a una IA para depurar un fallo, revisar una estructura o mejorar un código, necesitamos enviar más que una simple función. Necesitamos compartir el contexto completo del proyecto: otros archivos, dependencias, configuraciones, etc.

Los entornos de desarrollo incluyen un navegador de archivos para moverte entre los distintos ficheros de un proyecto pero, en la mayoría de los casos, el navegador de archivos incluye alguna barrera de dificultad o la cantidad de ficheros es bastante grande lo que dificulta la tarea a los desarrolladores con discapacidad o con poca destreza a la hora de moverse en su entorno de desarrollo. Con Code File Catcher puedes hacer eso fácilmente.

Code File Catcher es una aplicación sencilla pero poderosa que te permite seleccionar una carpeta de tu disco, elegir los tipos de archivos de código que quieres incluir, y obtener automáticamente un texto con todo el contenido de esos archivos perfectamente organizado y listo para copiar o exportar.

Esto resulta especialmente útil si estás trabajando con asistentes de inteligencia artificial como ChatGPT, Gemini o similares, que requieren el contexto completo del código para ofrecer respuestas precisas y útiles.

Entre las distintas operaciones que puede realizar actualmente están: recopila todos los archivos fuente relevantes de un proyecto o carpeta, muestra un texto estructurado con el nombre del archivo y su contenido y puede copiar ese texto al portapapeles o exportarlo como archivo `.txt`.

El proyecto está disponible bajo una licencia libre en GitHub. Puedes consultarlo, usarlo, modificarlo y, si lo deseas, contribuir con mejoras o sugerencias. El proyecto está abierto a colaboraciones, especialmente si pueden ayudar a que la herramienta sea aún más útil para más personas.

Puedes encontrar el código del proyecto y participar en él en el repositorio de Code File Catcher en Github.

Nueva configuración para los comandos de VoiceOver para Mac

Una de las formas más rápidas de ampliar la funcionalidad del lector de pantallas para MacOS es a través de los comandos de VoiceOver para Mac. Estos comandos permiten asociar a un atajo de teclado la ejecución de un comando de VoiceOver, la ejecución de un script de AppleScript o la apertura de una aplicación.

Con la publicación de MacOS 15.4 la categoría de comandos para VoiceOver en la aplicación para configurar VoiceOver para Mac ha sufrido muchos cambios. En la versión anterior, dentro de esta categoría, aparecían 4 pestañas para configurar el comportamiento del teclado, del TrackPad, del teclado numérico extendido y una pestaña para los comandos de VoiceOver personalizados por el usuario.

 Desde MacOS 15.4 en la categoría de Comandos encontraremos lo siguiente: distintas casillas de verificación y selectores para permitir y modificar el control mediante el teclado extendido, el Trackpad o la tecla opción; varias opciones para modificar el acceso a la navegación rápida de VoiceOver y la sección de conjunto de comandos que es donde encontramos las opciones para agregar y eliminar los comandos de VoiceOver.

Conjunto de comandos

En esta sección de conjunto de comandos encontraremos un selector que nos permite usar los comandos integrados o los comandos de usuario.

Si marcamos los comandos integrados, desactivaremos todas las personalizaciones de comandos de VoiceOver que hayamos creado. En cambio, seleccionando comandos de usuario activaremos todas las personalizaciones que hayamos registrado en nuestro VoiceOver.

Editar conjunto de comandos del usuario

Al marcar la opción comandos de usuario el botón Editar se activa. Al pulsar este botón accederemos a la pantalla de Editar conjunto de comandos del usuario.

En esta pantalla encontraremos un campo de búsqueda, un selector de filtro de búsqueda, un selector para visualizar los resultados como columnas o como tabla y un área de lista llamada Asignaciones de comandos que contiene todos los comandos disponibles. Justo debajo de la tabla encontraremos el botón Aceptar para guardar los cambios realizados y volver a la pantalla anterior.

Es recomendable seleccionar la visualización como columnas si eres usuario de VoiceOver ya que  recorrer la lista de elementos por categorías se simplifica. Pero si seleccionamos la visualización como tabla nos aparecerá unos botones de Añadir y Eliminar los elementos de la tabla.  

Filtro de listado de comandos

En el contenedor llamado Asignaciones de comandos aparecen todos los comandos disponibles. Esta lista es muy extensa por lo que es recomendable usar las opciones disponibles en el filtro. Al pulsar el botón Filtro de comandos nos aparecerá una lista de selección con las siguientes opciones: todo, teclas de VoiceOver, teclas de opción, teclas de navegación rápida, teclas del teclado numérico, acciones del trackpad, comandos con una entrada asignada, comandos sin entrada asignada, asignaciones de entrada modificadas por el usuario, asignaciones de entrada bloqueadas que no se pueden cambiar, entradas con varios comandos asignados y entradas con varios comandos asignados en la misma categoría.

Con el filtro activado podemos localizar rápidamente qué comandos hemos personalizado, qué comandos de VoiceOver carecen de atajo de teclado o si tenemos algún comando de VoiceOver con varios atajos registrados. Por ejemplo, al seleccionar el filtro Entradas con varios comandos asignados en la misma categoría podemos observar que el atajo Control+Opción+Comando+Mayúsculas+espacio está asignado a Mover hacia abajo el ratón y Mover hacia arriba el ratón. Esto se debe a que con la misma pulsación de teclado podemos mantener un click de ratón o levantar el click de ratón.

Añadiendo un nuevo comando

Podemos utilizar el botón añadir que aparece cuando hemos seleccionado la visualización como tabla.

Al pulsar el botón Añadir aparecerá una nueva fila en la tabla y el cursor de VoiceOver se colocará en la columna de Entrada. En esa columna hay un botón desplegable que nos permitirá seleccionar si el nuevo comando utilizará un comando del Trackpad, del teclado numérico, una pulsación con la tecla Opción o un comando de VoiceOver. Mediante la navegación progresiva por el botón desplegable podemos elegir, por ejemplo, que nuestro atajo sea del tipo Tecla Opción, Letras con Mayúsculas y la combinación ⌥⇧E.

Pulsando la combinación Control+Opción+flecha derecha pasaremos a la columna Categoría, que en estos momentos puede estar vacía. Si volvemos a pulsar Control+Opción+flecha derecha llegaremos a la columna Comando, que es también un botón desplegable.

Al pulsar el botón desplegable para el comando de nuestro atajo de teclado se desplegará un menú progresivo con las siguientes opciones: general, información, navegación, texto, Internet, buscar, tablas, tamaño y posición, audio, braille, efectos visuales, habla, puntos activos, Braille 2D y comandos personalizados. Este último elemento nos permite ejecutar un script, abrir una aplicación, abrir una utilidad, ejecutar un flujo de Automator o ejecutar un atajo de la utilidad de Atajos de MacOS e iOS. Las primeras categorías corresponden a las diversas funciones que puede hacer VoiceOver. De esta forma podemos cambiar algunos de los atajos de teclado de VoiceOver o crear las combinaciones de teclado necesarias para aquellos comandos de VoiceOver que no son cómodos de pulsar en un teclado distinto al teclado inglés de Estados Unidos.

Para nuestro ejemplo buscaremos en la categoría general la opción Desplegar o contraer triángulo desplegable

Una vez seleccionado buscaremos el botón aceptar y nuestro nuevo comando para VoiceOver estará disponible. Así que cuando encontremos un elemento con un conmutador de despliegue, si pulsamos Opción+Mayúsculas+e provocaremos que el control se despliegue o se contraiga en lugar de tener que usar las funciones de ratón de VoiceOver.

Cambiando el comportamiento general de VoiceOver

Aunque, en principio, podemos modificar todos los elementos que aparecen en la lista, hay unas cuantas funciones que no son modificables por lo que no podemos cambiar su asignación de teclas o su gesto para el Trackpad. Eso no nos impide crear un nuevo comando con otra asignación de teclas que no esté en uso y podamos acceder a esa funcionalidad de VoiceOver mediante otro método de teclado o de Trackpad.

Evitar la activación accidental de la navegación rápida de VoiceOver en MacOS

En MacOS se puede activar un modo de navegación rápida para VoiceOver con el cual utilizando los cursores únicamente se puede navegar por la interfaz de una ventana de una aplicación de MacOS. Para activar y desactivar este modo es necesario pulsar a la vez las teclas de flecha izquierda y flecha derecha. Esta combinación de teclas en muchas ocasiones y, sobre todo, utilizando teclados externos provocaba la activación de este modo de navegación de VoiceOver.

Desactivar la activación de la navegación rápida

Desde MacOS 15.4 se ha añadido en las opciones de configuración de VoiceOver elegir el comportamiento de la combinación flecha izquierda+flecha derecha. Para personalizar esta combinación de teclas debemos abrir la ventana de configuración de VoiceOver para MacOs pulsando Control+Opción+F8, dentro de la categoría Comandos encontraremos una opción llamada Teclas de flecha izquierda y derecha que nos permite elegir entre tres opciones: Activa o desactiva la navegación rápida con las teclas de flecha, Activa o desactiva la navegación rápida con una sola tecla, Activa o desactiva todas las opciones de navegación rápida y No hacer nada.

Eligiendo esta última opción de No hacer nada evitaremos que el modo de navegación rápida se active de forma accidental.

Cómo activar la navegación rápida sin el atajo de teclado

Puede que en algún momento necesitemos activar la navegación rápida de VoiceOver y encontremos que necesitamos poder acceder a ese modo de navegación. Para evitar tener que crear un nuevo comando personalizado, Apple ha extendido una combinación de teclas que ya existía en VoiceOver. Junto a la combinación Control+Opción+Q, que activa la navegación rápida con una sola tecla, han incluido la combinación Control+Opcion+Mayúscula+Q que activa la navegación rápida con las flechas. Es esta última combinación la que debemos utilizar para obtener el mismo resultado que antes se conseguía pulsando flecha izquierda+flecha derecha.

Cómo reinstalar macOS en un MacBook con procesador M

Si el MacBook con chip Apple M no funciona como debería, o simplemente se quiere empezar desde cero, reinstalar macOS puede ser la mejor opción.
Es importante saber en qué casos puede ser útil reinstalar macOS:

  • • Cuando el sistema operativo se vuelve inestable o muy lento.
  • • Hay errores persistentes que no se solucionan con actualizaciones.
  • • Para limpiar completamente el Mac antes de venderlo o regalarlo.
  • • Se experimentan problemas graves con VoiceOver y otras opciones de accesibilidad.

Si solo hay problemas menores, tal vez no sea necesario reinstalar. En su lugar, se puede probar con una reinstalación sin borrar los datos o con una simple restauración de configuraciones.

Copia de seguridad

Antes de realizar cualquier operación en la que puedan peligrar los datos y la información del usuario es necesario hacer una copia de seguridad o backUp.

Para hacer esta copia de seguridad se puede usar Time Machine con un disco externo o copiar manualmente los archivos más importantes a iCloud, Dropbox o un USB.

 Aviso

Aunque en este artículo se listan pasos y opciones concretas este proceso no es del todo semejante en todas las versiones de MacOS. Dependiendo de la versión de MacOS que esté utilizando el modo de recuperación.

Acceder al modo de recuperación

En los Mac con procesador Apple Silicon, acceder al modo de recuperación es sencillo:

  • 1. Debemos asegurarnos de que el Mac esté apagado.
  • 2. Se debe mantener presionado el botón de encendido hasta que se escuche “Opciones de arranque cargadas” o hasta que se vea el logotipo de Apple y luego aparezca “Opciones”.
  • 3. Cuando aparezcan las opciones de recuperación, se debe seleccionar Opciones y hacer clic en Continuar. Si se usa VoiceOver, se puede activar con Comando+F5.

Si el sistema de recuperación no carga, Se podría necesitar Restaurar macOS con otro Mac mediante Apple Configurator, pero este error es poco común.

Usar VoiceOver en el modo de recuperación

En el modo de recuperación la versión de VoiceOver que utilizamos está limitada ya que no se tiene acceso real al disco ni a nuestras personalizaciones.

Para empezar es posible que al arrancar el modo de recuperación todo el sistema y VoiceOver hablen en inglés. Podemos cambiar el idioma accediendo a la barra de menú pulsando Control+Opción+M y en el menú File buscar la opción Choose language.

A veces VoiceOver no puede hacer click en los botones. Para solucionar este problemas deberemos hacer uso del menú de acciones de VoiceOver. Nos colocamos sobre el botón que queremos activar, pulsamos Control+Opción+Comando+barra espaciadora y en el menú que aparece buscamos la opción Press o Pulsar.  

Por último recordar que el salto mediante la tecla de tabulación es compatible con VoiceOver. Por ejemplo en la pantalla inicial del modo recuperación podemos hacer click en el elemento Opciones pero si no profundizamos no encontraremos que dentro hay un botón de continuar. Para llegar a ese botón en muchas configuraciones se hace de forma más sencilla pulsando la tecla tabulador después de hacer click sobre Opciones.

Borrar el disco

Una vez en el modo de recuperación, debemos buscar la utilidad de discos y realizar las siguientes operaciones:

  • 1. Abrir Utilidad de Discos.
  • 2. Seleccionar el disco principal (normalmente llamado Macintosh HD).
  • 3. Pulsar en Borrar y usar APFS como formato.
  • 4. Confirmar la operación y cerrar Utilidad de Discos.

Reinstalar macOS

Tras salir de la utilidad de discos se debe elegir la opción de Reinstalar macOS y pulsar el botón continuar.

A continuación aparecerá un asistente para configurar la conexión Wifi. Tras tener conexión a Internet se procederá a la descarga de los datos de instalación. Este proceso puede tardar entre 30 minutos y 1 hora, dependiendo de la velocidad de la conexión a Internet.

Tras la instalación el equipo se reiniciará y comenzará el asistente de configuración con la selección de idioma del proceso y la conexión con la cuenta de iCloud y nuestro AppleID. El proceso es totalmente accesible con VoiceOver y el resto de opciones de accesibilidad.

Desde este asistente también se pueden recuperar los datos desde una copia de seguridad de Time machine.

Macdown, un editor de textos sencillos en Markdown para MacOS

A la hora de escribir textos en formato Markdown, aunque podemos utilizar cualquier editor en texto plano, a veces nos resulta muy útil poder ver el resultado de la maquetación de nuestro documento para detectar posibles errores en el marcado de nuestro documento.

Un editor básico de Markdown nos debe permitir poder visualizar el resultado de nuestro documento en una vista web. Esto es lo que nos permite Macdown. Este editor de código abierto y de distribución gratuita nos permite editar documentos en formato Markdown, visualizar su contenido en la vista web y exportar nuestros documentos a formato PDF y HTML.

Este editor resulta muy accesible con los diversos productos de apoyo para MacOS y su uso es bastante sencillo.

Cómo mostrar la pantalla de tu teléfono Android en tu Mac

En un artículo anterior aprendimos a mostrar la pantalla de nuestro iPhone en el mac.

Esta misma necesidad nos puede surgir pero con un teléfono Android. El programa Quicktime no detecta a los teléfonos y dispositivos Android como fuentes de video por lo que necesitaremos otra aplicación como puede ser scrcpy.

¿Qué es scrcpy?

El paquete scrcpy es una herramienta que permite reflejar y controlar dispositivos Android desde un ordenador. Es ideal para realizar demostraciones en tiempo real, capturar la pantalla para tutoriales o pruebas, y mejorar la productividad cuando necesitas interactuar con tu dispositivo móvil sin tener que tocarlo. Además, es una solución ligera, sin necesidad de instalar aplicaciones en el teléfono, ya que utiliza ADB (Android Debug Bridge) para conectarse a tu dispositivo.

Su instalación es sencilla ya que se distribuye como un paquete de Homebrew.

Para instalar scrcpy simplemente deberemos ejecutar este comando de brew en la Terminal de MacOS:

brew install scrcpy

Una vez instalado para poder utilizarlo deberemos activar el modo de depuración por USB en nuestro teléfono Android. Esta opción está disponible dentro del menú de opciones para desarrolladores del teléfono.

Una vez activado este modo de depuración es necesario conectar el teléfono Android al Mac utilizando un cable USB. El teléfono preguntará si confías en el ordenador al que se ha conectado. Debemos responder que sí.

En la Terminal de Mac ejecutaremos el comando:

scrcpy

Aparecerá una nueva ventana con el contenido de nuestro teléfono y, además, si el teléfono está ejecutando una versión de Android moderna, también podremos escuchar el sonido del teléfono en nuestro Mac. De esta forma podremos compartir el contenido visual y auditivo de nuestro teléfono Android en videoconferencias y reuniones compartiendo la pantalla de nuestro Mac.

Puedes consultar más opciones y comandos de scrcpy en la página oficial del proyecto scrcpy.