Perché alcune app non funzionano bene con StackWM (e come risolverlo)

Hai configurato la scena perfetta. Hai Telegram a sinistra, il tuo editor di codice a destra, e tutto perfettamente allineato. Poi cambi scena e torni indietro — e Telegram non torna alla sua zona. Cosa è successo?

Benvenuto nel mondo delle limitazioni dell'API di Accessibilità di macOS. Non è un bug in StackWM. È una limitazione di come queste app comunicano con macOS.

La causa principale: le API di Accessibilità

StackWM si basa sul framework di Accessibilità di macOS per gestire le finestre. Quando crei una zona, StackWM chiede a macOS: "Quali finestre appartengono a quale app?" e macOS gli dice cosa è aperto.

Il problema? Non tutte le app cooperano.

Alcune applicazioni — in particolare Telegram, Brave, Obsidian, Arc e altre — non espongono correttamente le loro finestre tramite le API di Accessibilità standard. Dal punto di vista di StackWM, queste app:

Non segnalano affatto finestre
Segnalano finestre con informazioni incomplete o generiche
Nascondono la loro vera finestra di app dietro processi di supporto

Questo significa che quando cambi scene, StackWM non può trovare quelle finestre per riportarle alle loro zone assegnate.

Perché alcune app lo fanno?

Ci sono generalmente tre ragioni:

1. Architettura di finestra non standard

Le app come Telegram utilizzano framework di rendering personalizzati (spesso basati su Electron o Qt) invece di finestre AppKit native di macOS. Questo dà loro flessibilità multipiattaforma ma rompe la compatibilità con le API di gestione delle finestre di macOS.

2. Decisioni di sicurezza e sandboxing

Alcuni sviluppatori limitano deliberatamente ciò che la loro app espone tramite le API di Accessibilità come misura di sicurezza. È un compromesso: un migliore isolamento vs. una peggiore integrazione con gli strumenti di sistema.

3. Codice legacy o debito architetturale

Alcune app non hanno aggiornato il loro codice di gestione delle finestre per soddisfare gli standard macOS moderni. Funzionano bene nel quotidiano, ma non giocano bene con i gestori di finestre esterni.

I sospetti comuni

Ecco le app note per avere problemi con le API di Accessibilità con StackWM:

App	Problema	Gravità
Telegram	Finestre non correttamente esposte alle API di Accessibilità	Alta
Brave Browser	Finestre ausiliarie segnalate in modo errato	Media
Obsidian	Problemi di rilevamento finestre in determinati workspace	Media
Arc	Elementi dell'interfaccia specifici di Arc non accessibili	Alta
cmux	Multiplexer terminale con segnalazione limitata delle finestre	Alta
Google Antigravity	Gestione proprietaria delle finestre	Alta

(Questo elenco cresce o si riduce man mano che gli sviluppatori di app aggiornano il loro codice. Controlla regolarmente il blog di StackWM per gli aggiornamenti.)

La soluzione: l'Elenco di compatibilità

Ecco la buona notizia: StackWM ha una soluzione incorporata chiamata Elenco di compatibilità.

Quando aggiungi un'app incompatibile a questo elenco, StackWM passa a una strategia alternativa:

Invece di affidarsi alle API di Accessibilità, utilizza tracciamento della posizione visiva e abbinamento dei processi
Quando cambi scene, StackWM ricorda dove erano posizionate queste finestre e tenta di ripristinarle
Non è perfetto (l'app deve cooperare fino a un certo punto), ma ripristina il 90% della funzionalità

Come aggiungere app all'Elenco di compatibilità

Apri Preferenze di StackWM → vai alla scheda Settings
Trova la sezione "App Compatibility"
Clicca il pulsante più per aggiungere un'app
Seleziona l'app dall'elenco delle applicazioni installate
Fatto. L'app riceve ora una spunta rossa ✓ e StackWM la gestirà in modo speciale

Saprai che l'app è stata aggiunta quando vedi l'icona di compatibilità comparire accanto ad essa nell'elenco.

Cosa significa la spunta rossa

Una volta che un'app è nell'Elenco di compatibilità:

StackWM smette di provare a utilizzare le API di Accessibilità standard per quell'app
Invece, traccia le posizioni delle finestre e ricorda le zone
Quando cambi scene, ripristina la finestra dell'app alla sua zona precedente se possibile
Potresti vedere lievi ritardi (poche centinaia di millisecondi) mentre StackWM individua e sposta la finestra

Avvertenza importante: Alcune app (in particolare quelle che funzionano in un ambiente sandbox o utilizzano finestre non standard) potrebbero comunque non funzionare correttamente nemmeno con questa soluzione alternativa. Se è il caso, di solito non c'è nulla che possiamo fare — è una limitazione dell'app stessa.

Soluzioni alternative se l'Elenco di compatibilità non aiuta

Se l'aggiunta dell'app all'Elenco di compatibilità non risolve ancora il problema:

1. Usa l'app in una singola zona persistente

Invece di provare a spostarla tra zone, mantieni l'app in una zona fissa e concentra i tuoi flussi di lavoro altrove.

2. Controllala separatamente con Cmd+Tab

Per il cambio a livello di app, usa il Cmd+Tab nativo di macOS invece di affidarti al ripristino delle zone di StackWM. Questo funziona per qualsiasi app, compatibile o no.

3. Tieni pronti gli override manuali

Se l'app non torna al posto giusto automaticamente, trascinala semplicemente di nuovo. È una soluzione alternativa, ma almeno ottieni la gestione delle zone per le tue app ben comportate.

4. Contatta gli sviluppatori dell'app

Se un'app è critica per il tuo flusso di lavoro, considera di segnalare un problema su GitHub o contatta lo sviluppatore chiedendogli di migliorare il supporto dell'API di Accessibilità. Più pressione ricevono gli sviluppatori, più risolvono questi problemi.

Cosa stiamo facendo al riguardo

Il team di StackWM monitora attivamente:

Quali app hanno i problemi di compatibilità più comuni
Se gli aggiornamenti delle app migliorano o rompono la compatibilità
Soluzioni alternative che potrebbero aiutare nei casi estremi

Manteniamo anche una matrice di compatibilità aggiornata che mostra lo stato noto delle app popolari, aggiornata con ogni versione di StackWM.

La visione generale

Questo problema non è unico di StackWM. Ogni gestore di finestre su macOS — inclusi yabai, Magnet e persino Raycast — lotta con le stesse app per le stesse ragioni.

È una limitazione fondamentale di come macOS espone le informazioni sulle finestre. Finché Apple non fornisce un'API più robusta (o gli sviluppatori di app migliorano volontariamente il supporto dell'API di Accessibilità), questo rimarrà una sfida.

Lista di controllo rapida

✅ Prova prima ad aggiungere l'app all'Elenco di compatibilità
✅ Se ancora non funziona, controlla se una versione più recente dell'app ha un miglior supporto dell'API
✅ Come alternativa, mantieni l'app in una singola zona e procedi
✅ Se è critico, segnala un problema allo sviluppatore dell'app chiedendo un miglior supporto dell'API di macOS

Ultimo aggiornamento: 3 marzo 2026

Domande? Contattaci o consulta la nostra documentazione completa.