Installation

How to Install?

  1. Uninstall any old version of Animation Nodes. Having it installed multiple times for the same version causes conflicts.
  2. Download a recent build for your operating system from the release page. If no build suits you, you will have to compile it yourself (see Developer Guide) or contact the developer.
  3. Open Blender (preferably the newest version).
  4. Go to the User Preferences in the Addon tab.
  5. Click Install from File and choose the zip file you downloaded.
  6. Activate the add-on and you are done.

You can now find the Animation-Nodes editor in the node editor.

../../_images/animation_node_editor.png

Note

Checkout the troubleshooting section below if you have any installation problems.

How to Uninstall?

  1. Disable the addon and save the user preferences.
  2. Restart Blender and remove Animation Nodes.

Important

Animation Nodes must not be active in the session in which it will be removed. This is because some files cannot be removed once they are loaded. This usually is not a problem with other addons because they don’t use Cython—A technology Animation Nodes is built on.

Troubleshooting

If Animation Nodes failed to start, it should show an error message. Please read it, it often contains information on what the issue is.

../../_images/error_message.png

Some of this issues include:

  • Animation Nodes may depend on features that only exist in recent versions of Blender, in that case, make sure to update your Blender version. Using experimental Blender builds is not recommended as it might accompany changes that the developer is not aware of.
  • Animation Nodes builds are specific to operating systems, for instance, windows builds will not operate on linux systems, so, make sure that you have downloaded a build specific to your operating system (Linux, Windows, macOS). It should be noted that Linux builds does not seem to work on every linux distribution, an issue that we haven’t been able to solve yet. Therefor, we provide multiple Linux builds that you can try.
  • Windows users may encounter errors due to missing runtimes, in that case, try installing Visual C++ Redistributable Package.
  • Animation Nodes builds are specific to python versions, that is, they only operates on a system with python version identical to that it was compiled with. Builds are compiled with the same python version used in the latest official Blender version. If one wanted to use a different python version, one will have to compile Animation Nodes oneself (see Developer Guide).
  • Animation Nodes depends on numpy, a python module that is included with official Blender builds. If you have downloaded an unofficial Blender version (for instance, from a package manager), it is possible that numpy will not be included in the build, and this should be clear from the error message. In that case, you can either download a Blender build that include numpy (preferably an official one) or install numpy yourself through a package manager or manually.

If you still haven’t managed to install Animation Nodes, you have two options:

  1. Open a new issue on Github and ask for help. Please provide the relevant data about your system (OS, Python version, Blender version, error messages, …).
  2. Compile Animation Nodes yourself (see Developer Guide).