# PaperWM.spoon unter macOS: installieren und grundlegend einrichten

Last updated: 2026-11-12

PaperWM.spoon ist ein kostenloses Plugin für Hammerspoon und ein scrollbarer Kachelmanager für macOS. Installiere Hammerspoon, klone das PaperWM.spoon-Repository in Hammerspoons Spoons-Ordner, lade und starte das Spoon aus init.lua und erteile die von macOS angeforderten Berechtigungen. Die folgenden Befehle folgen der Projekt-README, geprüft am 2026-11-12.

## Die wichtigsten Fakten

- PaperWM.spoon ist ein Hammerspoon Spoon und keine eigenständige Mac-App.
- Die README enthält einen Klon-Befehl und Beispiele für die Lua-Konfiguration.
- Für Mission Control sollen zwei Einstellungen geändert werden: Spaces nicht automatisch neu anordnen und die Option „Monitore verwenden verschiedene Spaces“ aktivieren.
- Das Werkzeug passt zu einer konfigurierbaren Lua-Einrichtung; wer Hammerspoon-Konfiguration nicht pflegen will, kann eine andere App wählen.

## Installiere zuerst Hammerspoon

Lade Hammerspoon von der [offiziellen Website](https://www.hammerspoon.org/), geprüft am 2026-11-12. Öffne es einmal und folge den macOS-Abfragen zu Berechtigungen. Hammerspoon führt Automatisierungsskripte aus. Prüfe daher, was du installierst und welchen Code du lädst. Die [offizielle PaperWM.spoon-README](https://github.com/mogenson/PaperWM.spoon), geprüft am 2026-11-12, enthält diesen Installationsbefehl:

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

Führe ihn im Terminal aus. Er klont das Repository in den von Hammerspoon verwendeten Spoons-Ordner. Wenn du ein eigenes Hammerspoon-Konfigurationsverzeichnis nutzt, passe das Ziel an.

## Stelle die Mission-Control-Optionen ein

Die README verweist auf Systemeinstellungen → Schreibtisch & Dock und dort auf Mission Control. Öffne unter aktuellem macOS Systemeinstellungen → Schreibtisch & Dock und scrolle zu Mission Control. Deaktiviere **Spaces automatisch anhand der letzten Verwendung neu anordnen** und aktiviere **Monitore verwenden verschiedene Spaces**. Wortlaut und Position können je nach macOS-Version abweichen. Laut README gehören diese Optionen zur Einrichtung.

Diese systemweiten Optionen beeinflussen den Umgang von macOS mit Spaces. Entscheide vor der Änderung, ob sie zu deiner Einrichtung passen. Nutzt du mehrere Bildschirme, prüfe, ob sich deren Spaces wie gewünscht verhalten.

## Lade und starte das Spoon

Öffne Hammerspoons Konfigurationsdatei unter `~/.hammerspoon/init.lua` und füge diese Lua-Zeilen ein:

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

Speichere die Datei. Wähle über das Hammerspoon-Menüleistensymbol **Reload Config**. Die erste Zeile lädt das Spoon, die zweite registriert die dokumentierten Standardkurzbefehle, die dritte startet die Fensterverwaltung. Die README beschreibt auch SpoonInstall und eigene Tastenbelegungen. Beginne mit den Standardwerten, bevor du Tasten änderst, damit du erkennst, ob die Einrichtung geladen wurde.

Zum Beenden rufst du `PaperWM:stop()` über Hammerspoons Konsole oder Konfiguration auf. Meldet der Start ein fehlendes Spoon, prüfe, ob der geklonte Ordner `PaperWM.spoon` heißt und im verwendeten Spoons-Ordner liegt. Sieh in Hammerspoons Konsole nach Lua-Fehlern, bevor du mehrere Einstellungen auf einmal änderst.

## Prüfe die Belegungen und ändere gezielt

Die [README von PaperWM.spoon](https://github.com/mogenson/PaperWM.spoon), geprüft am 2026-11-12, nennt Option–Command-Pfeile zum Fokussieren, Option–Command–Shift-Pfeile zum Tauschen und Option–Command–R zum Wechseln der Breite. Außerdem dokumentiert sie Belegungen für schwebende Fenster, Spaces und Fenstergrößen. Kollidiert ein Kurzbefehl mit einer anderen App, bearbeite die Lua-Tabelle, lade die Konfiguration neu und prüfe Hammerspoons Konsole, falls das Plugin nicht reagiert.

Die Konfiguration des Spoons kann Apps filtern und Fensterverhältnisse anpassen. Die README nennt `window_filter` und `window_ratios` als Konfigurationspunkte. Ändere nur eine Einstellung, die du in der Dokumentation nachvollziehen kannst, und teste ein normales App-Fenster sowie eine App, die ausgeschlossen werden soll. Die Maintainer weisen darauf hin, dass macOS das Verschieben von Fenstern vollständig aus dem Bildschirm begrenzt. Kacheln am Rand können daher teilweise sichtbar bleiben.

Diese Werkzeugkette basiert auf Lua. Sie eignet sich, wenn du Konfigurationsdateien lesen kannst und Hammerspoons Flexibilität möchtest. Wer eine eigenständige App mit Einstellungsfenster bevorzugt, findet die Pflege womöglich aufwendig. Maßgeblich für PaperWM.spoon ist die README. Prüfe das Repository vor der Einrichtung, da sich Open-Source-Projekte ändern können.

Die README sagt, PaperWM.spoon sei „Inspired by PaperWM“ und verweist auf das [PaperWM-Projekt](https://github.com/paperwm/PaperWM), geprüft am 2026-11-12. Es handelt sich um getrennte Implementierungen mit eigenen Einrichtungsschritten.

Wir entwickeln SlidePane, eine macOS-App für Menschen, die Fensterlayouts ohne Lua-Skripte konfigurieren möchten. Sie passt möglicherweise, wenn du App-Einstellungen und integrierte Kurzbefehle bevorzugst. PaperWM.spoon passt besser, wenn du das Hammerspoon-Skriptmodell möchtest. Die [Installiere SlidePane und starte die kostenlose Testphase](/de/guides/installation) beschreibt die App-Einrichtung.

## Verwandte Seiten

Der Artikel [Niri auf dem Mac](/de/blog/niri-on-mac) vergleicht einen weiteren scrollenden Ablauf. In der Anleitung [Kurzbefehle und Tastaturlayouts](/de/guides/shortcuts) erfährst du, wie du App-Belegungen prüfst.
