How to install additional workbenches: Difference between revisions

From FreeCAD Documentation
No edit summary
(Marked this version for translation)
(19 intermediate revisions by 9 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:1-->
<!--T:1-->
{{TutorialInfo
{{TutorialInfo|Topic=Programming|Level=Medium programmer|Time=15 minutes|FCVersion=All|Author=[[User:R-Frank|r-frank|Files=none]]}}
|Topic=Programming
|Level=Medium programmer
|Time=15 minutes
|FCVersion=All
|Author=[[User:R-Frank|r-frank]]
|Files=none
}}


==Description== <!--T:2-->
==Description== <!--T:38-->

Power users have extended FreeCAD with various custom external workbenches, that are not integrated into the FreeCAD source code (yet!),
<!--T:2-->
but are easy to install on an existing FreeCAD installation. Here we will cover the installation methods for the different operating systems.
Power users have extended FreeCAD with various custom [[external_workbenches|external workbenches]] that are not integrated into the core source code but are easy to install on an existing FreeCAD distribution. Here we will cover the installation methods for the different operating systems.


<!--T:25-->
<!--T:25-->
'''Note''' Starting from version 0.17, FreeCAD features an addons manager in the Tools menu, that allows to easily install a series of external workbenches. The instructions below are only necessary if you are running an earlier version, or if you want to install a workbench that is not in the list offered by the addons manager.
{{Emphasis|Note:}} starting from version 0.17, FreeCAD features an [[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr|Addon Manager]] in the {{MenuCommand|Tools → Addon Manager}} menu, that allows installing both macros and workbenches. The instructions below are only required if you wish to manually install a workbench. This may be necessary if for some reason the Addon Manager doesn't work but you have access to the workbench downloaded as a {{FileName|.zip}} package.

<!--T:39-->
<div class="mw-collapsible mw-collapsed toccolours">


==Installing on Windows== <!--T:3-->
==Installing on Windows== <!--T:3-->


<!--T:7-->
<!--T:28-->
How to install additional workbenches and addons on Windows
'''Recommended installation method'''
<div class="mw-collapsible-content">

=== Obsolete === <!--T:30-->


<!--T:26-->
<!--T:26-->
{{Emphasis|Note:}} using the "addons-installer" is not recommended any more. Using the [[Addon Manager|Addon Manager]] in all systems is the recommended way.
{{Emphasis|Note:}} using the "addons-installer" is not recommended any more. Using the [[Std_AddonMgr|Addon Manager]] in all systems is the recommended way.


<!--T:8-->
<!--T:8-->
Line 23: Line 38:


<!--T:27-->
<!--T:27-->
During Google Summer of Code 2016 student Mandeep Singh started work on an improved version ([https://github.com/mandeeps708/PluginManager available here]) but that version needs further work before it can be fully integrated in FreeCAD.
During Google Summer of Code 2016 student Mandeep Singh started work on an improved version ([https://github.com/mandeeps708/PluginManager available here]) but that version needs further work before it can be fully integrated in FreeCAD.

=== Manual Install === <!--T:40-->


<!--T:9-->
<!--T:9-->
{{Emphasis|Note:}} This method is possible but not necessary with the introduction of the [[Std_AddonMgr|Addon Manager]]. Nevertheless, the information here may still be useful to some.
'''Alternative installation method “manual install”'''


<!--T:10-->
<!--T:10-->
*download the workbench from github by clicking on the button “clone or download” on the github page (upper right corner) and choosing "Download ZIP"
* Download the workbench from github by clicking on the button {{Button|Clone}} or {{Button|Download}} on the github page (upper right corner) and choosing "Download ZIP"
*unpack the downloaded archive on your local hard disk
* Unpack the downloaded archive on your local hard disk
*within FreeCAD, locate the macro path by choosing “Edit > Preferences > General > Macro” and look for the ”Macro path”
* Within FreeCAD, locate the macro path by choosing {{MenuCommand|Edit Preferences General Macro}} and look for the ”Macro path”
*supposed your Windows-Login is “User-Name” the default macro path is “C:\User-Name\Appdata\Roaming\FreeCAD”
* Supposed your Windows-Login is “''username''” the default macro path is {{FileName|%APPDATA%\FreeCAD\}} which is usually {{FileName|C:\Users\''username''\Appdata\Roaming\FreeCAD}}
*within the macro-directory create (if not already present) a folder called “Mod”
* Within the macro-directory create (if not already present) a folder called “{{FileName|Mod}}”
*within the folder mod create a folder with the name of the workbench, for example “Assembly2”
* Within the Mod folder, create a folder with the name of the workbench, for example “Curves”
*now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
* Now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
*after restart of FreeCAD you should now have an entry in the workbench-pulldown-menu
* After restart of FreeCAD you should now have an entry in the [[Std_Workbench|workbench selector]]


<!--T:23-->
<!--T:23-->
'''Additional Recommendation for upating workbenches'''
'''Additional Recommendation for updating workbenches'''


<!--T:24-->
<!--T:24-->
On windows, when updating an already installed workbench, Windows keeps the old .py files as .pyc. Since this may lead to trouble, it is recommended to uninstall the workbench, restart FreeCAD and install the new version of the workbench.
On windows, when updating an already installed workbench, Windows keeps the old .py files as .pyc. Since this may lead to trouble, it is recommended to uninstall the workbench, restart FreeCAD and install the new version of the workbench.
</translate>
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->
<translate>


<!--T:37-->
<div class="mw-collapsible mw-collapsed toccolours">

==Installing on Linux == <!--T:4-->


<!--T:31-->
==Installing on Linux (Ubuntu/Mint)== <!--T:4-->
How to install additional workbenches and addons on Linux
<div class="mw-collapsible-content">


<!--T:11-->
===Using git=== <!--T:41-->
'''Recommended installation method'''


<!--T:12-->
<!--T:12-->
Adding the [https://launchpad.net/~freecad-community/+archive/ubuntu/ppa community-ppa] within the ppa-manager.<br />
Adding the [https://launchpad.net/~freecad-community/+archive/ubuntu/ppa community-ppa] within the ppa-manager.<br />
Installing the workbenches via synaptic packet manager.
Installing the workbenches via synaptic packet manager.

<!--T:13-->
'''Alternative installation method “Installing via Git”'''


<!--T:14-->
<!--T:14-->
Line 61: Line 86:
$ mkdir ~/.FreeCAD/Mod
$ mkdir ~/.FreeCAD/Mod
$ cd ~/.FreeCAD/Mod
$ cd ~/.FreeCAD/Mod
$ git clone https://github.com/hamish2014/FreeCAD_assembly2.git
$ git clone https://github.com/tomate44/CurvesWB.git
}}
}}


<!--T:15-->
<!--T:15-->
FreeCAD you will now have a new workbench-entry called "Assembly 2". Once installed, use git to upgrade to the latest version through BASH as follows
In FreeCAD you will now have a new workbench-entry called "CurvesWB". Once installed, use git to upgrade to the latest version:


<!--T:16-->
<!--T:16-->
{{Code|code=
{{Code|code=
$ cd ~/.FreeCAD/Mod/FreeCAD_assembly2
$ cd ~/.FreeCAD/Mod/CurvesWB
$ git pull
$ git pull
$ rm *.pyc
$ rm *.pyc
}}
}}

===Manual Installation=== <!--T:42-->


<!--T:17-->
<!--T:17-->
{{Emphasis|Note:}} This method is possible but not necessary with the introduction of the [[Std_AddonMgr|Addon Manager]]. Nevertheless, the information here may still be useful to some.
'''Alternative installation method “manual install”'''


<!--T:18-->
<!--T:18-->
*download the workbench from github by clicking on the button “clone or download” on the github page (upper right corner) and choosing "Download ZIP"
* Download the workbench from github by clicking on the button {{Button|Clone}} or {{Button|Download}} on the github page (upper right corner) and choosing "Download ZIP"
*unpack the downloaded archive on your local hard disk
* Unpack the downloaded archive on your local hard disk
*within FreeCAD, locate the macro path by choosing “Edit > Preferences > General > Macro” and look for the ”Macro path”
* Within FreeCAD, locate the macro path by choosing {{MenuCommand|Edit Preferences General Macro}} and look for the ”Macro path”
*by default, the macro directory is the (hidden) "/.FreeCAD"-directory in your home-directory
* By default, the macro directory is the (hidden) {{MenuCommand|./.FreeCAD/}} directory in your home-directory
*within the macro-directory create (if not already present) a folder called “Mod”
* Within the macro-directory create (if not already present) a folder called “{{FileName|Mod}}”
*within the folder "mod" create a folder with the name of the workbench, for example “Assembly2”
* Within the Mod/ folder, create a folder with the name of the workbench, for example “Curves”
*now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
* Now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
*after restart of FreeCAD you should now have an entry in the workbench-pulldown-menu
* After restart of FreeCAD you should now have an entry in the [[Std_Workbench|workbench selector]]


</translate>
==Installing on Mac== <!--T:5-->
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->
<translate>


<!--T:19-->
'''Recommended installation method'''


<div class="mw-collapsible mw-collapsed toccolours">
==Installing on Mac== <!--T:5-->


<!--T:20-->
<!--T:34-->
How to install additional workbenches and addons on MacOS
'''Alternative installation method “manual install”''' - here a description for the workbench "assembly2"
<div class="mw-collapsible-content">
*download the git repository as ZIP
*assuming FreeCAD is installed in "/Applications/FreeCAD/v0.15", go to "/Applications/FreeCAD/v0.15" in the Browser, and select FreeCAD.app
*right-click and select "Show Package Contents", a new window will appear with a folder named "Contents"
*single-click on the folder "Contents" and select the folder "Mod"
*in the folder "Mod" create a new folder named "assembly2"
*unzip downloaded repository in the folder "Contents/Mod/assembly2"


===Manual Installation=== <!--T:43-->


<!--T:21-->
<!--T:36-->
{{Emphasis|Note:}} This method is possible but not necessary with the introduction of the [[Std_AddonMgr|Addon Manager]]. Nevertheless, the information here may still be useful to some.
Copy or unzip the drawing dimensioning folder to the directory FreeCAD.app/Contents/Mod

where FreeCAD.app is the folder where FreeCAD is installed.
<!--T:20-->
For the sake of this example, say you've chosen the [[Curves Workbench]] as the external workbench you want to install:
* Choose and download the git repository of your chosen external workbench as a ZIP file
* There are two possible locations for your Addon workbench 'Mods':
# All Users: {{FileName|/Applications/FreeCAD.app/Contents/Resources/Mod}}
# Current user only: {{FileName|/Users/myusername/Library/Preferences/FreeCAD/Mod}}
* If you use Finder to navigate manually to the All Users location in Applications you will need to
** go to {{FileName|/Applications}}" and select FreeCAD.app
** right-mouse-click and select "Show Package Contents", a new window will appear with a folder named "Contents"
** single-click on the folder "Contents" then on "Resources" and double-click to open the folder "Mod"
* Once you are in whichever "Mod" folder you want to use, create a New Folder named "Curves"
* Unzip downloaded repository in the folder "Mod/Curves"
</translate>
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->
<translate>


==General troubleshooting== <!--T:6-->
==General troubleshooting== <!--T:6-->


<!--T:22-->
<!--T:22-->
*Don’t use special characters (for example german umlauts) in your windows user name, otherwise FreeCAD will not recognize files and folders in the macro path
* Don't use special characters (for example German umlauts) in your windows user name, otherwise FreeCAD will not recognize files and folders in the macro path.
*If you have already set up a user name with special characters either create a new user name or point the macro path to a directory not using special characters
* If you have already set up a user name with special characters either create a new user name or point the macro path to a directory not using special characters.
*Workbench still not showing up ? In FreeCAD, choose “Tools > Customize > Workbenches” and make sure it is not set to invisible
* Go to {{MenuCommand|Tools Customize Workbenches}} and make sure the workbench is not set to invisible.
*'''Notes for users with 32-bit system and FreeCAD 0.16.6706 '''. After attempts to install, the additional Workbenches may not be available. In this case
* With 32-bit systems and FreeCAD 0.16.6706, after attempts to install, the additional Workbenches may not be available. In this case
** hold the Report panel open while starting FreeCAD, and read the error
** keep the [[report_view|report view]] open while starting FreeCAD, and read the error,
** see this forum thread: http://forum.freecadweb.org/viewtopic.php?t=12839#p102933
** see this forum thread [http://forum.freecadweb.org/viewtopic.php?t=12839#p102933 Assembly2 in Version: 0.16.5602 (Git)]


</translate>
</translate>
{{Userdocnavi{{#translation:}}}}
{{Powerdocnavi{{#translation:}}}}
[[Category:External Workbenches{{#translation:}}]]
[[Category:Addons{{#translation:}}]]

Revision as of 18:56, 30 July 2022

Tutorial
Topic
Programming
Level
Medium programmer
Time to complete
15 minutes
Authors
r-frank
FreeCAD version
All
Example files
none
See also
None

Description

Power users have extended FreeCAD with various custom external workbenches that are not integrated into the core source code but are easy to install on an existing FreeCAD distribution. Here we will cover the installation methods for the different operating systems.

Note: starting from version 0.17, FreeCAD features an Addon Manager in the Tools → Addon Manager menu, that allows installing both macros and workbenches. The instructions below are only required if you wish to manually install a workbench. This may be necessary if for some reason the Addon Manager doesn't work but you have access to the workbench downloaded as a .zip package.

Installing on Windows

How to install additional workbenches and addons on Windows

Obsolete

Note: using the "addons-installer" is not recommended any more. Using the Addon Manager in all systems is the recommended way.

Use the addons-installer from Github.

During Google Summer of Code 2016 student Mandeep Singh started work on an improved version (available here) but that version needs further work before it can be fully integrated in FreeCAD.

Manual Install

Note: This method is possible but not necessary with the introduction of the Addon Manager. Nevertheless, the information here may still be useful to some.

  • Download the workbench from github by clicking on the button Clone or Download on the github page (upper right corner) and choosing "Download ZIP"
  • Unpack the downloaded archive on your local hard disk
  • Within FreeCAD, locate the macro path by choosing Edit → Preferences → General → Macro and look for the ”Macro path”
  • Supposed your Windows-Login is “username” the default macro path is %APPDATA%\FreeCAD\ which is usually C:\Users\username\Appdata\Roaming\FreeCAD
  • Within the macro-directory create (if not already present) a folder called “Mod
  • Within the Mod folder, create a folder with the name of the workbench, for example “Curves”
  • Now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
  • After restart of FreeCAD you should now have an entry in the workbench selector

Additional Recommendation for updating workbenches

On windows, when updating an already installed workbench, Windows keeps the old .py files as .pyc. Since this may lead to trouble, it is recommended to uninstall the workbench, restart FreeCAD and install the new version of the workbench.


Installing on Linux

How to install additional workbenches and addons on Linux

Using git

Adding the community-ppa within the ppa-manager.
Installing the workbenches via synaptic packet manager.

$ sudo apt-get install git python-numpy python-pyside
$ mkdir ~/.FreeCAD/Mod
$ cd ~/.FreeCAD/Mod
$ git clone  https://github.com/tomate44/CurvesWB.git

In FreeCAD you will now have a new workbench-entry called "CurvesWB". Once installed, use git to upgrade to the latest version:

$ cd ~/.FreeCAD/Mod/CurvesWB
$ git pull
$ rm *.pyc

Manual Installation

Note: This method is possible but not necessary with the introduction of the Addon Manager. Nevertheless, the information here may still be useful to some.

  • Download the workbench from github by clicking on the button Clone or Download on the github page (upper right corner) and choosing "Download ZIP"
  • Unpack the downloaded archive on your local hard disk
  • Within FreeCAD, locate the macro path by choosing Edit → Preferences → General → Macro and look for the ”Macro path”
  • By default, the macro directory is the (hidden) ./.FreeCAD/ directory in your home-directory
  • Within the macro-directory create (if not already present) a folder called “Mod
  • Within the Mod/ folder, create a folder with the name of the workbench, for example “Curves”
  • Now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
  • After restart of FreeCAD you should now have an entry in the workbench selector


Installing on Mac

How to install additional workbenches and addons on MacOS

Manual Installation

Note: This method is possible but not necessary with the introduction of the Addon Manager. Nevertheless, the information here may still be useful to some.

For the sake of this example, say you've chosen the Curves Workbench as the external workbench you want to install:

  • Choose and download the git repository of your chosen external workbench as a ZIP file
  • There are two possible locations for your Addon workbench 'Mods':
  1. All Users: /Applications/FreeCAD.app/Contents/Resources/Mod
  2. Current user only: /Users/myusername/Library/Preferences/FreeCAD/Mod
  • If you use Finder to navigate manually to the All Users location in Applications you will need to
    • go to /Applications" and select FreeCAD.app
    • right-mouse-click and select "Show Package Contents", a new window will appear with a folder named "Contents"
    • single-click on the folder "Contents" then on "Resources" and double-click to open the folder "Mod"
  • Once you are in whichever "Mod" folder you want to use, create a New Folder named "Curves"
  • Unzip downloaded repository in the folder "Mod/Curves"

General troubleshooting

  • Don't use special characters (for example German umlauts) in your windows user name, otherwise FreeCAD will not recognize files and folders in the macro path.
  • If you have already set up a user name with special characters either create a new user name or point the macro path to a directory not using special characters.
  • Go to Tools → Customize → Workbenches and make sure the workbench is not set to invisible.
  • With 32-bit systems and FreeCAD 0.16.6706, after attempts to install, the additional Workbenches may not be available. In this case