Hammerspoon（MAC版）

無料のオープンソース Mac 自動化ツール。ウインドウ、アプリ、キー、オーディオ、Wi-Fi などをシンプルな Lua スクリプトで操作できます。

Hammerspoon の概要

Hammerspoon は、macOS を本格的に自動化するための無料ツールです。その中心は、OS とスクリプト言語 Lua をつなぐ橋渡しです。短いスクリプトを書くと、Hammerspoon がそれを Mac 上の操作に変えてくれます。スクリプトでは、アプリケーション、ウインドウ、マウスポインタ、ファイル、オーディオデバイス、バッテリー、ディスプレイ、低レベルのキーボードやマウスのイベント、クリップボード、位置情報サービス、Wi-Fi などを扱えます。自分だけのショートカット、ウインドウ配置、メニューバー項目、通知、自動化を、思いどおりに作れます。

インストールしただけでは、Hammerspoon は何もしません。~/.hammerspoon フォルダにある init.lua というファイルで設定します。入門ガイドと完全な API ドキュメントが用意されています。Spoons と呼ばれる既製のプラグインを使えば、あまりコードを書かずに機能を追加できます。Hammerspoon は MIT ライセンスの無料オープンソースソフトウェアで、コントリビューターのコミュニティが開発しています。バージョン 1.1.1 には macOS 13 以降が必要で、Apple Silicon と Intel の Mac でネイティブに動作します。

主な機能

Hammerspoon なら、Mac のほぼすべてをスクリプトで操作できます。

Lua スクリプト：シンプルで覚えやすい言語で macOS を自動化。
ウインドウ管理：自分のショートカットや配置で、ウインドウを移動、リサイズ、整列。
グローバルショートカット：どんなキーの組み合わせにも、どんな操作でも割り当てられます。
アプリの操作：アプリの起動、前面表示、非表示、監視。
システムへのアクセス：オーディオデバイス、バッテリー、ディスプレイ、Wi-Fi、クリップボード、位置情報。
イベントの監視：ディスプレイの接続、ネットワークへの接続、アプリの切り替えに反応。
Spoons：よくある作業のための既製のプラグイン。
メニューバーと通知：自分のメニューバー項目、通知、画面上のメッセージを追加。

バージョン 1.1.1 の新機能

Hammerspoon 1.1.1 は小さな修正リリースです。

ダウンロードアーカイブに、macOS の Gatekeeper を混乱させることがある余分なリソースフォークが含まれなくなりました
必要な macOS は macOS 13 以降になりました

Hammerspoon のよくある質問

Hammerspoon は無料ですか？

はい。Hammerspoon は MIT ライセンスの無料オープンソースソフトウェアです。

Hammerspoon に必要な macOS のバージョンは？

Hammerspoon 1.1.1 には macOS 13 以降が必要です。古い Mac では、hammerspoon.org のリリースノートに載っている以前のバージョンを使えます。

Hammerspoon は Apple Silicon で動きますか？

はい。ユニバーサルアプリなので、Apple Silicon と Intel の Mac でネイティブに動作します。

インストールしても Hammerspoon が何もしないのはなぜですか？

Hammerspoon は、設定するまで独自の機能を持ちません。メニューバーのアイコンから Open Config を選び、~/.hammerspoon/init.lua に Lua コードを追加します。

プログラミングの知識は必要ですか？

少し Lua を知っていると便利ですが、入門ガイドでシンプルな例を順に学べます。Spoons を使えば、数行の設定だけで既製の機能を使えます。

Spoons とは何ですか？

Spoons は Lua で書かれた Hammerspoon 用の既製プラグインで、ウインドウ配置やメニューバーのツールなどを、自分で書かずに追加できます。

Hammerspoon でウインドウを管理できますか？

はい。ウインドウ用の機能で移動、リサイズ、整列ができるので、ショートカットと配置を組み合わせた自分だけのウインドウマネージャを作れます。

Hammerspoon がアクセシビリティへのアクセスを求めるのはなぜですか？

macOS では、ほかのアプリやウインドウを操作するアプリにアクセシビリティの許可が必要です。初回起動時に、Hammerspoon が許可を求めます。

Hammerspoon は Homebrew でインストールできますか？

はい。brew install --cask hammerspoon を実行します。

hammerspoon.FULLMAC.app の Hammerspoon のダウンロードはどこから提供されていますか？

ダウンロードボタンは、GitHub にある Hammerspoon の公式リリース https://github.com/Hammerspoon/hammerspoon/releases/latest につながっています。hammerspoon.FULLMAC.app がアプリを改変したり再パッケージしたりすることはありません。