AddonManager

The Addon Manager is a tool to install and manage external workbenches and macros provided by the FreeCAD community.

The lists of installable workbenches and macros are taken from two repositories, FreeCAD-addons and FreeCAD-macros, respectively. Many of the macros in the Macros recipes are in that repository.



How to use

 * Open the tool in the menu.
 * To install a workbench: scroll through the list and select the add-on; a short description, as well as its home page, will be displayed below the list. Press the button to install the new tool. For macros, click on the  tab and repeat the steps.
 * To remove a workbench or a macro: scroll through the list, select the add-on, and then press the button.
 * To update a workbench or a macro: scroll through the list, select the add-on, and then press the button.
 * To check for updates: press the button; available updates will be reported below the list. Press the  button again to install all updates at once.  the icon may look different depending on your operating system.
 * To run a macro: first install the desired macro, then select it again on the list, and then press the button.
 * Press to exit the manager.

Manual installation
If you don't use the Addon Manager, you can install the new tools manually by placing their code in your user's directory. See the following links for details:
 * How to install macros
 * How to install additional workbenches

Limitations

 * These add-ons are not part of the official FreeCAD program and are not supported by the core FreeCAD team. You should read the information provided on each add-on page to make sure you know what you are installing.


 * Bug reports and feature requests should be made directly on each add-on page, or with the creator of the add-on in the FreeCAD forum.

New workbenches and macros
If you developed a workbench or macro, and want to see it included in the Addon Manager, read the process that you must follow in the repository pages (FreeCAD-addons and FreeCAD-macros).

Basically, you must present your new tools to the community in the FreeCAD forum for review. Once your code has been tested and approved, you should fork the specific repository, create a new branch, push your code to it, and open a pull request so that your branch is merged into the main repository.