Skip to content

Blender Extension Setup

Installation Steps

Download from release

  1. Pick a release
  2. From the Github repository, select a release version
  3. Locate the ext.zip file and download it

  4. Install in Blender

  5. Open Blender (4.5+ required for the extension)
  6. Go to Edit → Preferences → Get Extensions
  7. Click the (three dots) in top-right → Install from Disk
  8. Select your .zip file
  9. Enable the extension by toggling the checkbox

  10. Access the extension

  11. Find it in the 3D Viewport sidebar (N key)
  12. Or check the location specified in the extension's documentation

Download latest branch from repository

  1. Download the extension
  2. Clone or download this repository (https://github.com/lorenzozanizz/synth-blender-dataset)
  3. Locate the /ext/ folder in the repo

  4. Create a ZIP archive

  5. Compress the contents of the /ext/ folder as a .zip file
  6. ⚠️ Important: The zip should contain the extension files directly, NOT a folder named "ext". Blender requires the extension to be packed into a zip containing the source code directly.
  7. Correct structure: extension.zip > __init__.py, etc.
  8. Wrong structure: extension.zip > ext/ → files

  9. Install in Blender

  10. Open Blender (4.5+ required for the extension)
  11. Go to Edit → Preferences → Get Extensions
  12. Click the (three dots) in top-right → Install from Disk
  13. Select your .zip file
  14. Enable the extension by toggling the checkbox

  15. Access the extension

  16. Find it in the 3D Viewport sidebar (N key)
  17. Or check the location specified in the extension's documentation

Requirements

  • Blender: 4.5.0 or later

Troubleshooting

  • "Not a valid extension": Make sure the zip contains files directly, not an ext/ folder
  • Extension doesn't appear: Check Edit > Preferences > Extensions and verify it's enabled
  • Errors on enable: Check the Blender System Console