🇺🇸 English
It appears by itself when a render starts, shows progress and ETA, warns you if the render stalls, and disappears on its own when the job ends. Handy when you drive Blender headlessly (e.g. via Claude Code / MCP) and never look at the Blender window.
Finish-time estimate— predicts the remaining time and shows~00:00 est. finish
.ETA— when there isn't enough data yet, or frame times are erratic, it saysmeasuring…
,00:00 approx.
orfinishing soon
.Stall detection— warns "no response" once progress stops, and detects when Blender has crashed.** Auto-appear, auto-vanish**— shows up when a render starts, disappears when it ends.** Lightweight**— one dependency-free Rust executable (~0.6 MB, a few MB of RAM).
-
Windows 10 / 11
-
Blender 4.2 or newer
-
Download
blenderpulse-x.y.z.zip
fromReleases. - In Blender: Edit → Preferences → Add-ons → ▼ (top-right) → Install from Disk… - Pick the downloaded zip and enable the add-on (tick the checkbox).
The overlay executable is bundled inside the add-on and launches automatically when a render starts.
About SmartScreen:installed through the add-on zip, the exe carries no "Mark of the Web", so no warning normally appears. If you download a bare exe directly and see a warning, chooseMore info → Run anyway.
- Start a render ( F12/** Ctrl+F12**) — the overlay appears at the bottom-right. - It shows a progress bar, frame counter, and estimated finish time.
- On completion it shows ✓ Done for a few seconds, then fades out.
Controls (only while Ctrl is held):
| Action | Result |
|---|---|
| Ctrl + left click | |
| Open the output folder in Explorer | |
| Ctrl + drag | |
| Move the overlay (position is remembered) | |
| Ctrl + right click | |
| Open the menu (Settings / Close) |
Settings — open the Ctrl + right-click menu → Settings… to change theme, accent color, size, and language from a GUI (bundled blenderpulse-settings.exe
). On first launch it opens automatically so you can pick your language. Everything is also editable in %APPDATA%\blenderpulse\config.toml
(example):
theme = "auto" # auto (follow OS) | light | dark
accent = "#6A2FD0" # optional accent-color override
font_scale = 1.0 # overall size, 0.6 .. 2.0
Edits apply live to the running overlay.
Language — the default is English. To change it, use the settings window, set the BLENDERPULSE_LANG
env var to en
/ ja
/ auto
, or write en
/ ja
/ auto
into %APPDATA%\blenderpulse\lang.txt
(applied live).
Requires Rust.
cargo build --release --package blenderpulse-overlay
pwsh tools/package.ps1
The Blender add-on (Python) writes render progress to %TEMP%\blenderpulse\state.json
and launches the overlay. The overlay (Rust) watches that file and draws the UI.
Bug reports and feature requests are very welcome — please open an issue. Details that help: your Blender version, what you rendered, and what the overlay did (or didn't do).
Development happens in a separate repository, and this one is published as a release snapshot, so please open an issue before sending a pull request — otherwise the change may be overwritten by the next release.
- Add-on / overlay code:
MIT(seeLICENSE). - Bundled fonts:
Familjen GroteskandDM Mono, under the SIL Open Font License 1.1 (license files ship in the add-on zip and live in
crates/blenderpulse-overlay/assets/fonts/
).
🇯🇵 日本語
レンダリング開始時に自動で表示され、進捗状況と予想残り時間（ETA）を確認できます。レンダリングが停止した場合は警告を表示し、作業完了後は自動的に消えます。Claude Code（MCP経由）などでBlender画面を見ずに作業する際に便利です。
終了時刻の予測— 残り時間を予測して「〜○○:○○ 終了見込み」と表示。** ETA**— データが足りないときや処理が不安定なときは、計測中…
○○:○○頃
まもなく完了
と表示。停滞検知— 進捗が止まると「応答なし」と警告。Blenderが落ちている場合も検知します。自動表示・自動消滅— レンダリング開始で表示され、終わると自動的に消えます。軽量— 依存なしのRust製exe 1つ（約0.6MB・メモリ数MB）。
- Windows 10 / 11
- Blender 4.2 以降
Releasesからblenderpulse-x.y.z.zip
をダウンロード。- Blenderで Edit → Preferences → Add-ons → 右上の▼ → Install from Disk… - ダウンロードしたzipを選択し、有効化（チェックを入れる）。
オーバーレイのexeはアドオンに同梱されており、レンダリング開始時に自動で起動します。
SmartScreenの警告について: アドオンzip経由でインストールした場合、exeには「Mark of the Web」が付かないため通常は警告は出ません。もし単体のexeを直接ダウンロードして警告が出た場合は「詳細情報 → 実行」を選んでください。
- レンダリング開始（ F12/** Ctrl+F12**）で右下に自動的に表示されます。 - 進捗バー・フレーム番号・予測終了時刻が表示されます。
- 完了すると ✓ 完了を数秒表示してフェードアウトします。
操作（Ctrlキーを押している間だけ有効）:
| 操作 | 動作 |
|---|---|
| Ctrl + 左クリック | |
| 出力フォルダをエクスプローラーで開く | |
| Ctrl + ドラッグ | |
| 位置を移動（次回起動時も記憶） | |
| Ctrl + 右クリック | |
| メニュー（設定 / 閉じる）を開く |
設定 — Ctrl + 右クリック → 「設定…」 で、テーマ・アクセント色・サイズ・言語をGUIで変更できます（同梱の blenderpulse-settings.exe
）。初回起動時は自動で開くので、そこで言語を選べます。%APPDATA%\blenderpulse\config.toml
でも編集できます（サンプル）:
theme = "auto" # auto（OS追従） | light | dark
accent = "#6A2FD0" # アクセント色の上書き（省略可）
font_scale = 1.0 # 全体の大きさ 0.6〜2.0
編集すると起動中のオーバーレイに即時反映されます。
言語の切り替え — デフォルトは英語です。変えるには設定画面、環境変数 BLENDERPULSE_LANG
を en
/ ja
/ auto
（OS追従）に設定、または %APPDATA%\blenderpulse\lang.txt
に en
/ ja
/ auto
と記入（実行中の変更も即時反映されます）。
Rust が必要です。
cargo build --release --package blenderpulse-overlay
pwsh tools/package.ps1
Blenderアドオン（Python）がレンダリングの進捗を %TEMP%\blenderpulse\state.json
に書き出し、オーバーレイを起動します。オーバーレイ（Rust）はそのファイルを監視してUIを描画します。
不具合の報告や機能の要望は歓迎します。Issue からお知らせください。Blenderのバージョン、何をレンダリングしたか、オーバーレイがどう動いた（動かなかった）かを書いていただけると助かります。
開発は別のリポジトリで行っており、こちらはリリース断面を公開しているため、プルリクエストを送る前にIssueでご相談ください（次回リリース時に上書きされてしまう可能性があります）。
- アドオン／オーバーレイのコード:
MIT（LICENSE参照）。 - 同梱フォント:
Familjen Grotesk/DM Mono（SIL Open Font License 1.1。ライセンスは配布zipに同梱され、
crates/blenderpulse-overlay/assets/fonts/
にもあります）。