Skip to content

Releases

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 11 Nov 08:29
cbcd5b8

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

Choose a tag to compare

@github-actions github-actions released this 08 Nov 00:09
0ec2f52

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