これは LESforMacOS のフォーク（派生版）です。 オリジナルの Live Enhancement Suite をベースに、カスタマイズや改良を加えています。
LESforMacOS Custom は Live Enhancement Suite Custom の macOS 版です。Hammerspoon のフォークであり、Hammerspoon を活用した Lua スクリプトを内蔵しています。Ableton Live の操作を便利にするショートカットやマクロを提供し、音楽制作のワークフローを向上させます。
| 項目 | 最低要件 |
|---|---|
| macOS | 12 (Monterey) 以上 |
| Ableton Live | 10 〜 12 |
| 機能 | 説明 | デフォルトキー |
|---|---|---|
| ピアノロールマクロ | ピアノロール操作の自動化 | `（バッククォート） |
| MIDIクリップ作成 | 新規MIDIクリップを素早く作成 | Cmd+Shift+M |
| プロジェクトバージョニング | 新バージョンとして保存 | Cmd+Alt+S |
| マーカー作成 | ロケーターマーカーを作成 | Shift+L |
| ウィンドウ管理 | ウィンドウの閉じる・切替操作 | Ctrl+W |
| カスタムメニュー | メニューバーからの操作 | メニューバーアイコン |
| プラグイン検索 | Spotlight 風プラグイン検索 + お気に入り | Cmd+Shift+H |
| プラグインメニュー設定 | カテゴリ別のプラグインメニューを GUI で編集 | メニューバー |
| プラグインスキャン | VST3 / AU を自動検出してメニューを生成 | メニューバー |
| プロジェクトメモ | プロジェクト単位のタイムライン形式メモ | メニューバー |
| トラックメモ | トラック単位のメモ（トラック名の自動検出対応） | メニューバー |
| ショートカット一覧 | 全ショートカットのオーバーレイ表示 | Cmd+Shift+/ |
| AI アシスタント | 音楽制作 AI チャット (OpenAI) | Cmd+Shift+A |
| AI プラグイン提案 | 使用統計ベースのプラグイン推薦 | メニューバー |
| AI トラック名生成 | トラック名を AI が提案 | メニューバー |
| macOS 通知連携 | エクスポート完了 / 作業時間通知 | 自動 |
設定ファイルは ~/.les/settings.ini に保存されます。主な設定項目：
autoadd— プラグイン検索後に自動追加disableloop— ループボタンの自動有効化を無効化saveasnewver— Cmd+Alt+S でバージョン保存enabledebug— デバッグコンソールを有効化texticon— メニューバーにテキスト "LES" を表示loadspeed— プラグイン挿入時の待機速度language— UI 言語（ja/en）openaikey/openaimodel— AI 機能で使う OpenAI API キー / モデル（設定 → AI 設定 で入力）
API キーを含む設定ファイルはパーミッション
600（所有者のみ読み書き可）で保存されます。
LESforMacOSCustom/
├── Hammerspoon/ # コアアプリケーション (Objective-C)
├── LuaSkin/ # Lua ランタイムラッパー
│ └── lua-5.4.7/ # 組み込み Lua インタープリター
├── extensions/ # Hammerspoon 拡張モジュール (94+)
│ └── les/ # ★ Live Enhancement Suite Custom 本体
│ ├── LESmain.lua # エントリーポイント
│ ├── module.lua # モジュール管理
│ ├── helpers.lua # ファイル操作ヘルパー
│ ├── proccom.lua # プロセス検出・メニュー操作
│ ├── settings.lua # 設定システム
│ ├── ai/ # AI 機能 (OpenAI API 連携)
│ ├── shortcuts/ # キーボードショートカット
│ ├── menus/ # メニューバー UI・設定 GUI
│ ├── ui/ # チートシート・HUD
│ ├── lifecycle/ # リロード・アプリ監視
│ ├── tracking/ # タイマー・通知・プロジェクト/トラックメモ・プラグイン統計
│ ├── vst/ # VST プラグイン操作
│ └── tests/ # busted テストスイート
├── Pods/ # CocoaPods 依存関係
├── Hammerspoon.xcworkspace/ # Xcode ワークスペース
├── Dockerfile.test # テスト実行環境 (Docker)
├── CLAUDE.md # Claude Code プロジェクトコンテキスト
├── CHANGELOG.md # 変更履歴
├── LICENSE # MIT ライセンス
└── README.md # このファイル
- Xcode 14.1 以上（Apple Developer アカウントが必要）
- Homebrew
- CocoaPods
- Ruby 3.x
# Homebrew パッケージ
brew install coreutils jq xcbeautify gawk gh gpg
# Ruby gems
gem install --user t
gem install trainergit clone https://github.com/bassmicrobe/LESforMacOSCustom
cd LESforMacOSCustom
# CocoaPods 依存関係のインストール
pod install
# Python 依存関係のインストール
pip3 install --user -r requirements.txt開発からリリースまでの全体の流れ：
ソースコード
│
├─ [開発用] デバッグビルド → .app → そのまま起動して動作確認
│
└─ [配布用] リリースビルド → .app → DMG に梱包 → .dmg をユーザーに配布
│ │
└─ (任意) Apple 公証 └─ ユーザーが開いて
Gatekeeper 対応 /Applications にドラッグ
コンパイルして .app を生成し、動作確認に使います：
XCODE_ARGS="GCC_TREAT_WARNINGS_AS_ERRORS=NO MACOSX_DEPLOYMENT_TARGET=11.0"
xcodebuild -workspace Hammerspoon.xcworkspace -scheme Hammerspoon \
-configuration Debug ${XCODE_ARGS} clean build | xcbeautify既存プロセスを終了してすぐ起動するショートカット：
./rebuild.sh方法 A: ワンコマンド
# ビルド→検証→公証→アーカイブを一括実行
./scripts/release.sh方法 B: 手動ステップ
# ① ビルド（Release 構成で .app を生成）
./scripts/build.sh clean
./scripts/build.sh docs
./scripts/build.sh build -s Release -c Release
./scripts/build.sh validate
# ② DMG に梱包（.app をインストーラーに変換）
npm install -g create-dmg # 初回のみ
mkdir -p release
cp -R ~/Library/Developer/Xcode/DerivedData/*/Build/Products/Release/*.app/ \
"./Live Enhancement Suite Custom.app/"
create-dmg --dmg-title="Live Enhancement Suite Custom" \
"Live Enhancement Suite Custom.app" release/
mv release/*.dmg release/LiveEnhancementSuite.dmg
shasum -a 256 release/LiveEnhancementSuite.dmg > release/LiveEnhancementSuite.dmg.sha256sumrelease/LiveEnhancementSuite.dmg が配布用インストーラーです。
App Store 外で配布する場合、macOS Gatekeeper に「安全なアプリ」と認識させるため公証を行います：
# 公証用プロファイルの設定（初回のみ）
xcrun notarytool store-credentials -v \
--apple-id YOUR_APPLE_ID \
--team-id YOUR_TEAM_ID \
--password APP_SPECIFIC_PASSWORD
# 公証の実行（DMG 作成前に行う）
./scripts/build.sh notarizev* 形式のタグをプッシュすると、上記の全工程を GitHub Actions が自動実行します：
git tag v1.0.0
git push origin v1.0.0
# → 自動で: リリースビルド → DMG 作成 → GitHub Releases にアップロードワークフローの詳細: .github/workflows/les_release.yml
Docker を使ってローカル環境を汚さずにテストを実行できます。
# イメージをビルドして全テスト実行（luacheck + busted）
docker build -f Dockerfile.test -t les-test .
docker run --rm les-test
# busted テストのみ
docker run --rm les-test busted extensions/les/tests/
# luacheck 静的解析のみ
docker run --rm les-test luacheck extensions/les/
# コンテナ内でシェルを開く
docker run --rm -it les-test /bin/shDocker イメージには以下が含まれます：
- Lua 5.4 + busted（テストフレームワーク）+ luacheck（静的解析）
- Node.js 22 + pnpm（JS ツールチェーン用）
テストファイルは extensions/les/tests/ に *_spec.lua の命名規則で配置します。
LESforMacOS へのコントリビューションは、Hammerspoon フォーク部分と LES スクリプト部分の両方で受け付けています。
既存の Hammerspoon ユーザーにとっては、~/.hammerspoon がアプリケーションバンドル内に組み込まれていると考えるとわかりやすいです。
LESforMacOS は設定ファイルとジャンプスタートスクリプト（Hammerspoon コアをアプリケーションバンドル内のロジックにリダイレクトする init.lua）を ~/.les に保存しますが、コアロジックは Contents/Resources/extensions/hs/les にあります。
ソースツリーでは extensions/les に対応します。
Acknowledgements. The maintainers of this fork are deeply grateful to the authors and contributors of Live Enhancement Suite for macOS for designing and sharing a powerful workflow for Ableton Live users; to everyone who has contributed to Hammerspoon, on whose foundation this application is built; and to Lua.org / PUC-Rio for the Lua language and runtime that powers the embedded scripting layer. Their generosity under open licenses makes projects like this one possible, and we thank them sincerely.
本リポジトリは MIT License のコンポーネントを組み合わせたものです。再配布・改変の際は、各パーツの 著作権表示（Copyright notice） と MIT ライセンス本文（Permission notice 全文） をドキュメントや頒布物に含めてください。
- LES スクリプト（
extensions/les/）— オリジナルは LESforMacOS。著作者一覧は extensions/les/AUTHORS.txt。条項はリポジトリ内extensions/les/COPYING.txtと同一の全文を以下に記載します。 - Hammerspoon アプリ本体（
Hammerspoon/、LuaSkin/などコア）— ルートLICENSEと同一の全文を以下に記載します。 - 組み込み Lua（
LuaSkin/lua-5.4.7/）— Lua.org / PUC-Rio の著作。条項は同梱のLuaSkin/lua-5.4.7/doc/readme.html等を参照してください。 - 本フォークの追加・改変（
Copyright (c) 2026 bassmicrobe等）— 上記と同様に MIT License の条件のもとで提供します（条項は下記「MIT License」本文に従います）。
MIT License
Copyright (c) 2019-2023 LESforMacOS authors, see AUTHORS.txt for a list
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
The MIT License (MIT)
Copyright (c) 2014-2017 [Various Contributors](https://github.com/Hammerspoon/hammerspoon/graphs/contributors)
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
上記のほか、個別ファイルの SPDX ヘッダや extensions/utf8/LICENSE など、サブディレクトリに含まれるライセンス表記も条件に従ってください。