I have downloaded an add-on hosted on github today using this green 'Download/Clone' button. However, when I try to install it via User Preferences > Addons > Install it does not appear in the Add-on list, no matter what I do. enter image description here

Q: How to download and install add-ons hosted on github properly? What am I doing wrong?


Option 1 - Release version

Before downloading the entire repository using the 'Clone or download' button, make sure there is no actual release (In most cases there is, to keep development organized):

enter image description here

If so, click on Releases Tab and download the latest release (zip or single py file):

enter image description here

Option 2 - init.py folder (Clone or download)

There are lazy authors so in some rare cases the 'Clone or download' is the only option. Search for __init__.py in the repository and copy the folder containing this file to your Add-on directory:

  • Linux: $HOME/.config/blender/<version>/
  • OSX: /Library/Application Support/Blender/<version>/
  • Windows: %USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\<version>\

You can get also get the folder per machine using the python console: bpy.utils.script_path_user() and / or bpy.utils.script_paths("addons")

Further reading: Addons: Only some .zips will install

  • 1
    $\begingroup$ You literally saved my ass, I spent 4 hours trying to debug this, turns out I was just being a moron. $\endgroup$
    – Joehot200
    Feb 21 at 11:03

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.