英語から翻訳しています。価格と利用条件は英語版が正式な情報です。

Getting started

macOSでPaperWM.spoonを導入し基本設定する

PaperWM.spoonは、macOS上のHammerspoon向けの無料でスクロール可能なタイル型ウインドウマネージャのプラグインです。設定するには、Hammerspoonをインストールし、PaperWM.spoonのリポジトリをHammerspoonのSpoonsフォルダに複製し、init.luaからSpoonを読み込んで起動します。そのあと、macOSが求める許可を付与してください。以下のコマンドは、プロジェクトのREADMEに従っています。2026年11月12日に確認しました。

5 分で読めます ·

主な事実

  • PaperWM.spoonは単独のMacアプリではなく、Hammerspoonのspoonです。
  • READMEには、クローンのコマンドとLuaの設定例があります。
  • READMEでは、Mission Controlの2つの設定を変更するよう案内しています。操作スペースの自動並べ替えをオフにし、ディスプレイごとに個別の操作スペースをオンにします。
  • 設定をLuaで行うことを望む人には適しています。Hammerspoonの設定の管理を避けたい人は、別のツールを選ぶかもしれません。

まずHammerspoonをインストールする

Hammerspoonは、公式サイトから入手できます。2026年11月12日に確認しました。一度開き、macOSの許可のプロンプトに従ってください。Hammerspoonは自動化スクリプトを実行するため、インストールするものと読み込むコードは確認してから使いましょう。PaperWM.spoonのプロジェクトのREADMEには、プラグインとそのセットアップが説明されています。これらの手順を、すべてのmacOSのバージョンで試したわけではありません。

PaperWM.spoonの公式READMEでは、2026年11月12日に確認した時点で、次のインストールコマンドが案内されています。

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

これはターミナルで実行します。Hammerspoonが使うSpoonsフォルダにリポジトリをクローンします。独自のHammerspoonの設定ディレクトリを使っている場合は、保存先をそれに合わせて調整してください。

Mission Controlの設定をする

READMEでは、「システム環境設定 → デスクトップとDock」のMission Controlの項目を案内しています。現在のmacOSでは、システム設定 → デスクトップとDockを開き、Mission Controlまでスクロールします。最近の使用状況に基づいて操作スペースを自動的に並べ替えるをオフにし、ディスプレイごとに個別の操作スペースを使用をオンにします。文言や配置はmacOSのバージョンによって異なる場合があります。READMEでは、これらの項目をセットアップの一部として挙げています。

これらはmacOS全体に影響する設定で、macOSが操作スペースを扱う方法を変えます。変更する前に、自分の環境に合うかどうかを判断してください。複数のディスプレイを使っている場合は、操作スペースの動作が希望どおりかを確認してください。

Spoonを読み込んで起動する

Hammerspoonの設定ファイルである~/.hammerspoon/init.luaを開きます。次のLuaの行を追加してください。

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

ファイルを保存します。HammerspoonのメニューバーのアイコンからReload Configを選びます。1行目はSpoonを読み込み、2行目は文書化された既定のキー割り当てを登録し、3行目でウインドウの管理を開始します。プロジェクトのREADMEには、SpoonInstallの手順と、カスタムのキー割り当ての例も掲載されています。キーを編集する前に、まず既定の設定で始めて、セットアップが正しく読み込まれたかを確かめてください。

PaperWM.spoonを止めるには、Hammerspoonのコンソールまたは設定からPaperWM:stop()を呼び出します。起動時にSpoonが見つからないと報告される場合は、クローンしたフォルダ名がPaperWM.spoonになっていて、Hammerspoonが使うSpoonsディレクトリの中にあるか確認してください。複数の設定を一度に変える前に、Hammerspoonのコンソールに表示されるLuaのエラーを確認しましょう。

キー割り当てを確認して、ひとつだけ変更する

PaperWM.spoonのREADMEでは、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です。オープンソースのプロジェクトは変わることがあるため、従う前にリポジトリを確認してください。

PaperWM.spoonのREADMEには「Inspired by PaperWM」と書かれており、2026年11月12日に確認したPaperWMプロジェクトへのリンクがあります。両者は別々の実装とセットアップの手順を持っています。

私たちはSlidePaneを提供しています。Luaのスクリプトを維持せずに、ウインドウのレイアウトを設定したい人のためのmacOSアプリです。アプリの設定と組み込みのショートカットの操作を好むなら、SlidePaneが合うかもしれません。Hammerspoonのスクリプト型の仕組みを使いたいなら、PaperWM.spoonのほうが適しています。アプリのセットアップについては、SlidePaneをインストールして無料トライアルを始めるのガイドを参照してください。

関連ページ

MacでのNiri風のワークフローの記事では、別のスクロール型ワークフローを比較しています。アプリのキー割り当てを確認するには、ショートカットとキーボードレイアウトのガイドを参照してください。