BlenderExec

BlenderExec for VS Code
Supercharge your Blender Python development with IntelliSense, hot-reload, and seamless script execution.

BlenderExec provides syntax highlighting, snippets, and full auto-completion powered by Blender Python API stubs (from fake-bpy-module) — plus commands for sending scripts directly to a running Blender instance.

Get it on the VS Code Marketplace

---

Features

• Bundled Blender API Stubs
  Provides IntelliSense, type hints, and docstrings for Blender’s Python API.
  (Stubs are generated using fake-bpy-module.)

• Auto-Enable IntelliSense
  Automatically injects the Blender API stub path into python.analysis.extraPaths when opening a Python file in a workspace.

• Manual Command Support
  Enable Blender IntelliSense on demand via BlenderExec: Enable Blender API IntelliSense.

• Direct Script Execution
  Send your Python scripts or selections from VS Code directly to a running Blender instance.

• Hot-Reloadable Development
  Instantly test scripts in Blender without restarting, perfect for fast iteration.

---

Commands

Command	Description
BlenderExec: Select Blender Instance	Select a running Blender instance to target for script execution
BlenderExec: Send Full File to Blender	Sends the current .py file to Blender for execution
BlenderExec: Send Selection to Blender	Sends only the currently selected code to Blender
BlenderExec: Enable Blender API IntelliSense	Injects the Blender API stub path into workspace settings

Keybindings

Keybinding	Action
Ctrl+Alt+E	Select Blender Instance
Ctrl+Shift+E	Send Full File to Blender
Ctrl+Shift+S	Send Selection to Blender
Ctrl+Alt+Shift+B	Enable Blender API IntelliSense

---

Workflow

0. Install Blender Addon (Required)

Before using script execution features, install the BlenderExec Bridge addon in Blender:

1. Download: BlenderExec.Bridge.Addon.zip
2. In Blender: Edit → Preferences → Add-ons → Install... → Select the zip → Enable addon

1. Enable Blender IntelliSense

Run BlenderExec: Enable Blender API IntelliSense (Ctrl+Alt+Shift+B).
This injects the bundled Blender stubs into VS Code, providing full autocomplete and type hints.

Works only inside a workspace folder.

2. Select Blender Instance

Run BlenderExec: Select Blender Instance (Ctrl+Alt+E) to choose which Blender process will receive scripts.

3. Send Python Scripts

• Full File: BlenderExec: Send Full File to Blender (Ctrl+Shift+E)
• Selection Only: BlenderExec: Send Selection to Blender (Ctrl+Shift+S)

Scripts execute immediately inside Blender.

---

How It Works

1. Stub Path Injection – Injects bundled stubs into python.analysis.extraPaths.
2. Instance Management – Detects running Blender instances and lets you pick one.
3. Script Execution – Sends the full file or selection to Blender via a TCP/IPC connection.

---

Requirements

• Blender installed (any recent version supported by fake-bpy-module)
• VS Code 1.60.0+
• Python extension (Pylance) for IntelliSense
• BlenderExec Bridge Addon installed in Blender

---

Troubleshooting

• No IntelliSense: Ensure your workspace is a folder.
• Wrong stub path: Run BlenderExec: Enable Blender API IntelliSense.
• Scripts not executing: Ensure you have selected a running Blender instance.

---

Acknowledgments

Thanks to:

• Blender Foundation for Blender
• nutti/fake-bpy-module for the Blender API stubs

---

Icon