📘 EZnormal – Documentation

EZnormal is a Blender add-on that uses AI to generate high-quality normal maps from any image with just one click. It's designed to simplify and accelerate your workflow — no baking, sculpting, or third-party software required.

🛠️ Installation

1. Download the .zip file provided after purchase.

2. In Blender, go to: Edit > Preferences > Add-ons.

3. Click Install, then select the downloaded .zip file.

4. Enable the checkbox next to EZnormal to activate the add-on.

5. You’ll now find it under the N-tab in the EZnormal panel.

📷 How to Use

1. Select a .jpg or .png image using the “Image Path” field.

2. (Optional) Enable Invert Y Channel if your normal maps appear flipped.

3. Click Generate Normal Map.

4. The add-on will:

   • Run the AI model (offline)

   • Save the normal map next to your image

   • Load the result and apply it to the selected object’s material

5. View previews of the original image and generated normal map side-by-side.

🔁 Recent Image History

EZnormal stores up to 5 recent images. Select one from the list and click Generate From Recent to reuse it instantly.

🧾 Extras

At the bottom of the panel, you’ll find:

• Open README — Usage overview

• Open LICENSE — View GPLv3 license terms

🧠 Tips & Notes

• Works offline with a bundled .exe and ONNX AI model.

• Supports only Windows (for now) due to .exe dependency.

• Invert Y Channel uses negative normal node strength.

• Output normal map is saved automatically in the same folder as your input image.

❓ Troubleshooting

• If the “Generate” button fails, make sure:

  • You selected a valid .jpg or .png image

  • The addon folder includes the eznormal_runner.exe and eznormal256.onnx files

• If Blender can’t preview the image: clear previews, or restart Blender.