-
Notifications
You must be signed in to change notification settings - Fork 344
Description
The following guide provides the installation instruction for installing Animation Nodes and the troubleshooting guide to troubleshoot your installation.
How to install Animation Nodes?
- Disable then uninstall any version of Animation Nodes already installed.
- Download a build of Animation Nodes from the Animation Nodes website.
- Go to User Preferences -> Add-ons.
- Press install and choose the build you downloaded.
Animation Nodes should now be installed and can be enabled. If you encounter any errors or unexpected behavior during the installation process, read the troubleshooting section below.
Troubleshooting
If an installation error occurred, Animation Nodes should show an error message with a description of the issue that occurred. Below, we present a number of issues the could occur and the procedure to fix them.
Can't find Animation Nodes in the add-ons list
The installed Animation Nodes build is corrupted. First delete the animation_nodes folder from the add-ons directories. See Appendix I. Then follow the installation instructions above.
There are multiple versions of Animation Nodes installed
Multiple version of Animation Nodes can't coexist. To fix this, remove all versions of Animation Nodes. You may need to manually remove the animation_nodes folder from the add-ons directories. See Appendix I. Then follow the installation instructions above.
Import Error: DLL load failed
Install vc_redist.x64 from microsoft's support center.
libpython3.x : Can't Open Shared Object File
Animation Nodes needs the python dynamic library in order to work. Install python3.x or/and libpython3.x from your package manager of choice.
Ubuntu
Ubuntu users may install libpython3.x from the deadsnakes PPA using the following commands. (Making sure to replace x with the target version.)
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update -y && sudo apt upgrade
sudo apt install libpython3.xThis build does not work at the moment
This could be caused due to a number of issue:
- The build you are using was not built for the platform you are using. Download and install an appropriate build as described above.
- You don't have the
vc_redist.x64library. See the section about "Import Error: DLL load failed" above. - You don't have the python shared libraries. See the section about "libpython3.x : Can't Open Shared Object File" above.
Animation Nodes depends on Numpy
Animation Nodes needs the numpy python module to operate. Install numpy to your python environment through your package manager or through other means. Official Blender builds have numpy installed by default, so you may also use the latest official Blender build to avoid the issue.
Animation Nodes needs at least Blender 2.80
The latest version of Animation Nodes only works with Blender 2.80. Install a newer Blender build.
Animation Nodes is built for another OS
An Animation Nodes build is built for a certain platform and will only work on this platform. Download an Animation Nodes build that is built for your platform.
There is a python version mismatch
An Animation Nodes build is built for a certain python version and will only work on this python version. The official Animation Nodes builds provided are built against the python version used by the official Blender builds. If your Blender build uses a different version, you will have to use a custom Animation Nodes build or build Animation Nodes yourself. Notice that Animation Nodes exists in the AUR for Arch users.
This is just the source code of Animation Nodes
The installed Animation Nodes build is corrupted. First delete the animation_nodes folder from the add-ons directories. See Appendix I. Then follow the installation instructions above.
Still can't install Animation Nodes
If you still can't install Animation Nodes, add a comment to this issue detailing the issue you are having and we will help you resolve your issue.
Appendix I
It is sometimes necessary to delete Animation Nodes from the file system yourself by deleting the animation_nodes folder in the add-ons directories. There are many directories in which add-ons can be installed, you have to go through all of them and remove the animation_nodes folder. The directories at listed in the Blender documentation.