Documentación / Solución de problemas

Solución de problemas

¿Tienes algún problema? Aquí abajo encontrarás soluciones a los más habituales. Cada tarjeta trata un síntoma concreto y cómo resolverlo.

Permisos

“BetterStage no puede controlar mis ventanas”

BetterStage necesita el permiso de Accesibilidad para leer y mover ventanas. Abre Ajustes del Sistema > Privacidad y seguridad > Accesibilidad y asegúrate de que BetterStage aparece en la lista y está activado. Si ya estaba activado, prueba a desactivarlo y volver a activarlo. Reinicia BetterStage después de cambiar el permiso. Si se revoca el permiso mientras BetterStage está en ejecución, la app te avisa y restaura las ventanas ocultas en lugar de dejarlas fuera de la pantalla. Revocar Accesibilidad ya no permite que BetterStage retenga la entrada del teclado o del ratón. Volver a concederlo no interrumpe una restauración en curso de un espacio de trabajo guardado, de la continuidad o al salir del reposo.

“Los atajos no funcionan”

BetterStage usa la API nativa de teclas rápidas de Carbon para los atajos de teclado, así que no hace falta el permiso de Monitorización de entrada. Si los atajos no funcionan, comprueba primero que el permiso de Accesibilidad está activado. Comprueba también que ninguna otra aplicación usa las mismas combinaciones de teclas, botones del ratón o gestos del trackpad: los atajos en conflicto impiden que BetterStage reciba los eventos. Vuelve a asignar los controles de teclado, ratón y trackpad en Ajustes > Atajos.

“No se detectan las ventanas”

La detección de ventanas usa la API de Accesibilidad de macOS, que depende del permiso de Accesibilidad. Asegúrate de que está activado en Ajustes del Sistema > Privacidad y seguridad > Accesibilidad. Ten en cuenta que algunas aplicaciones usan tipos de ventana no estándar (como paneles flotantes o ventanas de Chrome personalizadas) que la API de accesibilidad puede no detectar.

Comportamiento de las ventanas

“¿Debo usar BetterStage junto con el Organizador visual de macOS?”

No. Desactiva el Organizador visual integrado de Apple antes de usar BetterStage. Ambas herramientas gestionan la visibilidad de las ventanas, por lo que usarlas juntas puede provocar cambios confusos, ventanas ocultas o ventanas que aparecen en el lugar equivocado. Abre Ajustes del Sistema > Escritorio y Dock > Organizador visual, desactiva el Organizador visual y, si el espacio de trabajo sigue sin verse bien, reinicia BetterStage.

“Las ventanas de Firefox o Chrome se animan en lugar de ajustarse al instante”

Algunos navegadores (Firefox, Chrome y las apps basadas en Electron) activan un indicador de accesibilidad llamado AXEnhancedUserInterface que hace que los movimientos de ventana se animen en lugar de ajustarse directamente. BetterStage detecta y desactiva automáticamente este indicador en las apps afectadas. Si sigues viendo movimientos animados, prueba a salir del navegador y volver a abrirlo para que BetterStage pueda aplicar de nuevo la corrección.

“Las ventanas de Firefox parpadean, no se colocan bien o se retrasan al cambiar de Stage”

Firefox gestiona sus ventanas de forma no estándar, por lo que no siempre colabora con la gestión de ventanas: puede que veas ventanas que parpadean brevemente, que no se colocan con precisión o que se retrasan al cambiar de Stage. Es un problema conocido y seguimos mejorando la compatibilidad con Firefox.

“Aparece el Finder al cambiar a un Stage vacío”

macOS puede activar el Finder cuando la aplicación en primer plano no tiene ventanas visibles. BetterStage 2.2.0 oculta ventanas individuales en un Space privado en lugar de ocultar toda la aplicación. Si aparece una ventana inesperada en un Stage vacío, comunícanos el nombre de la app y la secuencia de cambios de Stage o de escritorio que lo provocó.

“Las ventanas pasaron al Stage equivocado tras el reposo o el salvapantallas”

