Installation / Blender
- Prerequisites
- Downloading Verge3D
- Installation for Windows
- Installation for macOS or Linux
- Troubleshooting
Prerequisites
Verge3D can run on top of Blender, an open source 3D modeling and animation suite, which should be installed first (we support versions 2.91-4.0). You can download Blender for free from the official website.
Downloading Verge3D
Download Verge3D for Blender for your operating system (.exe installer for Windows, or XZ archive for macOS or Linux).
Installation for Windows
Double click on the .exe file to run the installer.

Follow the link to read the recent version of Verge3D license agreement.

Choose components you want to install.

Now choose an installation folder that have enough permissions for reading and writing (or better leave it by default).

Wait until the installer finishes copying files to the target directory.

Once installation complete you'll see the following screen.

Press finish and launch Blender. If you had it running, be sure to close and open it again.
Open the Preferences window and go to the Add-ons tab. Find and enable the Verge3D addon, then close the window.

You may also launch the App Manager without running Blender by clicking on the desktop icon or using the Start menu.

Installation for macOS or Linux
Unpack the XZ archive to a directory of your choice. Make sure you have enough permissions to read/write in this folder. Installing in a system directory is not recommended.
In Blender, invoke the Preferences window by selecting the corresponding option in the Edit menu.

On the File Paths tab, find the Script Directories panel. There click on the Add (or +) button to add the folder in which Verge3D is installed. Close the Preferences window and restart Blender.

Open the Preferences window again and go to the Add-ons tab. Find and enable the Verge3D addon, then close the window.

Installation complete!
Troubleshooting
ModuleNotFoundError: No module named 'numpy'
When on Linux, you might see the following error upon Verge3D activation, saying that there is no module named numpy:

If you see it, install numpy with your system package manager, e.g. on Ubuntu:
sudo apt install python3-numpy
Then try activating the Verge3D add-on again.
What's Next
Familiarize yourself with the basics!
Got Questions?
Feel free to ask on the forums!