OBS のシーンを 奥行きのある3D空間 に変えて、仮想カメラでカメラワーク・ライティング・カラーグレーディング・画面エフェクトを付けて「撮影」できる OBS Studio プラグインです。 キャプチャ・録画・配信は OBS がそのまま担当するので、いつもの配信・録画の流れに組み込めます。
- Windows 10 / 11（64bit）、または macOS 13 以降（Apple シリコン / Intel）
- OBS Studio 32.2 以降
- Releases から最新の
Kagee-x.y.z-windows-x64-setup.exeをダウンロード - OBS Studio を終了してから、ダウンロードしたファイルをダブルクリック
- 「Windows によって PC が保護されました」と表示されたら「詳細情報」→「実行」
- 「このアプリがデバイスに変更を加えることを許可しますか？」は「はい」
- 「次へ」で進めて完了。OBS Studio を起動し、メニュー 「ドック」→「Kagee」 でパネルを表示
インストーラーを使いたくない場合は Kagee-x.y.z-windows-x64.zip を展開し、中の install.bat をダブルクリックしてください。
- Releases から最新の
Kagee-x.y.z-macos-universal.pkgをダウンロード - OBS Studio を終了してから、ダウンロードしたファイルを 右クリック（または control + クリック）→「開く」
- 普通にダブルクリックすると「開発元を確認できない」と表示されます。その場合は「システム設定」→「プライバシーとセキュリティ」の下の方にある「このまま開く」を押してください
- 画面の指示に従ってインストール（管理者パスワードは不要です）。OBS Studio を起動し、メニュー 「ドック」→「Kagee」 でパネルを表示
zip から手動でインストールする場合
Kagee-x.y.z-macos-universal.zip を展開した kagee.plugin を ~/Library/Application Support/obs-studio/plugins/ に置き、ターミナルで次を実行してから OBS を起動してください（ダウンロードしたファイルに付く「隔離」の印を外します）。
xattr -dr com.apple.quarantine ~/Library/Application\ Support/obs-studio/plugins/kagee.plugin- 3Dにしたいシーンの 一番上 に「Kagee 3Dステージ」を追加（ソース → ＋）
- Kagee パネルの「このシーンのアイテムをレイヤーとして取り込む」を押す
- 「おまかせで8ショット作成」を押し、番号ボタンでショットを切り替える
立体感は「奥行きの強さ」、色は「色のルック」で調整できます。細かく作り込みたいときはパネルを「詳細」モードに切り替えてください。
| 種類 | 名前 | できること |
|---|---|---|
| ソース | Kagee 3Dステージ | 最大8レイヤーを奥行き付きで配置し、仮想カメラで撮影。シーンからワンクリック取り込み、被写界深度（自動背景ブラー）、端が見えない自動拡大 |
| ソース | Kagee 調整レイヤー | 付けたフィルターが「シーン内でこれより下」のレイヤーだけにかかる（テロップやロゴは除外できる） |
| フィルター | カラーグレーディング | ルックプリセット10種、露出・色温度・コントラスト・彩度など、リフト/ガンマ/ゲイン、色調、.cube LUT の読み込みと書き出し、ビフォー/アフター比較 |
| フィルター | ライティング | 環境光（暗さ）＋ライト4灯（スポット / ビーム / リムライト）、首振り・明滅・BPM連動 |
| フィルター | レンズ | 歪み、色収差、シャープ、フィルムグレイン、ビネット、シネマ帯 |
| フィルター | レトロ | VHS、ブラウン管、8mmフィルム、ビデオゲーム（ディザ）、LEDパネル、網点 |
| フィルター | グロー & フレア | ブルーム、アナモルフィックストリーク、クロス / スター |
| フィルター | ブラー | ガウシアン、絞り、ティルトシフト、方向、ズーム / 回転 |
| フィルター | グリッチ | RGB分離、ブロックずれ、ライン裂け、ゆらぎ。ホットキー / BPM でバースト |
| フィルター | モーショントレイル | 残像（ゴースト / エコー / 比較（明） / 加算）、コマ落ち風のフレームレート制限 |
ショット: 「カメラ」と「レイヤーの配置」をまとめて最大8個保存し、なめらかに切り替え。カメラプリセット12種（正面・寄り・引き・左右から・ロー/ハイアングル・ダッチ・横移動・望遠・広角・ドラマチック）。 カメラの動き: 手持ち揺れ、ゆっくりした自動の動き、ビートに合わせたズーム、インパクト揺れ、フラッシュ、BPM / タップテンポでの自動切替。 ホットキー: OBS の「設定 → ホットキー」でショット切替などを割り当て可能（外部コントローラーや obs-websocket からも操作できます）。 マウス操作: ステージを右クリック →「対話」で、ドラッグ・ホイールによるカメラ操作。
- パネルが見つからない — メニュー「ドック」→「Kagee」にチェックを入れてください。
- 何も表示されない — ステージにまだレイヤーがありません。パネルの「このシーンのアイテムをレイヤーとして取り込む」を押してください。
- ショット 1 と 2 が同じになる — ショットは「保存を押した時点の画」を記録します。画を変えてから次の番号の「保存」を押してください。
- プラグインが読み込まれない — OBS Studio のバージョンが 32.2 以降か確認してください（ヘルプ → OBS Studio について）。
- Mac で「開発元を確認できない」と出る — 上の「Mac」のインストール手順（右クリック →「開く」）を参照してください。
- Mac でエフェクトが表示されない — OBS の「設定 → 詳細設定 → レンダラー」が OpenGL（標準）になっているか確認してください（試験的な Metal には未対応です）。
- Windows: 「設定 → アプリ」から Kagee をアンインストール（zip 版の場合は
uninstall.bat） - Mac:
~/Library/Application Support/obs-studio/plugins/kagee.pluginを削除（Finder で「移動 → フォルダへ移動」に上のパスを入力）
必要なもの: Visual Studio 2022（C++ によるデスクトップ開発）、CMake 3.24 以降、Git、Inno Setup 6（インストーラーを作る場合のみ）
powershell -ExecutionPolicy Bypass -File tools/fetch-deps.ps1
cmake -S . -B build -G "Visual Studio 17 2022" -A x64
cmake --build build --config Release
powershell -ExecutionPolicy Bypass -File tools/package.ps1必要なもの: Xcode（コマンドラインツール）、CMake 3.24 以降、Git
bash tools/package-macos.shtools/fetch-deps.ps1/tools/fetch-deps.shが OBS のヘッダーと、OBS に同梱されているものと同じ Qt パッケージ（ハッシュ検証付き）を.deps/に取得します。- Windows では OBS の各 DLL 用インポートライブラリを
sdk/lib/*.defから生成し、macOS では読み込み時に OBS 本体の関数を使います（どちらも OBS 本体のビルドは不要）。 - パッケージは
dist/に作成されます。GitHub Actions では macOS 版を実際の OBS Studio に読み込ませる確認（tools/macos-smoke-test.sh）も行います。 test/には、ポータブル版 OBS を obs-websocket で操作して描画と動作を検証するスクリプトがあります（test/redeploy.ps1→python test/run_*.py、環境変数KAGEE_RENDERER=OpenGLで Mac と同じ OpenGL 描画を検証）。
リポジトリ直下の push.bat をダブルクリックすると、変更をまとめて GitHub に送信します（コミットメッセージを入力するだけ）。
最後に「リリースも作りますか？」と聞かれたら y を入力すると、CMakeLists.txt のバージョン番号でタグを付けて送信し、数分後に Windows / Mac 両方のインストーラー入りのリリース下書きが作られます。新しいリリースを作る前に project(kagee VERSION x.y.z ...) の番号を上げてください。
MIT License © 2026 hakoniwa
Kagee turns an OBS scene into a 3D space and lets you film it with a virtual camera — camera moves, lighting, color grading and cinematic screen effects — right inside OBS Studio.
Requirements: Windows 10/11 (64-bit) or macOS 13+ (Apple silicon / Intel), OBS Studio 32.2 or later.
Install (Windows): download Kagee-x.y.z-windows-x64-setup.exe from Releases, close OBS, run it, then open the panel from Docks → Kagee. (Alternatively unzip Kagee-x.y.z-windows-x64.zip and double-click install.bat.)
Install (Mac): download Kagee-x.y.z-macos-universal.pkg, quit OBS, right-click → Open the package (the installer is not notarized; if blocked, use System Settings → Privacy & Security → "Open Anyway"), then open Docks → Kagee. No administrator password is needed. Use the default OpenGL renderer (the experimental Metal renderer is not supported).
Quick start:
- Add Kagee 3D Stage at the top of the scene you want in 3D.
- In the Kagee panel press Import this scene's items as layers.
- Press Create 8 varied shots automatically and switch shots with the number buttons.
Features: 3D multiplane stage with a virtual camera, shots that store camera + layer layout (12 camera presets), depth of field, adjustment layer, color grading (10 looks, .cube LUT import/export), lighting (spot / beam / rim), lens, retro (VHS/CRT/film/game/LED/halftone), glow & flares, blur, glitch and motion-trail filters, hotkeys, BPM / tap-tempo automation, and a dockable panel with Easy and Detailed modes (Japanese and English UI).
Uninstall: Windows Settings → Apps → Kagee. Mac: delete ~/Library/Application Support/obs-studio/plugins/kagee.plugin.
Build: see the developer section above (tools/package.ps1 on Windows, tools/package-macos.sh on macOS).
License: MIT © 2026 hakoniwa