Belangrijkste feiten
- PaperWM.spoon is een Hammerspoon Spoon en geen losstaande Mac-app.
- De README bevat een kloonopdracht en voorbeelden van Lua-configuratie.
- De README vraagt je twee instellingen van Mission Control te wijzigen: het automatisch herschikken van spaces uitschakelen en afzonderlijke spaces voor schermen inschakelen.
- Het past goed als je een instelbare, op Lua gebaseerde opzet wilt; wie liever geen Hammerspoon-configuratie onderhoudt, kiest misschien een andere tool.
Installeer eerst Hammerspoon
De officiële README van PaperWM.spoon, gecontroleerd op 12 november 2026, geeft deze installatieopdracht:
``bash git clone https://github.com/mogenson/PaperWM.spoon ~/.hammerspoon/Spoons/PaperWM.spoon ``
Voer die uit in Terminal. Hij kloont de repository in de map Spoons die Hammerspoon gebruikt. Als je een eigen configuratiemap voor Hammerspoon gebruikt, pas dan het doel aan zodat het daarbij past.
Stel de opties van Mission Control in
De README verwijst naar Systeemvoorkeuren → Bureaublad en Dock en het gedeelte Mission Control. Op de huidige macOS open je Systeeminstellingen → Bureaublad en Dock en scroll naar het gedeelte Mission Control. Zet Spaces automatisch herschikken op basis van recent gebruik uit en zet Beeldschermen hebben afzonderlijke spaces aan. De exacte tekst en plek kunnen per macOS-versie verschillen. De README noemt deze opties als onderdeel van de installatie.
Dit zijn instellingen voor het hele systeem die bepalen hoe macOS met spaces omgaat. Beslis of ze bij je opzet passen voordat je ze wijzigt. Als je meerdere schermen gebruikt, controleer dan of het gedrag van de spaces overeenkomt met wat je wilt.
Laad en start de Spoon
Open het configuratiebestand van Hammerspoon op ~/.hammerspoon/init.lua. Voeg de volgende Lua-regels toe:
``lua PaperWM = hs.loadSpoon("PaperWM") PaperWM:bindHotkeys(PaperWM.default_hotkeys) PaperWM:start() ``
Sla het bestand op. Kies in het Hammerspoon-pictogram in de menubalk Reload Config. De eerste regel laadt de Spoon, de tweede koppelt de gedocumenteerde standaardsneltoetsen, en de derde start het beheer van vensters. De README van het project toont ook een route via SpoonInstall en voorbeelden van eigen sneltoetsen. Begin met de standaardinstellingen voordat je toetsen aanpast, zodat je kunt zien of de opzet is geladen.
Om PaperWM.spoon te stoppen, roep je PaperWM:stop() aan via de console of configuratie van Hammerspoon. Als het opstarten meldt dat een Spoon ontbreekt, controleer dan of de kloonmap PaperWM.spoon heet en in de map Spoons staat die Hammerspoon gebruikt. Controleer de console van Hammerspoon op Lua-fouten voordat je meerdere instellingen tegelijk wijzigt.
Controleer de sneltoetsen en maak één wijziging
De README van PaperWM.spoon, gecontroleerd op 12 november 2026, beschrijft de standaardinstellingen: focus met Option-Command-pijltjestoetsen, wisselen met Option-Command-Shift-pijltjestoetsen en het doorlopen van breedtes met Option-Command-R. Er staan ook sneltoetsen in voor zwevend, spaces en het formaat van vensters. Als een sneltoets botst met een andere app, pas dan de Lua-tabel aan, laad de configuratie opnieuw en controleer de console van Hammerspoon als de plug-in niet meer reageert.
De eigen configuratie van de Spoon kan apps filteren en de vensterverhoudingen aanpassen. De README laat window_filter en window_ratios zien als instelpunten. Wijzig alleen een instelling die je in de documentatie kunt terugvinden en test daarna een gewoon app-venster en één app die je wilt uitsluiten. De beheerders wijzen er ook op dat macOS het verplaatsen van vensters volledig buiten het scherm beperkt, dus getegelde vensters aan de randen kunnen gedeeltelijk zichtbaar blijven.
Dit is een op Lua gebaseerde toolchain. Ze past bij mensen die een configuratiebestand prettig vinden lezen en de flexibiliteit van Hammerspoon willen. Wie een losstaande app met een instellingenvenster prefereert, vindt deze opzet misschien veeleisend om te onderhouden. Voor PaperWM.spoon is de README van de installatie de maatgevende bron; controleer de repository voordat je de stappen volgt, want open-sourceprojecten kunnen veranderen.
De README van PaperWM.spoon zegt dat het “geïnspireerd is op PaperWM” en verwijst naar het PaperWM-project, gecontroleerd op 12 november 2026. De projecten hebben aparte implementaties en installatie-instructies.
Wij maken SlidePane, een Mac-app voor mensen die vensterindelingen willen instellen zonder Lua-scripts te onderhouden. Die past bij je als je liever app-instellingen en ingebouwde sneltoetsen gebruikt; PaperWM.spoon past beter als je het scriptmodel van Hammerspoon wilt. Zie de Installeer SlidePane en start de gratis proefperiode voor de installatie van de app.
Gerelateerde pagina's
Het artikel over Niri op de Mac vergelijkt een andere scrollende werkwijze. De Sneltoetsen en toetsenbordindelingen legt uit hoe je de sneltoetsen van de app nakijkt.