148 lines
9.3 KiB
HTML
148 lines
9.3 KiB
HTML
<html><head><title>How to install additional workbenches</title><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><link type='text/css' href='wiki.css' rel='stylesheet'></head><body><h1>How to install additional workbenches</h1></div>
|
||
|
||
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="mw-parser-output"><table class="fcinfobox wikitable ct" style="width: 230px; float: right; margin-left: 1em">
|
||
<tr>
|
||
<td class="ctTitle">
|
||
<h3><span class="mw-headline" id="Tutorial"><a href="https://www.freecadweb.org/wiki/index.php?title=File:Base_ExampleCommandModel.png" class="image"><img alt="Base ExampleCommandModel.png" src="32px-Base_ExampleCommandModel.png" width="32" height="30" srcset="/wiki/images/thumb/9/93/Base_ExampleCommandModel.png/48px-Base_ExampleCommandModel.png 1.5x, /wiki/images/9/93/Base_ExampleCommandModel.png 2x" /></a> Tutorial</span></h3>
|
||
</td></tr>
|
||
<tr>
|
||
<th class="ctOdd">Topic
|
||
</th></tr>
|
||
<tr>
|
||
<td class="ctEven">Programming
|
||
</td></tr>
|
||
<tr>
|
||
<th class="ctOdd">Level
|
||
</th></tr>
|
||
<tr>
|
||
<td class="ctEven">Medium programmer
|
||
</td></tr>
|
||
<tr>
|
||
<th class="ctOdd">Time to complete
|
||
</th></tr>
|
||
<tr>
|
||
<td class="ctEven">15 minutes
|
||
</td></tr>
|
||
<tr>
|
||
<th class="ctOdd">Author
|
||
</th></tr>
|
||
<tr>
|
||
<td class="ctEven"><a href="https://www.freecadweb.org/wiki/index.php?title=User:R-Frank" title="User:R-Frank">r-frank</a>
|
||
</td></tr>
|
||
<tr>
|
||
<th class="ctOdd">FreeCAD version
|
||
</th></tr>
|
||
<tr>
|
||
<td class="ctEven">All
|
||
</td></tr>
|
||
<tr>
|
||
<th class="ctOdd">Example File(s)
|
||
</th></tr>
|
||
<tr>
|
||
<td class="ctEven">None
|
||
</td></tr>
|
||
<tr>
|
||
<td class="ctToc"><br /><div id="toc" class="toc"><div class="toctitle"><h2>Contents</h2></div>
|
||
<ul>
|
||
<li class="toclevel-1"><a href="#Tutorial"><span class="tocnumber">1</span> <span class="toctext">Tutorial</span></a></li>
|
||
<li class="toclevel-1 tocsection-1"><a href="#Description"><span class="tocnumber">2</span> <span class="toctext">Description</span></a></li>
|
||
<li class="toclevel-1 tocsection-2"><a href="#Installing_on_Windows"><span class="tocnumber">3</span> <span class="toctext">Installing on Windows</span></a></li>
|
||
<li class="toclevel-1 tocsection-3"><a href="#Installing_on_Linux_.28Ubuntu.2FMint.29"><span class="tocnumber">4</span> <span class="toctext">Installing on Linux (Ubuntu/Mint)</span></a></li>
|
||
<li class="toclevel-1 tocsection-4"><a href="#Installing_on_Mac"><span class="tocnumber">5</span> <span class="toctext">Installing on Mac</span></a></li>
|
||
<li class="toclevel-1 tocsection-5"><a href="#General_troubleshooting"><span class="tocnumber">6</span> <span class="toctext">General troubleshooting</span></a></li>
|
||
</ul>
|
||
</div>
|
||
|
||
</td></tr></table>
|
||
<p><br />
|
||
</p>
|
||
<h2><span class="mw-headline" id="Description">Description</span></h2>
|
||
<p>Power users have extended FreeCAD with various custom external workbenches, that are not integrated into the FreeCAD source code (yet!),
|
||
but are easy to install on an existing FreeCAD installation. Here we will cover the installation methods for the different operating systems.
|
||
</p><p><b>Note</b> 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.
|
||
</p>
|
||
<h2><span class="mw-headline" id="Installing_on_Windows">Installing on Windows</span></h2>
|
||
<p><b>Recommended installation method</b>
|
||
</p><p>Use the <a rel="nofollow" class="external text" href="https://github.com/FreeCAD/FreeCAD-addons">addons-installer from Github</a>.<br />
|
||
During Google Summer of Code 2016 student Mandeep Singh started work on an improved<br />
|
||
version (<a rel="nofollow" class="external text" href="https://github.com/mandeeps708/PluginManager">available here</a>) but that version needs further work before it can be fully integrated in FreeCAD.<br />
|
||
</p><p><b>Alternative installation method “manual install”</b>
|
||
</p>
|
||
<ul><li>download the workbench from github by clicking on the button “clone or download” on the github page (upper right corner) and choosing "Download ZIP"</li>
|
||
<li>unpack the downloaded archive on your local hard disk</li>
|
||
<li>within FreeCAD, locate the macro path by choosing “Edit > Preferences > General > Macro” and look for the ”Macro path”</li>
|
||
<li>supposed your Windows-Login is “User-Name” the default macro path is “C:\User-Name\Appdata\Roaming\FreeCAD”</li>
|
||
<li>within the macro-directory create (if not already present) a folder called “Mod”</li>
|
||
<li>within the folder mod create a folder with the name of the workbench, for example “Assembly2”</li>
|
||
<li>now move the unpacked files and sub-folders of the workbench to the just created workbench-folder</li>
|
||
<li>after restart of FreeCAD you should now have an entry in the workbench-pulldown-menu</li></ul>
|
||
<p><b>Additional Recommendation for upating workbenches</b>
|
||
</p><p>On windows, when updating an already installed workbench, Windows keeps the old .py files as .pyc.<br />
|
||
Since this may lead to trouble, it is recommended to uninstall the workbench, restart FreeCAD and install<br />
|
||
the new version of the workbench.
|
||
</p><p><br />
|
||
</p>
|
||
<h2><span class="mw-headline" id="Installing_on_Linux_.28Ubuntu.2FMint.29">Installing on Linux (Ubuntu/Mint)</span></h2>
|
||
<p><b>Recommended installation method</b>
|
||
</p><p>Adding the <a rel="nofollow" class="external text" href="https://launchpad.net/~freecad-community/+archive/ubuntu/ppa">community-ppa</a> within the ppa-manager.<br />
|
||
Installing the workbenches via synaptic packet manager.
|
||
</p><p><b>Alternative installation method “Installing via Git”</b>
|
||
</p>
|
||
<pre>$ sudo apt-get install git python-numpy python-pyside
|
||
$ mkdir ~/.FreeCAD/Mod
|
||
$ cd ~/.FreeCAD/Mod
|
||
$ git clone https://github.com/hamish2014/FreeCAD_assembly2.git </pre>
|
||
<p>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
|
||
</p>
|
||
<pre>$ cd ~/.FreeCAD/Mod/FreeCAD_assembly2
|
||
$ git pull
|
||
$ rm *.pyc </pre>
|
||
<p><b>Alternative installation method “manual install”</b>
|
||
</p>
|
||
<ul><li>download the workbench from github by clicking on the button “clone or download” on the github page (upper right corner) and choosing "Download ZIP"</li>
|
||
<li>unpack the downloaded archive on your local hard disk</li>
|
||
<li>within FreeCAD, locate the macro path by choosing “Edit > Preferences > General > Macro” and look for the ”Macro path”</li>
|
||
<li>by default, the macro directory is the (hidden) "/.FreeCAD"-directory in your home-directory</li>
|
||
<li>within the macro-directory create (if not already present) a folder called “Mod”</li>
|
||
<li>within the folder "mod" create a folder with the name of the workbench, for example “Assembly2”</li>
|
||
<li>now move the unpacked files and sub-folders of the workbench to the just created workbench-folder</li>
|
||
<li>after restart of FreeCAD you should now have an entry in the workbench-pulldown-menu</li></ul>
|
||
<h2><span class="mw-headline" id="Installing_on_Mac">Installing on Mac</span></h2>
|
||
<p><b>Recommended installation method</b>
|
||
</p><p><br />
|
||
<b>Alternative installation method “manual install”</b> - here a description for the workbench "assembly2"
|
||
</p>
|
||
<ul><li>download the git repository as ZIP</li>
|
||
<li>assuming FreeCAD is installed in "/Applications/FreeCAD/v0.15", go to "/Applications/FreeCAD/v0.15" in the Browser, and select FreeCAD.app</li>
|
||
<li>right-click and select "Show Package Contents", a new window will appear with a folder named "Contents"</li>
|
||
<li>single-click on the folder "Contents" and select the folder "Mod"</li>
|
||
<li>in the folder "Mod" create a new folder named "assembly2"</li>
|
||
<li>unzip downloaded repository in the folder "Contents/Mod/assembly2"</li></ul>
|
||
<p><br />
|
||
Copy or unzip the drawing dimensioning folder to the directory FreeCAD.app/Contents/Mod
|
||
where FreeCAD.app is the folder where FreeCAD is installed.
|
||
</p>
|
||
<h2><span class="mw-headline" id="General_troubleshooting">General troubleshooting</span></h2>
|
||
<ul><li>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</li>
|
||
<li>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</li>
|
||
<li>Workbench still not showing up ? In FreeCAD, choose “Tools > Customize > Workbenches” and make sure it is not set to invisible</li>
|
||
<li><b>Notes for users with 32-bit system and FreeCAD 0.16.6706 </b>. After attempts to install, the additional Workbenches may not be available. In this case
|
||
<ul><li> hold the Report panel open while starting FreeCAD, and read the error</li>
|
||
<li> see this forum thread: <a rel="nofollow" class="external free" href="http://forum.freecadweb.org/viewtopic.php?t=12839#p102933">http://forum.freecadweb.org/viewtopic.php?t=12839#p102933</a></li></ul></li></ul>
|
||
<p><br />
|
||
</p>
|
||
</div>
|
||
|
||
|
||
|
||
</div>
|
||
|
||
</div><div class="printfooter">
|
||
Online version: "<a dir="ltr" href="https://www.freecadweb.org/wiki/index.php?title=How_to_install_additional_workbenches&oldid=231434">http://www.freecadweb.org/wiki/index.php?title=How_to_install_additional_workbenches&oldid=231434</a>"</div>
|
||
<div id="catlinks" class="catlinks" data-mw="interface"></div><div class="visualClear"></div>
|
||
</div>
|
||
</div>
|
||
<div id="mw-navigation">
|
||
<h2>Navigation menu</h2>
|
||
|
||
</body></html> |