0.1.2 • Public • Published

Blender Addon Registry

Manage addons the easy way!




  1. Download the file
  2. In Blender, go to File > User preferences... (Ctrl + Alt + U)
  3. Click on Addons at the top
  4. Click on Install from File... at the bottom
  5. Select the file you have just downloaded and click on Install from File... at the upper right corner
  6. Enable the addon by ticking the rightmost box

The addon registry now appears below the regular addon panel. Just scroll down!

Root certificates

Python in Blender does not ship with root certificates, which is unfortunate because the registry is served over HTTPS. Without these certificates, connection errors will show up.

  1. Download the cacerts from
  2. Rename the file to cacert.pem and move it into Blender installation path /VERSION/python/lib/site-packages/requests

No need to restart Blender.


The panel is very similar to the regular addon panel. It displays addons and their information that are recorded in the registry.

The button WORLD version displays the latest version available, if the addon is not installed or is not up-to-date. Click on it to download and install the addon.

The button CANCEL version displays the installed version available, if any. Click on it to remove the addon.

Addons may be bundled together in the same archive file, i.e. they will be installed together. In this case, the icon LINK_AREA appears, and the bundled addons are shown when you expand the addon box.

Once installed, the addons appear in the regular addon panel as well. They can be enabled or disabled from both panels.

On the lower right corner, the button FILE_REFRESH Update addons from registry updates the addon database, then updates all addons that have a newer available version.

Installation directory

Addons are installed in scripts/addons_extern, meaning that they will appear in the category MOD_EXPLODE Testing. This is to remind you that they may harm your computer.

Updating an addon which was installed in scripts/addons or scripts/addons_contrib also moves it to scripts/addons_extern.

  • Windows 7: C:\Users\USERNAME\AppData\Roaming\Blender Foundation\Blender\VERSION\scripts\addons_extern
  • Windows XP: C:\Documents and Settings\USERNAME\Application Data\Blender Foundation\Blender\VERSION\scripts\addons_extern
  • Mac OS X: /Applications/
  • Linux: /home/USERNAME/.config/blender/VERSION/scripts/addons_extern


By default, only the zip archives can be extracted. By installing 7-Zip or one of its ports, all common formats are recognized.


  1. Download and install 7-Zip:
  2. Add 7-Zip's installation path to your PATH:

Mac OS X

Not tested, please send me feedback!

  1. Download and install Keka 1.0.5:
  2. Add an alias 7z="/Applications/" by following this guide:


Not tested, please send me feedback!

Chances are that p7zip is available in your package manager. Otherwise:

  1. Download and install p7zip:
  2. You use Linux, you don't need any installation advice

Publishing addons to the registry

If you want to add, update, or remove an addon on the registry, or for anything else, please create an issue.

This project is experimental. Maybe one day, the Blender team will integrate this into their main branch and free Blender users from years of using an outdated addon system. Therefore, I haven't bother to make a real publication system with a web interface. When they will integrate it, we'll discuss about such a system.

The addon database is actually a regular file served from GitHub, that I handle with a custom CLI tool explained below.

Private registry

You may want to create a private registry, for instance inside your company to serve private addons. You can!

Blender side

The addon tries to load the configuration file .addon_registry from the scripts/addons directory (not scripts/addons_extern). This is a regular JSON file. The default value is at the bottom of

It is not recommended to edit as it can be updated as well.

Bundle and .addon_registry together into a zip file that you will give to your colleagues. They have to install this zip using the procedure described at the top of this document. They will then have access to your private registry.

Registry side

git clone
cd blender-addon-registry

The database is a regular JSON file. Its URL or file path (e.g. network drive) is given in .addon_registry.

CLI commands manage the database. The tool is written in Node.js, so you need to install it.

If you are behind a corporate proxy, you will have to configure the proxies. Set the environment variables HTTP_PROXY and HTTPS_PROXY, and configure npm:

npm config set proxy
npm config set https-proxy

Then installed the dependencies:

npm install

The tool is called with node . command args.... You can:

add url|path ...
remove name ...

The Node.js module exports the corresponding functions, although I don't know why you would use it:

exports.add(url, [options], callback)
exports.list([options], callback)
exports.remove(name, [options], callback)


Copyright (c) 2014 Bloutiouf aka Jonathan Giroux

MIT licence



Package Sidebar


npm i blender-addon-registry

Weekly Downloads






Last publish


  • bloutiouf