mogenson/PaperWM.spoon

어떤 프로젝트인가요?

핵심 기능

• 01타일형 창 열을 가로로 배치하고 스크롤
• 02Hammerspoon 단축키로 포커스 이동, 창 교체, 크기 조절
• 03아코디언 방식으로 열 쌓기 및 화면 분할 레이아웃
• 04Mission Control 공간 간 창 이동
• 05트랙패드 스와이프와 마우스 드래그 또는 스크롤로 창 이동
• 06창 간격, 외부 표시줄 오프셋, 앱별 기본 너비 설정

활용 사례

• macOS를 벗어나지 않고 GNOME PaperWM 스타일의 스크롤 타일링을 원하는 Mac 사용자
• 편집기와 터미널 창을 여러 개 열어 두고 키보드 중심으로 레이아웃을 관리하려는 개발자
• 여러 디스플레이나 Mission Control 공간에서 일관된 창 배치를 원하는 사용자

빠른 시작

1. 1

   Spoon을 Hammerspoon Spoons 디렉터리에 클론합니다

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

   README에 설명된 대로 시스템 설정에서 Mission Control 설정을 변경합니다

3. 3

   ~/.hammerspoon/init.lua에서 Spoon을 로드하고 시작합니다

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

사용 전 알아둘 점

• !macOS와 Hammerspoon 자동화 앱이 필요합니다.
• !사용하기 전에 Mission Control 설정(디스플레이마다 별도의 Space 사용)을 변경해야 합니다.
• !화면 밖에 타일링될 창은 화면 가장자리의 여백에 배치되며, Space나 화면 사이에서 창을 드래그하는 동작은 감지하기 어렵습니다.

토픽

자주 묻는 질문

PaperWM.spoon은(는) 무엇인가요?

Hammerspoon용 Spoon 플러그인으로 구현한 macOS용 타일형 스크롤 윈도우 매니저입니다. PaperWM.spoon은 macOS의 창을 좌우로 스크롤할 수 있는 가로 열 형태로 배치하며, GNOME용 PaperWM 확장과 비슷하게 동작합니다. 새 창은 자동으로 타일링되고, 각 열은 크기를 조절하거나 아코디언처럼 쌓거나 다른 창과 분할할 수 있습니다.

PaperWM.spoon은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

PaperWM.spoon은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

PaperWM.spoon은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. PaperWM.spoon의 마지막 커밋은 2026년 10월 13일입니다.

PaperWM.spoon은(는) 어디에 사용할 수 있나요?

macOS를 벗어나지 않고 GNOME PaperWM 스타일의 스크롤 타일링을 원하는 Mac 사용자 편집기와 터미널 창을 여러 개 열어 두고 키보드 중심으로 레이아웃을 관리하려는 개발자 여러 디스플레이나 Mission Control 공간에서 일관된 창 배치를 원하는 사용자

PaperWM.spoon는 어떻게 설치하나요?

Spoon을 Hammerspoon Spoons 디렉터리에 클론합니다: git clone https://github.com/mogenson/PaperWM.spoon ~/.hammerspoon/Spoons/PaperWM.spoon README에 설명된 대로 시스템 설정에서 Mission Control 설정을 변경합니다 ~/.hammerspoon/init.lua에서 Spoon을 로드하고 시작합니다: PaperWM = hs.loadSpoon("PaperWM") PaperWM:bindHotkeys(PaperWM.default_hotkeys) PaperWM:start()

PaperWM.spoon은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/mogenson/PaperWM.spoon