開発中の Blender Extension のディレクトリを /extensions/ 直下に配置します。.git/ はリポジトリのルートに残します。

/EXTENSION/blender_manifest.toml ---> /EXTENSION/extensions/EXTENSION/blender_manifest.toml
/EXTENSON/.git/ ---> /EXTENSION/.git/

リポジトリのルートディレクトリと、/extensions/ *直下の拡張機能のパッケージとしてのディレクトリが、同名である必要があります。これを回避するには、 この後の手順で配置される /.devcontainer/devcontainer.json において、

    - "workspaceFolder": "/workspaces/development/extensions/${localWorkspaceFolderBasename}",
    + "workspaceFolder": "/workspaces/development/extensions/",

などとする必要があります。

curl -L -o .devcontainer.json https://raw.githubusercontent.com/peakys-org/blender-devcontainer/main/.devcontainer.json

/blender_services.json は例えば次のように記述します。

{
    "blender-4.5-a": {"version": "4.5.4", "port": 5901, "resources": "../portable/"},
    "blender-4.5-b": {"version": "4.5.4", "port": 5902},
    "blender-5.0": {"version": "5.0.0", "port": 5903, "resources": "../portable/"}
}

curl -L -o blender_services.json https://raw.githubusercontent.com/peakys-org/blender-devcontainer/main/blender_services.json

{
    service: {"version": version, "port": port, "resources": resources}
}

• service は、 Blender を稼働するサービスコンテナの名前を lower_case で指定します。
• version は、 Blender のセマンティックバージョンを文字列で指定します。
• port は、 Blender を稼働するサービスコンテナに使用するポート番号を整数で指定します。ポートの重複にご注��ください。
• resources は、 Blender のユーザーディレクトリとしてマウントするパスを文字列で指定します。相対バスは /.devcontainer/compose.yaml を基準とします。この属性は省略できます。

devcontainer up --workspace-folder .

または、 Visual Studio Code の場合、Ctrl + Shift + P で開くコマンドパレットにおいて、

> Dev Containers: Rebuild and Reopen in Container

とします。

フォークしたリポジトリにおいて、/blender_servicess.json を設定したうえで、

postStartCommand.sh

を実行してください。

/.devcontainer/devcontainer.json による Dev Container を開きます。

devcontainer up --workspace-folder .

または、 Visual Studio Code の場合、Ctrl + Shift + P で開くコマンドパレットにおいて、

> Dev Containers: Rebuild and Reopen in Container

とすることをお勧めします。

エディタと接続せず、Docker Compose のみを稼働

docker compose --file .devcontainer/compose.yaml up

することもできます。リソースを削除するには

docker compose --file .devcontainer/compose.yaml down --volumes --remove-orphans --rmi all

などとします。

接続するバージョンの Blender を選択します。

tail -f --retry /workspaces/development/output-*log

Dev Container は次の三種の Docker コンテナから成る Docker Compose を基にします。

• <blender-service> : Blender GUI を提供する。
• novnc : blender コンテナからの VNC 接続をブラウザに配信する。
• devcontainer : Dev Container の接続先で、 Blender からの出力を提供する。

また、<blender-service> コンテナには同名の名前付きボリュームが /workspaces/blender としてマウントされます。名前付きボリューム <blender-service> は Blender 本体が置かれる場所です。devcontainer コンテナには同時に稼働する全ての <blender-service> 名前付きボリュームがマウントされます。マウントポイントは /workspaces/<blender-service> です。

ウィンドウシステムと Blender の GUI を提供するコンテナです。利用したソフトウェアは以下の通りです。

• Arch Linux : OS、コンテナベースイメージ
• Sway : Wayland コンポジタ、ウィンドウシステム
• WayVNC : VNC
• Blender : 公式ビルド tarball を利用します。

主なディレクトリ構成は次の通りです。

• /workspaces/development/: リポジトリがマウントされます。
• /workspaces/development/extensions/ *: 直下のディレクトリが Blender Extension パッケージです。このディレクトリを監視して Extension をホットリロードします。
• /workspaces/development/repository/ *: Blender Extension のリモートリポジトリとして使われます。
• /workspaces/blender/: Blender が置かれます。

Docker コンテナ上の Sway については github.com/stephanlensky/swayvnc-chrome を援用しました。stephanlensky 様に御礼申し上げます。

VNC クライアントをブラウザに配信するコンテナです。/.devcontainer/novnc/ は /novnc_setup/ および /novnc_setup/setup.sh によって完全に再現されます。

Dev Container の接続先となるコンテナです。 mcr.microsoft.com/devcontainers/base:ubuntu をベースイメージとし、Blender CLI のための依存関係を備えています。Blender のインストール先となる名前付きボリュームコンテナをマウントしているので、Blender の CLI が使えます。

議論：devcontainer コンテナから Blender が使える必要はある？

主なディレクトリ構成は次の通りです。

• /workspaces/development/: リポジトリがマウントされます。以下は blender コンテナ と共通です。
• /workspaces/<blender-service>: 各 Blender が置かれます。

各 Blender からの出力をターミナルに標準出力してください。

tail -f --retry /workspaces/development/output-<blender-service>.log

( noVNC の HTML へ注入する JavaScript として実装 )

• ctrl + c : 接続先のクリップボードのテキストを接続元のクリップボードにコピーします。
• ctrl : 接続元のクリップボードのテキストを接続先のクリップボードにコピーします。ただし、この動作はキーの押下に関わらず 0.1 秒に一度自動的に行われます。
• これらにより、ctrl + c, ctrl + v がほとんどの方々の期待する通りに動作します。

( Sway へのキーバインドとして実装 )

