Přeloženo z angličtiny; anglické znění je závazné pro ceny a podmínky.

Getting started

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

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.

4 min přečteno ·

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, 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 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 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, 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í.

Související stránky

Niri pro Mac: podobný postup krok za krokem porovnává další posuvný pracovní postup. Zkratky a rozvržení klávesnice vysvětluje, jak zkontrolovat zkratky aplikace.