BrendanParmer / NodeToPython

Convert Blender node groups to a Python add-on
MIT License
213 stars 19 forks source link
add-on art blender blender-addon blender-python blender-script geometry-nodes geonodes material node-editor node-to-python procedural procedural-art python

Node to Python

Node To Python Logo

GitHub release (latest by date) GitHub

About

A Blender add-on to create scripts and add-ons! This add-on will take your Geometry Nodes, Materials, and Compositing nodes and convert them into legible Python code.

Node To Python automatically handles node layout, default values, subgroups, naming, colors, and more!

Blender's node-based editors are powerful, yet accessible tools, and I wanted to make scripting them easier for add-on creators. Combining Python with node based setups allows you to do things that would otherwise be tedious or impossible, such as

Supported Versions

NodeToPython v3.1 is supported for Blender 3.0 - 4.1 on Windows, macOS, and Linux.

Installation

  1. Download the NodeToPython.zip file from the latest release
    • If you download other options, you'll need to rename the zip and the first folder to "NodeToPython" so Blender can properly import the add-on
  2. In Blender, navigate to Edit > Preferences > Add-ons
  3. Click Install, and find where you downloaded the zip file. Then hit the Install Add-on button, and you're done!

Usage

Once you've installed the add-on, you'll see a new tab in any Node Editor's sidebar. You can open this with keyboard shortcut N when focused in the Node Editor.

In the tab, there's panels to create add-ons for Geometry Nodes and Materials, each with a drop-down menu.

Add-on Location

Select the node group you want code for, and you'll be prompted with a Script or Add-on option.

Bug Reports and Suggestions

When submitting an issue, please include

Got suggestions? Please create an issue! I'm happy to hear what features people want