• ESC : Blender の現在のウィンドウを閉じます。

/workspaces/<blender-service>/blender --command extension validate <package>

<package> は Blender Extension パッケージのフルパスです。

/workspaces/<blender-service>/blender --command extension build --source-dir <package> --output-dir /workspaces/development/repository

<package> はBlender Extension パッケージのフルパスです。

/workspaces/<blender-service>/blender --command extension server-generate --repo-dir /workspaces/development/repository

• template.yaml : Dev Container Template を公開します。
• image.yaml : Dev Container を構成するコンテナイメージを公開します。
• release.yaml : v*.*.0 というセマンティックバージョニングのタグに対し、リリースを作ります。
• depandabot_auto_merge.yaml : depandabot.yaml によりプルリクエストされた依存関係のバージョンアップを自動的にマージします。

PyArmor により、Python を難読化します。

docker buildx build --output type=local,dest=. --file "./utils/obfuscate/obfuscate.Dockerfile" [--build-arg PACKAGES="<package1> <package2> ..."] .

のようにして使います。/extesions/ を ./extensions/ として参照できる場所で実行するか、パスを指定してフラグ --build-arg extensions/ を渡します。

<package1>, <package2>, ... は extensions/ 直下のパッケージとなるディレクトリのベースネームです。 [--build-arg PACKAGE="<package1> <package2> ..."] は複数のパッケージを指定できます。 省略した場合は extensions/ 直下の全てのパッケージが対象となります。

utils/obfuscate/obfuscate.sh [package1] [package2] ...

のようにして使います。

[package1], [package2], ... は extensions/ 直下のパッケージのとなるディレクトリのベースネームです。0 個以上のパッケージを指定できます。指定されたパッケージが 0 個の場合、/extensions/ 直下の全てのパッケージが対象となります。

GitHub Actions ワークフローとして使います。

cp utils/obfuscate/obfuscate.yaml .github/workflows/obfuscate.yaml

workflow_dispatch は対象のパッケージを指定できます。それ以外の場合、 extensions/ 直下の全てのパッケージが対象となります。

Visual Studio Code による Blender Extensions 開発の白眉、Jacques Lucke 氏による Visual Studio Code 拡張機能 "Blender Development" ( jacqueslucke.blender-development ) は使えません。

Visual Studio Code 拡張機能はローカルにインストールされるものであり、コンテナ上の Blender をこれに接続するのは容易ではないためです。

Sway はウィンドウのタイトルバーにボタンを描画しません*。 Sway 上でウィンドウのタイトルバーにボタンを描画するには CSD を使う必要がありますが、Blender の公式ビルドはこれに対応していないようです。

Sway へのキーバインドにより、 ESC キーで Blender のフォーカスされたのウィンドウを閉じることができます。

前面ウィンドウ A と背面のウィンドウ B が表示されている場合、前面のウィンドウ A を閉じずに背面のウィンドウ B にフォーカスすると、フォーカスされたウィンドウ B が前面になり、背面のウィンドウ A を二度と見ることができなくなる場合があります。これを回避するには /.devcontainer/blender/sway/config において、

# Comment out if you are familiar with tiled windows.
for_window [app_id="blender"] floating enable

をコメントアウトしてください。

# 未対応エラー を参照してください。エラーのほとんどは GPU に関連します。

GPU 利用の確立のためには、

• ホストマシン
• Docker
• Arch Linux
• Sway
• Blender

の全てのレイヤーをクリアする必要があります。

noVNC はブラウザから接続できる唯一の VNC クライアントであると了解しています*。

GitHub Codespaces をブラウザから利用するときに、ブラウザの別タブから Blender を利用できます。

将来においてウィドウシステムは Wayland が標準になると予想しています。長い将来に亘ってシステムの老朽化を避けたいという願望です。

また、X Window System のエコシステムは熟成し過ぎている印象を受けます。デスクトップ環境とその依存関係にはそれぞれ選択肢が無数に存在し、どれを選ぶべきかという選択に労力を奪われました。

Bledner と Wayland については、

• Blender マニュアル
• Blender における Wayland サポート

が参照されます。

Wayland コンポジタに適したリモートデスクトップサーバーとしては、WayVNC が最も洗練されたツールであるように思いました。

Wayland における ネットワーク透過性については、

• Wayland FAQ No.8

が参照されます。同記事において、WayVNC に直接言及する記述は次の一文のみです。

WayVNC is a VNC server that works with compositors, like Sway, based on the wlroots library.

これにならい、Wayland - WayVNC - Sway の採用を進めることにしました。

以下の環境変数を/.env ファイルに記述して設定できます。

EXTENSIONS=/workspaces/development/extensions/

直下のディレクトリを Blender Extensions のパーッケージとします。

/.devconatiner/devcontainer.json において、次の部分を手動で書き換える必要があります。

{
    "workspaceFolder": "/workspaces/development/extensions/${localWorkspaceFolderBasename}",
    "initializeCommand": "mkdir -p extensions/${localWorkspaceFolderBasename}",
}

REPOSITORY=/workspaces/development/repository/

Blender Extension のリポジトリとして利用するディレクトリです。

• エラー対応
• GPU 対応
• MCP サーバー統合
• 共同作業モデル改善

• GPU 不足によるエラー。
• WLR_RENDERER=pixman により、エラーは出なくなる。

• WayVNC と Sway の互換性に依るエラー。
• GPU 不足に関連する可能性あり。

• GPU 不足に関するエラー。

• GPU 不足に関するエラー。

• GPU 不足に関するエラー。

• GPU 不足に関するエラー。

• GPU 不足に関するエラー。

©令和7年 株式会社 Peakys

プライバシーポリシー