Deja que la configuración de pantallas se estabilice. La disposición de una pantalla recordada vuelve por sí sola; si aparece un aviso de recuperación, elige Restaurar espacio de trabajo o Mantener la disposición actual. Para las ventanas que siguen ocultas tras eliminar un escritorio, o que han quedado fuera de la pantalla tras un cambio de pantallas, usa Rescatar ventanas en la barra de menús. Si BetterStage indica que los Spaces de macOS no están disponibles, termina la transición de escritorio y elige Reintentar. Si el problema continúa, reinicia BetterStage.

“Un cuadro de diálogo o una ventana flotante se ha quedado detrás de TabStack”

Abre la Rueda Snap y elige Traer al frente en Más acciones. Así se traen al frente las ventanas flotantes y no gestionadas de este monitor sin cambiar la disposición ni mostrar las pestañas ocultas. Rescatar ventanas también recupera las ventanas que BetterStage ocultó en Spaces privados, incluidas aquellas cuyo escritorio original se eliminó.

“Faltan ventanas después de un fallo”

BetterStage registra las ventanas que mueve a Spaces privados y ejecuta un asistente de recuperación independiente. Si BetterStage se cierra de forma inesperada, el asistente usa esos registros para devolver las ventanas ocultas a sus escritorios guardados. Si siguen faltando ventanas, vuelve a abrir BetterStage y usa Rescatar ventanas. Si se eliminó un escritorio o se desconectó una pantalla, puede hacer falta un destino de sustitución disponible.

Configuración de la app

“Ejecutar desde el terminal o como paquete .app”

Cuando ejecutas BetterStage con swift run en un terminal, macOS asocia el permiso de Accesibilidad a tu app de terminal en lugar de a BetterStage. Para que los permisos funcionen correctamente y BetterStage aparezca con su nombre en Ajustes del Sistema, compila y ejecuta el paquete .app.

“La barra de Stages no aparece”

La barra de Stages se puede abrir con el borde activo (llevando el cursor a la parte superior de la pantalla) o con el atajo de teclado Opt+Up Arrow. Asegúrate de que el borde activo está activado en Ajustes. Si la barra de Stages sigue sin aparecer, comprueba que BetterStage tiene el permiso de Accesibilidad necesario.

En las pantallas integradas de Mac con muesca, Ajustes > Stages > Barra de Stages > Evitar la muesca de la pantalla puede excluir la propia muesca y mantener activo el resto del borde superior.

“El monitor no se reconoce al volver a conectarlo”

BetterStage reconoce los monitores por datos del hardware como el modelo y el número de serie, no solo por el ID de pantalla que asigna macOS. En casos poco frecuentes, por ejemplo tras actualizar un controlador o al usar otro puerto o adaptador, esos datos cambian. Prueba a desconectar y volver a conectar el monitor y reinicia BetterStage. Si el monitor sigue sin reconocerse, vuelve a configurarlo en Ajustes > Pantallas.

“⌘Tab sigue mostrando el selector de apps de macOS”

El Selector ⌘Tab de BetterStage es opcional y está desactivado de forma predeterminada. Activa Usar el ⌘Tab de BetterStage en Ajustes > Selector ⌘Tab y asegúrate de que tienes activo Pro, la prueba o una prueba diaria de Pro. Sin previsualizaciones, muestra los iconos de las apps; permite la Grabación de pantalla para ver miniaturas en vivo. Consulta la guía del Selector ⌘Tab.

“Mis Stages no se cargan tras volver a la 2.0.x”

Las versiones anteriores no pueden abrir los Stages guardados por BetterStage 2.2. Si has reinstalado la 2.0.x, tus Stages no se cargarán; en su lugar, actualiza a la última versión desde la página de descarga.

Informar de un error

BetterStage mantiene un registro de diagnóstico rotativo limitado a 10 MB para que nunca llene tu disco. Para adjuntarlo a un informe de error, abre el icono de BetterStage en la barra de menús y elige Mostrar el registro de diagnóstico…: el Finder se abre en el archivo de registro para que puedas arrastrarlo a un mensaje de Discord, un issue de GitHub o un correo.

Las compilaciones de lanzamiento evitan el registro detallado, que capturaría los títulos de las ventanas. Si estás reproduciendo un problema y quieres un rastro más completo, usa una compilación beta o candidata a lanzamiento, captura el registro y después vuelve al canal de lanzamiento.

¿Sigues necesitando ayuda?

Si tu problema no aparece arriba, escríbenos y te ayudaremos a que todo funcione.