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の設定（ディスプレイごとに個別の操作スペースを使用）を変更する必要があります。
• !画面外にタイル表示されるウィンドウは画面端の余白に配置されます。また、スペース間や画面間でのウィンドウのドラッグは検出しにくい場合があります。

トピック

よくある質問

PaperWM.spoon とは？

Hammerspoon向けSpoonプラグインとして実装された、macOS用のタイル型スクロールウィンドウマネージャー。 PaperWM.spoonは、GNOMEの拡張機能PaperWMのように、macOSのウィンドウを左右にスクロールできる横並びの列に配置します。新しいウィンドウは自動的にタイル状に配置され、各列はサイズ変更やアコーディオン状のスタック、別のウィンドウとの分割が可能です。

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