# PaperWM.spoon na macOS: základní instalace a nastavení

Last updated: 2026-11-12

PaperWM.spoon je bezplatný plugin pro Hammerspoon na macOS, který spravuje okna jako posuvnou dlaždicovou řadu. Pro nastavení nainstalujte Hammerspoon, naklonujte repozitář PaperWM.spoon do složky Spoons v Hammerspoonu, načtěte a spusťte Spoon z init.lua a udělte oprávnění, která macOS vyžaduje. Příkazy níže vycházejí z README projektu, ověřeno 12. 11. 2026.

## Klíčová fakta

- PaperWM.spoon je Spoon pro Hammerspoon, nikoli samostatná aplikace pro Mac.
- Jeho README uvádí příkaz pro klonování a ukázky konfigurace v Lua.
- README žádá uživatele, aby změnili dvě nastavení Mission Control: vypnuli automatické přeuspořádání ploch a zapnuli „Monitorům jsou přiřazeny samostatné plochy“.
- Hodí se, pokud chcete konfigurovatelné nastavení založené na Lua; lidé, kteří nechtějí udržovat konfiguraci Hammerspoonu, mohou zvolit jiný nástroj.

## Nejprve nainstalujte Hammerspoon

Hammerspoon získáte na [oficiálních stránkách](https://www.hammerspoon.org/), ověřeno 12. 11. 2026. Otevřete jej jednou a projděte výzvy macOS k oprávněním. Hammerspoon spouští automatizační skripty, proto si před načtením zkontrolujte, co instalujete a jaký kód zvolíte. README projektu PaperWM.spoon popisuje plugin a jeho nastavení. Tyto kroky jsme neotestovali na každé verzi macOS.

[Oficiální README](https://github.com/mogenson/PaperWM.spoon) PaperWM.spoon, ověřené 12. 11. 2026, uvádí tento instalační příkaz:

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

Spusťte jej v Terminálu. Naklonuje repozitář do složky Spoons, kterou Hammerspoon používá. Pokud máte vlastní konfigurační složku Hammerspoonu, upravte cíl tak, aby odpovídal.

## Nastavte možnosti Mission Control

README vede k Předvolbám systému → Plocha a Dock a k sekci Mission Control. Na aktuálním macOS otevřete Nastavení systému → Plocha a Dock a přejděte k Mission Control. Vypněte **Automaticky uspořádat Spaces podle nedávného použití** a zapněte **Monitorům jsou přiřazeny samostatné plochy**. Přesné znění a umístění se mohou lišit podle verze macOS. README tyto možnosti uvádí jako součást nastavení.

Jde o nastavení celého systému, která ovlivňují, jak macOS pracuje s plochami. Před změnou rozhodněte, zda se hodí k vašemu nastavení. Pokud používáte více displejů, ověřte, že chování ploch odpovídá tomu, co chcete.

## Načtěte a spusťte Spoon

Otevřete konfigurační soubor Hammerspoonu na cestě `~/.hammerspoon/init.lua`. Přidejte tyto řádky v Lua:

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

Soubor uložte. V nabídce ikony Hammerspoonu v řádku nabídek vyberte **Reload Config**. První řádek načte Spoon, druhý zaregistruje jeho zdokumentované výchozí klávesové zkratky a třetí spustí správu oken. README projektu také ukazuje cestu přes SpoonInstall a vzorové vlastní zkratky. Začněte s výchozími, než začnete měnit klávesy, abyste poznali, zda se nastavení načetlo.

Pro zastavení PaperWM.spoon zavolejte `PaperWM:stop()` v konzoli nebo konfiguraci Hammerspoonu. Pokud při spuštění hlásí chybějící Spoon, zkontrolujte, zda se složka klonu jmenuje `PaperWM.spoon` a je uvnitř složky Spoons, kterou Hammerspoon používá. Před změnou několika nastavení najednou zkontrolujte v konzoli Hammerspoonu chyby v Lua.

## Zkontrolujte zkratky a udělejte jednu změnu

[README](https://github.com/mogenson/PaperWM.spoon) PaperWM.spoon, ověřené 12. 11. 2026, dokumentuje výchozí hodnoty: zaměření pomocí Option–Command se šipkami, záměna pomocí Option–Command–Shift se šipkami a přepínání šířky pomocí Option–Command–R. Ukazuje také zkratky pro plovoucí režim, plochy a změnu velikosti oken. Pokud zkratka koliduje s jinou aplikací, upravte tabulku v Lua, znovu načtěte konfiguraci a pokud plugin přestane reagovat, zkontrolujte konzoli Hammerspoonu.

Vlastní konfigurace Spoonu umí filtrovat aplikace a upravovat poměry šířky oken. README uvádí `window_filter` a `window_ratios` jako místa pro nastavení. Měňte jen nastavení, které najdete v dokumentaci, a poté otestujte běžné okno aplikace a jednu aplikaci, kterou chcete vyloučit. Správci projektu také upozorňují, že macOS omezuje přesun oken úplně mimo obrazovku, takže dlaždice na okrajích mohou zůstat částečně viditelné.

Jde o nástrojovou sadu založenou na Lua. Hodí se lidem, kteří se dobře orientují v konfiguračním souboru a chtějí pružnost Hammerspoonu. Lidé, kteří dávají přednost samostatné aplikaci s oknem nastavení, mohou toto nastavení shledat náročným na údržbu. Pro PaperWM.spoon je závazný návod v README; než podle něj postupujete, zkontrolujte repozitář, protože projekty s otevřeným zdrojovým kódem se mohou měnit.

README PaperWM.spoon uvádí, že je „Inspired by PaperWM“, a odkazuje na [projekt PaperWM](https://github.com/paperwm/PaperWM), ověřeno 12. 11. 2026. Oba projekty mají samostatnou implementaci a vlastní návody k nastavení.

Děláme SlidePane, aplikaci pro macOS pro lidi, kteří chtějí nastavovat rozvržení oken bez údržby skriptů v Lua. Může vám vyhovovat, pokud dáváte přednost nastavení aplikace a vestavěným ovládacím prvkům zkratek; PaperWM.spoon se hodí lépe, pokud chcete jeho model skriptování v Hammerspoonu. Nastavení aplikace najdete v průvodci [Nainstalujte SlidePane a spusťte bezplatné zkušební období](/cs/guides/installation).

## Související stránky

[Niri pro Mac: podobný postup krok za krokem](/cs/blog/niri-on-mac) porovnává další posuvný pracovní postup. [Zkratky a rozvržení klávesnice](/cs/guides/shortcuts) vysvětluje, jak zkontrolovat zkratky aplikace.
