Переведено с английского; английский текст является авторитетным для цен и условий.

Getting started

PaperWM.spoon на macOS: установка и базовая настройка

PaperWM.spoon — бесплатный плагин для Hammerspoon на macOS, который работает как прокручиваемый менеджер мозаики окон. Чтобы его настроить, установите Hammerspoon, клонируйте репозиторий PaperWM.spoon в папку Spoons Hammerspoon, загрузите и запустите Spoon из init.lua и разрешите те права, которые запрашивает macOS. Команды ниже следуют README проекта; проверено 12 ноября 2026 года.

4 мин чтения ·

Ключевые факты

  • PaperWM.spoon — это Spoon для Hammerspoon, а не отдельное приложение для Mac.
  • В README есть команда клонирования и примеры настройки на Lua.
  • В README предлагается изменить два параметра Mission Control: отключить автоматическую перегруппировку рабочих столов и включить отдельные рабочие столы для дисплеев.
  • Он подходит, если вам нужна настраиваемая установка на Lua; тем, кто не хочет поддерживать конфигурацию Hammerspoon, может подойти другой инструмент.

Сначала установите Hammerspoon

Скачайте Hammerspoon с официального сайта; проверено 12 ноября 2026 года. Откройте его один раз и следуйте запросам разрешений macOS. Hammerspoon запускает скрипты автоматизации, поэтому проверяйте, что устанавливаете, и какой код решаете загрузить. В README проекта PaperWM.spoon описаны плагин и его установка. Мы не проверяли эти шаги на каждой версии macOS.

Официальный README PaperWM.spoon, проверено 12 ноября 2026 года, даёт такую команду установки:

``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 PaperWM.spoon, проверено 12 ноября 2026 года, описаны стандартные назначения: фокус — 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 сказано, что он «Inspired by PaperWM», и есть ссылка на проект PaperWM; проверено 12 ноября 2026 года. У проектов отдельные реализации и инструкции по установке.

Мы делаем SlidePane: macOS-приложение для тех, кто хочет настраивать раскладки окон без поддержки скриптов на Lua. Оно может подойти, если вы предпочитаете настройки в приложении и встроенные элементы управления сочетаниями; PaperWM.spoon лучше подходит, если вам нужна модель скриптов Hammerspoon. Настройку приложения смотрите в Установите SlidePane и начните бесплатный пробный период.

Связанные страницы

Niri на Mac: как шаг за шагом настроить похожий рабочий процесс сравнивает другой прокручиваемый рабочий процесс. Сочетания клавиш и раскладки клавиатуры объясняет, как просмотреть сочетания приложения.