A convenient gathering of useful and well-developed FreeCAD plugins made by the community.
This repository is a collection of useful additional workbenches and modules for FreeCAD made by its community members, conveniently available for seamless integration in to the application itself.
Important Notes:
Since these Addons are not part of the official FreeCAD package and not supported by the FreeCAD team, although this list is curated and maintained by the FreeCAD team, you should read the information provided on each of the addons page before installing any of them, to make sure you know what you are installing.
Bug reports and feature requests should be made directly on each addon page. Any reports opened in this repository should be related directly to the Addon Manager itself.
The commit number indicated in the github tree above is not considered by the Addons Manager. What is installed or updated is always the latest HEAD of the specified branch of each addon. If no branch is specified in the .gitmodules file, "master" is assumed.
For a description of each Addon you can either:
Important Note: As of FreeCAD v0.17.9940 the Addon Manager was finally implemented in to FreeCAD. It can be accessed from within the Tools → 'Addon Manager' dropdown menu. For earlier versions (≤v0.16), please see the Deprecated Installation Methods section.
The recommended way is using the built-in Addon Manager that installs 3rd party workbenches, addons, and macros. Access it via Tools → Addon Manager:
For any reason the first option is not available, then manual installation is always possible. Github provides users to 'Clone or download' each of the addons listed in this repository. They can be downloaded by:
git clone <github repository URL>
FreeCAD/Mod
folder, or in the Macros folder. Refer to the instructions on each addon page.Note: Your user's FreeCAD folder location is obtained by typing in FreeCAD's python console: FreeCAD.ConfigGet("UserAppData")
while the Macros folder location is indicated in the dialog opened from Macro -> Macros... dropdown menu.
Have you made an interesting workbench or module that we are not aware of? Tell us on the FreeCAD forum so we can add it here!
To submit your workbench to the repository
[[Category:Addons]]
to it) + add it to https://freecadweb.org/wiki/External_workbenches
freecad
, addons
, and workbench
package.xml
metadata file, and that that file includes an icon, repository url, and readme url. The readme url should be a direct link to the HTML-rendered README.md file (e.g. https://github.com/shaise/FreeCAD_SheetMetal/blob/master/README.md).gitmodules
file. Supported git hosts are GitHub, Gitlab, Framagit, salsa.debian.org, and Codeberg.For wider usage of external workbenches, we recommend that workbench developers integrate the ability to translate their workbench(es). FreeCAD uses a 3rd-party crowdsource translation service called Crowdin. There are some automated scripts that we use to push and pull translations from Crowdin via their API. Developers are invited to help improve these scripts so as to include their own workbenches in the process. Further discussion on this forum thread.
Source code for the Addon Manager lives in FreeCAD master FreeCAD/src/Mod/AddonManager/
.
The installer macro can be launched from inside FreeCAD, and will download and install any of the addons above automatically. To install the installer macro:
The plugin loader is a much more elaborate way to install and manage additional content for freecad. Install it with the method above, or following the instructions on the pluginloader page.