https://github.com/scarlettstudios/planetopbr

PlaneToPBR — A free Blender extension that generates a fully textured PBR plane from a single image in one click, automatically creating diffuse, normal, roughness, depth, and segmentation maps using AI models.
https://github.com/scarlettstudios/planetopbr

3d ai-tools blender blender-addon blender-extension pbr pbr-textures

Last synced: 4 months ago
JSON representation

PlaneToPBR — A free Blender extension that generates a fully textured PBR plane from a single image in one click, automatically creating diffuse, normal, roughness, depth, and segmentation maps using AI models.

• Host: GitHub
• URL: https://github.com/scarlettstudios/planetopbr
• Owner: ScarlettStudios
• License: gpl-3.0
• Created: 2026-02-21T15:38:26.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2026-03-28T00:49:09.000Z (4 months ago)
• Last Synced: 2026-03-28T05:12:42.604Z (4 months ago)
• Topics: 3d, ai-tools, blender, blender-addon, blender-extension, pbr, pbr-textures
• Language: Python
• Homepage:
• Size: 105 MB
• Stars: 10
• Watchers: 0
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# PlaneToPBR — One-Click PBR Plane Generator for Blender

![Blender](https://img.shields.io/badge/Blender-4.2%2B-orange)

![License](https://img.shields.io/badge/License-GPL--3.0-blue)

![Status](https://img.shields.io/badge/status-active-success)

![Release](https://img.shields.io/github/v/release/ScarlettStudios/PlaneToPBR)

![PlaneToPBR Demo](assets/PlanetoPBR.gif)

PlaneToPBR is a free Blender extension that generates a **fully textured PBR plane from a single image in one click**.

Watch the full demo video here:

https://youtu.be/AtydKv722z8

The extension automatically generates and applies:

- Diffuse

- Normal

- Roughness

- Depth

- Prompt-based segmentation mask

This allows artists to quickly convert reference images into usable **3D textured geometry**.

Compatible with Blender 4.2 and newer.

---

## Installation

1. Open **Blender**

2. Go to **Edit → Preferences**

![Preferences](assets/extention.png)

3. Click **Get Extensions**

4. Open the dropdown menu and select **Install from Disk**

![Install from Disk](assets/installDisk.png)

5. Select the `PlaneToPBR.zip` file

![Select Zip](assets/installZip.png)

6. Enable the extension after installation.

---

## Using PlaneToPBR

After installing, open the **PlaneToPBR panel** in the 3D viewport sidebar.

![Panel Location](assets/panel.png)

---

## UI Location

The panel is located in the **3D viewport sidebar**.

![UI Location](assets/ui.png)

---

### Step 1 — Enter Prompt

Optionally enter a prompt to guide the AI segmentation.

![Prompt Field](assets/prompt.png)

Example:

```

Windows

```

---

### Step 2 — Select Image

Click the file browser button and select your source image.

![File Browser](assets/selectFile.png)

Then choose the image file.

![Select Image](assets/file.png)

---

### Step 3 — Generate PBR Plane

Click **Generate PBR Plane**.

![Generate Button](assets/generate.png)

The add-on will:

1. Send the image to the AI pipeline  

2. Generate PBR maps  

3. Create a correctly scaled plane  

4. Build the material automatically  

---

## Generated Shader

The extension automatically builds a full **PBR shader network**.

![Shader Graph](assets/shaders.png)

---

## Geometry Setup

For best depth results, adjust modifiers:

- Subdivision

- Displacement

Example settings:

![Modifier Settings](assets/modifier.png)

---

## Network Usage

PlaneToPBR sends the selected image to a remote AI inference service hosted on Hugging Face in order to generate PBR texture maps.

Only the image selected by the user is transmitted.  

No Blender project data or personal information is collected or stored.

---

## AI Models

PlaneToPBR relies on several open-source AI models:

| Model | Purpose | Repository |

|------|------|------|

| **CLIPSeg** | Text-guided segmentation (mask generation) | https://github.com/timojl/clipseg |

| **DeepBump** | Normal & roughness map generation | https://github.com/HugoTini/DeepBump |

| **MiDaS** | Depth estimation | https://github.com/isl-org/MiDaS |

## License

GPL-3.0-or-later