# PaperWM.spoon на macOS: встановлення й базове налаштування

Last updated: 2026-11-12

PaperWM.spoon є безкоштовним плагіном для Hammerspoon на macOS, який працює як менеджер тайлінгу з прокручуванням. Щоб налаштувати його, встановіть Hammerspoon, клонуйте репозиторій PaperWM.spoon до каталогу Spoons у Hammerspoon, завантажте й запустіть Spoon з init.lua та надайте дозволи, які запитує macOS. Наведені команди відповідають README проєкту, перевіреному 2026-11-12.

## Основні факти

- PaperWM.spoon є Spoon для Hammerspoon, а не окремою програмою для Mac.
- Його README містить команду клонування та приклади конфігурації на Lua.
- README пропонує змінити два параметри Mission Control: вимкнути автоматичне впорядкування просторів і увімкнути окремі простори для дисплеїв.
- Він підійде, якщо вам потрібне налаштовуване середовище на Lua; тим, хто не хоче підтримувати конфігурацію Hammerspoon, може краще підійти інший інструмент.

## Спершу встановіть Hammerspoon

Отримайте Hammerspoon на [офіційному сайті](https://www.hammerspoon.org/), перевіреному 2026-11-12. Відкрийте його один раз і виконайте запити дозволів macOS. Hammerspoon запускає сценарії автоматизації, тож перегляньте, що встановлюєте, і який код вирішили завантажити. README проєкту PaperWM.spoon описує плагін і його налаштування. Ми не перевіряли ці кроки на кожній версії macOS.

[Офіційний README](https://github.com/mogenson/PaperWM.spoon) PaperWM.spoon, перевірений 2026-11-12, наводить таку команду для встановлення:

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

Виконайте її в програмі «Термінал». Вона клонує репозиторій до каталогу Spoons, який використовує Hammerspoon. Якщо ви користуєтеся власним каталогом конфігурації Hammerspoon, змініть шлях призначення відповідно до нього.

## Налаштуйте параметри Mission Control

README радить відкрити Системні параметри → Робочий стіл і Dock, а потім розділ Mission Control. У поточних версіях macOS відкрийте «Системні параметри → Робочий стіл і Dock» і прокрутіть до Mission Control. Вимкніть **Автоматично впорядковувати простори за останнім використанням** і увімкніть **Дисплеї мають окремі Spaces**. Точне формулювання й розташування можуть відрізнятися залежно від версії macOS. README подає ці параметри як частину налаштування.

Це загальносистемні вибори, які впливають на те, як macOS працює з просторами. Перш ніж їх змінювати, вирішіть, чи вони підходять вашому налаштуванню. Якщо ви користуєтеся кількома дисплеями, перевірте, чи їхня поведінка просторів відповідає вашим очікуванням.

## Завантажте й запустіть Spoon

Відкрийте файл конфігурації Hammerspoon `~/.hammerspoon/init.lua`. Додайте такі рядки Lua:

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

Збережіть файл. У меню Hammerspoon у смузі меню виберіть **Reload Config**. Перший рядок завантажує Spoon, другий реєструє його задокументовані стандартні сполучення клавіш, а третій запускає керування вікнами. README проєкту також описує шлях через SpoonInstall і приклади власних прив’язок. Почніть зі стандартних призначень, перш ніж редагувати клавіші, щоб зрозуміти, чи налаштування завантажилося.

Щоб зупинити PaperWM.spoon, викличте `PaperWM:stop()` через консоль Hammerspoon або файл конфігурації. Якщо запуск повідомляє, що Spoon не знайдено, перевірте, що каталог клону називається `PaperWM.spoon` і розташований у каталозі Spoons, який використовує Hammerspoon. Перш ніж змінювати кілька налаштувань одразу, перевірте консоль Hammerspoon на помилки Lua.

## Перевірте прив’язки та зробіть одну зміну

[README](https://github.com/mogenson/PaperWM.spoon) PaperWM.spoon, перевірений 2026-11-12, задокументовано стандартні призначення: фокус — Option–Command зі стрілками, обмін місцями — Option–Command–Shift зі стрілками, а перемикання ширини — Option–Command–R. Там також наведено прив’язки для плаваючих вікон, простори і зміни розміру вікон. Якщо сполучення конфліктує з іншою програмою, відредагуйте таблицю Lua, перезавантажте конфігурацію і перевірте консоль Hammerspoon, якщо плагін перестає відповідати.

Власна конфігурація Spoon може фільтрувати програми та змінювати співвідношення вікон. README показує `window_filter` і `window_ratios` як точки налаштування. Змінюйте лише той параметр, який можна знайти в документації, а потім перевірте звичайне вікно програми та одну програму, яку хочете виключити. Супровідники також зазначають, що macOS обмежує переміщення вікон повністю за межі екрана, тож розташовані з краю вікна можуть лишатися частково видимими.

Це інструментарій на основі Lua. Він підходить тим, хто вміє читати файл конфігурації й хоче гнучкості Hammerspoon. Людям, які віддають перевагу окремій програмі з вікном параметрів, така схема може здатися складною в підтриманні. Для PaperWM.spoon авторитетною є інструкція README; перед тим як виконувати кроки, перевірте репозиторій, адже проєкти з відкритим кодом можуть змінюватися.

README PaperWM.spoon каже, що він «натхненний PaperWM», і посилається на [проєкт PaperWM](https://github.com/paperwm/PaperWM), перевірений 2026-11-12. Ці проєкти мають окремі реалізації та інструкції з налаштування.

Ми створюємо SlidePane, macOS-програму для тих, хто хоче налаштовувати макети вікон без підтримки сценаріїв Lua. Вона може підійти, якщо ви віддаєте перевагу параметрам програми та вбудованим елементам керування сполученнями клавіш; PaperWM.spoon краще підходить, якщо вам потрібна модель сценаріїв Hammerspoon. Перегляньте [Встановіть SlidePane і почніть безкоштовний пробний період](/uk/guides/installation), щоб налаштувати саму програму.

## Пов’язані сторінки

[Niri для Mac: як налаштувати схожий робочий процес крок за кроком](/uk/blog/niri-on-mac) порівнює ще один робочий процес із прокручуванням. [Комбінації клавіш і розкладки клавіатури](/uk/guides/shortcuts) пояснює, як переглянути прив’язки програм.
