Tradotto dall’inglese; l’inglese fa fede per prezzi e condizioni.

Getting started

PaperWM.spoon su macOS: installazione e configurazione di base

PaperWM.spoon è un plugin gratuito per Hammerspoon su macOS: un gestore di finestre tiling a scorrimento. Per configurarlo, installa Hammerspoon, clona il repository di PaperWM.spoon nella cartella Spoons di Hammerspoon, carica e avvia lo Spoon da init.lua e concedi i permessi richiesti da macOS. I comandi seguono il README del progetto, consultato il 12 novembre 2026.

4 min di lettura ·

In breve

  • PaperWM.spoon è uno Spoon di Hammerspoon, non un'app Mac indipendente.
  • Il README include il comando per clonarlo e esempi di configurazione Lua.
  • Il README chiede di modificare due opzioni di Mission Control: disattivare la riordinazione automatica degli Spaces e attivare Spaces separati per i monitor.
  • È adatto se vuoi una configurazione Lua flessibile; se preferisci non mantenere la configurazione di Hammerspoon, valuta un altro strumento.

Installa prima Hammerspoon

Scarica Hammerspoon dal sito ufficiale, consultato il 12 novembre 2026. Aprilo una volta e segui le richieste di autorizzazione di macOS. Hammerspoon esegue script di automazione: controlla cosa installi e quale codice carichi. Il README di PaperWM.spoon descrive plugin e configurazione; non abbiamo verificato questi passaggi su ogni versione di macOS.

Il README ufficiale di PaperWM.spoon, consultato il 12 novembre 2026, fornisce questo comando:

``bash git clone https://github.com/mogenson/PaperWM.spoon ~/.hammerspoon/Spoons/PaperWM.spoon ``

Eseguilo in Terminale. Il repository verrà clonato nella cartella Spoons usata da Hammerspoon. Se usi una cartella di configurazione Hammerspoon personalizzata, modifica la destinazione.

Imposta le opzioni di Mission Control

Il README rimanda a Preferenze di Sistema → Scrivania e Dock, nella sezione Mission Control. Nelle versioni attuali di macOS, apri Impostazioni di Sistema → Scrivania e Dock e scorri fino a Mission Control. Disattiva Riordina automaticamente gli Spaces in base all'utilizzo più recente e attiva Gli schermi hanno Spaces separati. Dicitura e posizione possono variare secondo la versione di macOS. Il README include queste opzioni nella configurazione.

Sono scelte di sistema che modificano il comportamento degli Spaces. Prima di cambiarle, verifica che si adattino alla tua configurazione, soprattutto se usi più monitor.

Carica e avvia lo Spoon

Apri il file di configurazione di Hammerspoon ~/.hammerspoon/init.lua e aggiungi queste righe Lua:

``lua PaperWM = hs.loadSpoon("PaperWM") PaperWM:bindHotkeys(PaperWM.default_hotkeys) PaperWM:start() ``

Salva il file. Dall'icona di Hammerspoon nella barra dei menu scegli Reload Config. La prima riga carica lo Spoon, la seconda registra le scorciatoie predefinite documentate e la terza avvia la gestione delle finestre. Il README mostra anche SpoonInstall e scorciatoie personalizzate. Comincia dai valori predefiniti per verificare che il caricamento sia riuscito.

Per fermare PaperWM.spoon, richiama PaperWM:stop() dalla console o dalla configurazione di Hammerspoon. Se all'avvio manca lo Spoon, controlla che la cartella clonata si chiami PaperWM.spoon e si trovi nella cartella Spoons usata da Hammerspoon. Prima di cambiare più opzioni, verifica gli errori Lua nella console.

Controlla le scorciatoie e modifica una cosa alla volta

Il README di PaperWM.spoon, consultato il 12 novembre 2026, documenta le scorciatoie predefinite: Option–Command–frecce per la messa a fuoco, Option–Command–Shift–frecce per scambiare finestre e Option–Command–R per cambiare larghezza. Mostra anche comandi per finestre fluttuanti, Spaces e dimensioni. Se una scorciatoia è in conflitto, modifica la tabella Lua, ricarica la configurazione e controlla la console se il plugin smette di rispondere.

La configurazione dello Spoon può escludere app e regolare i rapporti delle finestre. Il README indica window_filter e window_ratios. Cambia solo un'opzione descritta nella documentazione, poi prova una finestra normale e un'app da escludere. I manutentori segnalano inoltre che macOS limita lo spostamento delle finestre completamente fuori schermo: quelle tiling sui bordi possono restare parzialmente visibili.

Questa catena di strumenti usa Lua. Fa al caso tuo se sai leggere file di configurazione e vuoi la flessibilità di Hammerspoon. Se preferisci un'app indipendente con una finestra delle impostazioni, potrebbe essere impegnativa da mantenere. Per PaperWM.spoon fa fede il README: controlla il repository prima di seguire istruzioni perché i progetti open source possono cambiare.

Il README di PaperWM.spoon dice che il progetto è «ispirato a PaperWM» e rimanda al progetto PaperWM, consultato il 12 novembre 2026. Sono implementazioni distinte con istruzioni separate.

Sviluppiamo SlidePane, un'app macOS per configurare le disposizioni senza mantenere script Lua. Può essere adatta se preferisci impostazioni e controlli integrati per le scorciatoie; PaperWM.spoon è più indicato se vuoi il modello basato su script Hammerspoon. Per installare l'app, consulta la Installa SlidePane e avvia la prova gratuita.

Pagine correlate

L'articolo Niri per Mac confronta un altro flusso a scorrimento. La Scorciatoie e disposizione della tastiera spiega come controllare i comandi dell'app.