Por qué algunas aplicaciones no funcionan bien con StackWM (y cómo solucionarlo)
Comprensión de las limitaciones de la API de Accesibilidad de macOS y cómo restaurar el control total sobre aplicaciones incompatibles.
Configuraste la escena perfecta. Tienes Telegram a la izquierda, tu editor de código a la derecha, y todo perfectamente alineado. Luego cambias a una escena diferente y vuelves — y Telegram no regresa a su zona. ¿Qué pasó?
Bienvenido al mundo de las limitaciones de la API de Accesibilidad de macOS. No es un error en StackWM. Es una limitación en cómo estas aplicaciones se comunican con macOS.
La causa raíz: APIs de Accesibilidad
StackWM se basa en el marco de Accesibilidad de macOS para gestionar ventanas. Cuando creas una zona, StackWM le pregunta a macOS: "¿Qué ventanas pertenecen a qué aplicación?" y macOS le dice qué está abierto.
¿El problema? No todas las aplicaciones cooperan.
Algunas aplicaciones — particularmente Telegram, Brave, Obsidian, Arc y algunas otras — no exponen adecuadamente sus ventanas a través de las API de Accesibilidad estándar. Desde la perspectiva de StackWM, estas aplicaciones:
- No reportan ventanas en absoluto
- Reportan ventanas con información incompleta o genérica
- Ocultan su ventana de aplicación real detrás de procesos auxiliares
Esto significa que cuando cambias de escenas, StackWM no puede encontrar esas ventanas para devolverlas a sus zonas asignadas.
¿Por qué algunas aplicaciones hacen esto?
Generalmente hay tres razones:
1. Arquitectura de ventana no estándar
Las aplicaciones como Telegram utilizan marcos de renderizado personalizados (a menudo basados en Electron o Qt) en lugar de ventanas AppKit nativas de macOS. Esto les da flexibilidad multiplataforma pero rompe la compatibilidad con las API de gestión de ventanas de macOS.
2. Decisiones de seguridad y sandbox
Algunos desarrolladores limitan deliberadamente lo que su aplicación expone a través de las API de Accesibilidad como medida de seguridad. Es una compensación: mejor aislamiento vs. peor integración con las herramientas del sistema.
3. Código heredado o deuda arquitectónica
Algunas aplicaciones no han actualizado su código de manejo de ventanas para cumplir con los estándares modernos de macOS. Funcionan bien en el día a día, pero no juegan bien con los gestores de ventanas externos.
Los sospechosos comunes
Aquí hay aplicaciones conocidas por tener problemas con las API de Accesibilidad con StackWM:
| Aplicación | Problema | Gravedad |
|---|---|---|
| Telegram | Ventanas no expuestas adecuadamente a las API de Accesibilidad | Alta |
| Brave Browser | Ventanas auxiliares reportadas incorrectamente | Media |
| Obsidian | Problemas de detección de ventanas en espacios de trabajo específicos | Media |
| Arc | Los elementos de la interfaz específicos de Arc no son accesibles | Alta |
| cmux | Multiplexor de terminal con reportes de ventana limitados | Alta |
| Google Antigravity | Manejo de ventana propietario | Alta |
(Esta lista crece o se reduce a medida que los desarrolladores de aplicaciones actualizan su código. Verifique el blog de StackWM regularmente para actualizaciones.)
La solución: la Lista de compatibilidad
Aquí hay una buena noticia: StackWM tiene un workaround incorporado llamado Lista de compatibilidad.
Cuando añades una aplicación incompatible a esta lista, StackWM cambia a una estrategia alternativa:
- En lugar de depender de las API de Accesibilidad, utiliza seguimiento de posición visual y coincidencia de procesos
- Cuando cambias de escenas, StackWM recuerda dónde estaban posicionadas estas ventanas e intenta restaurarlas
- No es perfecto (la aplicación tiene que cooperar hasta cierto punto), pero restaura el 90% de la funcionalidad
Cómo añadir aplicaciones a la Lista de compatibilidad
- Abre StackWM Preferences → ve a la pestaña Settings
- Encuentra la sección "App Compatibility"
- Haz clic en el botón más para añadir una aplicación
- Selecciona la aplicación de la lista de aplicaciones instaladas
- Eso es. La aplicación ahora obtiene una marca roja ✓ y StackWM la manejará especialmente
Sabrás que la aplicación se ha añadido cuando veas aparecer el icono de compatibilidad junto a ella en la lista.
Qué significa la marca de verificación roja
Una vez que una aplicación está en la Lista de compatibilidad:
- StackWM deja de intentar usar las API de Accesibilidad estándar para esa aplicación
- En cambio, realiza un seguimiento de las posiciones de las ventanas y recuerda las zonas
- Cuando cambias de escenas, restaura la ventana de la aplicación a su zona anterior si es posible
- Podrías ver ligeros retrasos (unos pocos cientos de milisegundos) mientras StackWM ubica y mueve la ventana
Salvedad importante: Algunas aplicaciones (particularmente las que se ejecutan en un entorno aislado o utilizan ventanería no estándar) aún podrían no moverse correctamente incluso con este workaround. Si ese es el caso, generalmente no hay nada que podamos hacer — es una limitación de la aplicación misma.
Workarounds si la Lista de compatibilidad no ayuda
Si añadir la aplicación a la Lista de compatibilidad aún no resuelve el problema:
1. Usa la aplicación en una zona única persistente
En lugar de intentar moverla entre zonas, mantén la aplicación en una zona fija y enfoca tus flujos de trabajo en otro lugar.
2. Contrólala por separado con Cmd+Tab
Para cambiar a nivel de aplicación, utiliza el Cmd+Tab nativo de macOS en lugar de depender de la restauración de zonas de StackWM. Esto funciona para cualquier aplicación, compatible o no.
3. Mantén anulaciones manuales listas
Si la aplicación no regresa al lugar correcto automáticamente, simplemente arrástrala de vuelta. Es un workaround, pero al menos obtienes gestión de zonas para tus aplicaciones bien comportadas.
4. Ponte en contacto con los desarrolladores de la aplicación
Si una aplicación es crítica para tu flujo de trabajo, considera enviar un issue de GitHub o contactar al desarrollador pidiendo que mejoren su soporte de la API de Accesibilidad. Cuanta más presión reciban los desarrolladores, más solucionarán estos problemas.
Lo que estamos haciendo al respecto
El equipo de StackWM monitorea activamente:
- Qué aplicaciones tienen los problemas de compatibilidad más frecuentes
- Si las actualizaciones de aplicaciones mejoran o rompen la compatibilidad
- Workarounds que podrían ayudar en casos extremos
También mantenemos una matriz de compatibilidad actualizada que muestra el estado conocido de aplicaciones populares, actualizada con cada lanzamiento de StackWM.
La imagen más grande
Este problema no es único de StackWM. Cada gestor de ventanas en macOS — incluyendo yabai, Magnet e incluso Raycast — lucha contra las mismas aplicaciones por las mismas razones.
Es una limitación fundamental de cómo macOS expone la información de ventanas. Hasta que Apple proporcione una API más robusta (o los desarrolladores de aplicaciones mejoren voluntariamente su soporte de la API de Accesibilidad), esto seguirá siendo un desafío.
Lista de verificación rápida
- ✅ Intenta añadir la aplicación a la Lista de compatibilidad primero
- ✅ Si aún no funciona, verifica si una versión más nueva de la aplicación tiene mejor soporte de API
- ✅ Como alternativa, mantén la aplicación en una zona única y continúa
- ✅ Si es crítico, presenta un issue con el desarrollador de la aplicación pidiendo mejor soporte de API de macOS
Última actualización: 3 de marzo de 2026
¿Preguntas? Contáctanos o consulta nuestra documentación completa.