1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
.. _bpy.types.Addon:
.. _bpy.ops.wm.addon:
.. _bpy.types.WindowManager.addon:
.. _bpy.ops.preferences.addon:
.. _prefs-extensions:
**************
Get Extensions
**************
The *Get Extensions* section lets you install and manage extensions preferences.
.. figure:: /images/editors_preferences_section_extensions.png
Blender Preferences Extensions section.
.. seealso::
To learn about extensions and how to create them, refer to the :ref:`Extensions <extensions-index>` page.
.. _prefs-extensions-install:
Installing Extensions
=====================
There are different ways to install an extension:
Install from the Website
Drag the installation URL into Blender.
Install from Blender
Search for the extension name and click on Install.
:ref:`Install from Disk <bpy.ops.extensions.package_install_files>`
Use the drop-down menu in the top right,
or drag-and-drop an extension ``.zip`` package into Blender.
.. note::
Any installed extension can be removed. This is a permanent change, though.
To stop an extension temporarily, it is better to Disable it instead.
Updating Extensions
===================
You need to manually check for available updates.
Once an update is found, Blender will let you update any of the available extensions.
The current available version of an extension on the repository will always be considered the latest version.
Enable/Disable
==============
Once an extension is installed it can be disabled (or re-enabled) as part of the user preferences.
Some extension types do not support this, and will always be shown as enabled.
.. tip::
If the Add-on does not activate when enabled,
check the :doc:`Console window </advanced/command_line/index>`
for any errors that may have occurred.
Extension Settings
==================
Visit Extensions Platform
Opens `extensions.blender.org <https://extensions.blender.org/>` in a web browser.
.. _bpy.ops.extensions.repo_sync_all:
Refresh Remote
Manually check the online repositories for available updates.
.. _bpy.ops.extensions.repo_refresh_all:
Refresh Local
Scan extension & legacy add-ons for changes to modules & meta-data
(similar to restarting). Any issues are reported as warnings
.. _bpy.ops.extensions.package_upgrade_all:
Install Available Updates
Update all the extensions that have an update available.
.. _bpy.ops.extensions.package_install_files:
Install from Disk
Install an extension from a ``.zip`` package.
This is installed to a Local Repository and no updates will be available.
This can also be used to install legacy Add-ons, for more information see:
:ref:`prefs-extensions-install_legacy_addon`.
.. _bpy.types.WindowManager.extension_type:
Filter by Type
==============
Or show only extensions of a single type:
:Add-ons: Only show add-ons.
:Themes: Only show themes.
Repositories
============
By default Blender has a Remote Repository pointing towards the
`Official Blender Extensions Platform <https://extensions.blender.org>`__ and two Local Repositories.
In the cases where more repositories are needed (e.g., to access third party extension platforms),
new repositories can be added.
.. figure:: /images/editor_preferences_section_extensions_repositories.png
:width: 450px
Repositories.
To add new repositories click on the :menuselection:`+` icon:
Add Remote Repository
Add a repository from a URL.
Add Local Repository
Add a repository which will be managed by the user (to be used with Install from Disk).
To remove repositories click on the :menuselection:`-` icon:
Remove Repository
Remove an extension repository.
Remove Repository & Files
Remove a repository and delete all associated files when removing.
These changes are permanent and cannot be reversed.
Remote Repository
-----------------
Remote repository with support for listing and updating extensions.
Options:
Check for Updates on Startup
Allows Blender to check for updates upon launch.
When updates are available a notification will be visible on the status bar.
Access Token
Personal access token, may be required by some repositories.
Local Repository
----------------
A repository managed manually by the users.
There are two types of local repositories. By default new local repositories are added as User repositories.
This is what you want most of the time.
After creating a repository they can be changed in the Advanced options to have a source System.
These repositories are intended to :ref:`bundle extensions <deploying-blender-bundling>`
with Blender, to make it portable.
|
