6
$\begingroup$

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?

$\endgroup$
6
$\begingroup$

Option 1 - Release version

Before downloading the entire repository using the 'Clone or download' button, make sure there 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

$\endgroup$

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.