Repository navigation
Releases
v0.2.0
KageLife v0.2.0 です。Stream Deck から操作するための制御口と、Ableton Link で拍を合わせる -link(実験的)を足しました。
0.x のうちは、起動オプション・制御口・シェーダの uniform を予告なく変えることがあります。
配布物
| OS | アーキテクチャ | ファイル |
|---|---|---|
| macOS | Apple シリコン(arm64) | kagelife-v0.2.0-darwin-arm64.tar.gz |
| macOS | Intel(amd64) | kagelife-v0.2.0-darwin-amd64.tar.gz |
| Linux | amd64 | kagelife-v0.2.0-linux-amd64.tar.gz |
| Linux | arm64 | kagelife-v0.2.0-linux-arm64.tar.gz |
SHA256SUMS で中身を確かめてから使ってください。Windows 向けはありません(ADR-003)。入れ方と更新のしかたは README の「インストール」にあります。
macOS の配布物は未署名です。ブラウザで落とした場合は、展開した後に xattr -d com.apple.quarantine kagelife で quarantine 属性を外してください。
新しくできること
Ableton Link で拍を合わせる(-link、実験的、#43)
実験的な機能です。 rekordbox などの Link の相手と Carabiner を使った実機では、まだ動かしていません。確かめたのは、偽の Carabiner を使った単体テストと CI だけです。ライブで使う前に、手元で拍が合うかを確かめてください。合わないときは
-linkを外せば、今までどおりタップテンポで動きます。
-linkを付けると、Carabiner 経由で Ableton Link の BPM と拍を受け取り、Beatとクロスフェードの速さを Link に合わせます。Carabiner は別に起動しておきます。接続先は-link-addr(既定127.0.0.1:17000)です- Link と同期しているあいだは、Space のタップと制御口の
set_bpmより Link の値を使います。HUD に Link の状態を出します - Link が切れたらタップテンポに戻ります。切れる直前の BPM と拍の頭を引き継ぐので、拍は飛びません
-av-offsetを付けると、Link の拍もその分だけ遅らせます
Stream Deck 向けの制御口(#45)
GET /v1/previews: 数字キー 1〜9 のシェーダの、小さな動くプレビューを返します。-previews=falseで止められますPOST /v1/keys: GUI で数字・[・]のキーを押したのと同じ操作を、制御口から行います- 常駐アプリは別のリポジトリ kagelife-deck にあります
- 制御口の変更は追加だけで、
versionは 1 のままです。対応する機能はGET /v1/stateのfeatures(keys・llm_slots・previews)で分かります
直したこと
- 予約 uniform(
Timeなど)の型が違うシェーダで、描画のときに panic して落ちるのを直しました。PUT では書く前に試し描きをして、422 で返します(#45)
文書
- README のインストール手順を具体的なコマンドにし、PATH の設定と更新の手順を足しました(#44)
- README に、名前の由来、Ebitengine と関連リポジトリ(kagelife-mcp・kagelife-deck・kagelife-shaders)へのリンク、ロゴを足しました(#49、#50)
- ADR-006 に、LLM 背景スロット(
-llm-slots)の契約と、featuresの今の値、PUT の待ち時間を書き足しました(#42、#48)
確かめていないこと
-linkの実機での動作。rekordbox の LINK と Carabiner で、タップ無しで拍が合うか、テンポの変更に追従するか、切れたときに目で見て拍が飛ばないか- 2 台構成(rekordbox の機体と kagelife の機体を LAN でつなぐ)で、Link の相手が見えるか
- Linux 版の、実機の GPU での描画は、VJ 機(Intel HD Graphics 630)1 台でだけ確かめています
Full Changelog: v0.1.0...v0.2.0
v0.1.0
KageLife の最初のリリースです。Kage シェーダを書き換えるとその場で反映されるライブコーディング用の VJ ツールで、今回から配布物を GitHub Release で配ります。
0.x のうちは、起動オプション・制御口・シェーダの uniform を予告なく変えることがあります。
配布物
| OS | アーキテクチャ | ファイル |
|---|---|---|
| macOS | Apple シリコン(arm64) | kagelife-v0.1.0-darwin-arm64.tar.gz |
| macOS | Intel(amd64) | kagelife-v0.1.0-darwin-amd64.tar.gz |
| Linux | amd64 | kagelife-v0.1.0-linux-amd64.tar.gz |
| Linux | arm64 | kagelife-v0.1.0-linux-arm64.tar.gz |
SHA256SUMS で中身を確かめてから使ってください。Windows 向けはありません(ADR-003)。
macOS では、ブラウザで落としたファイルに quarantine 属性が付き、Gatekeeper に止められます。配布物は未署名です。展開した後に次のコマンドで属性を外してください。
xattr -d com.apple.quarantine kagelife
できること
描画・シェーダ
shaders/の.kageを保存すると、その場で再コンパイルして切り替えます(アトミック保存と削除にも追従)- 2 枚のシェーダのクロスフェード。スロットはファイル名順で固定です
- HUD とコンパイルエラーの表示(H キーで HUD を切り替え)
- サンプルシェーダ 01〜09
テンポ
- Space キーでタップテンポ。タップ前は 120 BPM、測定値は 40〜300 BPM
- 拍の位相を uniform
Beatでシェーダに渡します
ライブ向けの起動オプション
-av-offset <ms>: 映像の拍(Beat)を 0〜1000 ms 遅らせます。Bluetooth スピーカーのように観客の聞く音が遅れる会場で、映像を音に合わせるためのものです-list-displays/-display <N>/-fullscreen: 映像を出すディスプレイを選び、起動時から全画面にします。全画面のあいだはマウスカーソルを隠します-render-scale <S>: シェーダを描く解像度を 0.25〜1.0 倍に下げ、GPU の負荷を減らします- HUD に fps と直近 5 秒のフレーム時間の最大値を出します
制御口 v1(LLM との共演用)
- 127.0.0.1 の HTTP/JSON。Bearer トークンと発見ファイルを使います(ADR-006)
- 未知のフィールドを含む要求は拒否します。
GET /v1/stateのfeaturesで対応機能が分かります -llm-slots: 予約したシェーダ名をキー 8・9 に割り当て、キー 0 で元に戻します。予約名への PUT は 403 / 409 で制限します- MCP サーバは別のリポジトリ kagelife-mcp にあります
その他
-versionで版を表示- Carabiner 経由で Ableton Link のテンポと拍を受け取る PoC(
cmd/linkpoc)。本体にはまだ組み込んでいません(docs/poc-carabiner-link.md)
リリース前の修正
- HUD のフェードの拍数が、制御口で指定したフェードの拍数と食い違うのを直しました(#38)
- 起動の途中で失敗したときに、ファイルの監視を閉じずに残すのを直しました(#38)
- 終了した古いプロセスが、新しく起動したプロセスの発見ファイルを消しうる競合を、ファイルロックで直しました(#39)
依存
- Go 1.27.3、Ebitengine v2.10.5
確かめていないこと
- Linux 版の、実機の GPU での描画
- macOS 版の手動確認の一部(README の確認項目)
-display・-fullscreen・-render-scale・-av-offsetの、外部ディスプレイをつないだ実機での動作
Full Changelog: https://github.com/cyokozai/kagelife/commits/v0.1.0