Skip to content

Latest commit

 

History

History
126 lines (79 loc) · 5.76 KB

Blendercam Installation.md

File metadata and controls

126 lines (79 loc) · 5.76 KB

How to install Blendercam ?

Use Blendercam from github

Using Blendercam from github is a great way to try out the newest features and fixes. The latest build (dailybuild) of Blender can be used with the latest Master branch of Blendercam and then you can live on the bleeding edge.

The easiest way to "install" is not to install but instead just tell Blender where to find the add-on. This way you don't have to worry about copying/moving files around. You can keep Blendercam source files separate from Blender if using source control (ie git for development) and still easily test your changes in Blender.

If you are using Arch Linux, you can just install blendercam-git from the AUR and skip to Enable Blendercam add-on. OpenCAMLib is also available as opencamlib-git.


You can watch the video using the documentation below.

How To Install on Linux


Obtaining Blender

Blendercam is an addon of Blender. It works now with Blender version 2.83 and 2.92. You can download Blender portable version for linux64 2.83 or 2.92 and install dependencies from command lines.

$ cd ~/
$ mkdir Apps
$ cd Apps
$ wget https://ftp.nluug.nl/pub/graphics/blender/release/Blender2.92/blender-2.92.0-linux64.tar.xz
$ tar xf blender-2.92.0-linux64.tar.xz
$ cd blender-2.92.0-linux64/2.92/python/bin
$ ./python3.7m -m ensurepip
$ ./pip3 install shapely
$ ./pip3 install vtk
$ ./pip3 install Equation

Dependencies

Python dependencies Version
shapely >= 1.5
numpy ...
vtk ...
Equation ...

Note: if you are using a Blender with a bundled Python then shapely and numpy must be installed in the site-packages directory of the bundled python. For Blender 2.8 only Shapely is needed. To install it, open terminal, get to Blender directory and use PIP:

cd 2.80/python/bin/

./python3.7m -m ensurepip

./python3.7m -m pip install shapely

Get Blendercam source code

The first step is to get the source code from the github repository.

  1. Assuming that Git is installed on your machine, at the command prompt change into the directory where blendercam will be and then type:
  2. git clone https://github.com/vilemnovak/blendercam.git (Master branch is now upgraded to Blender 2.8, 2.8_BETA branch will soon be removed)

git clone

  1. git will make a subdirectory called blendercam in the current directory then download the most recent version of blendercam from github.

Setup Blender scripts alternate file path

The second step is to tell blender to also search an alternate path for add-ons. When blender starts up it will search its own paths for add-ons and will also search the alternate path that you add. This way an external source add-on can be used in Blender.

  1. select User Preferences panel

File User Preferences

  1. select File tab
  2. select the file button on the Scripts input field and select the path to your blendercam/scripts directory

File Paths

  1. select Save User Settings
  2. restart Blender

Enable Blendercam add-on

The third step is to enable the Blendercam add-on.

Enable Addon

  1. select User Preference panel
  2. select Add-ons tab
  3. select Scene category
  4. enable the CAM addon by left clicking on the check box. (Note: the checkbox is on the left side in daily builds of Blender after 11 Jan 2016)
    4a. the file path should match your Blendercam git path
  5. Optional: enable the experimental features
  6. select Save User Settings

Now when ever blender is started, the external blendercam add-on will be enabled.

(Optional) Install Opencamlib

To install OpenCamLib, you can follow this link.

OpenCAMLib is an open source CAM library created by Anders Wallin. It offers high quality waterline generation and drop cutter sampling algorithms. For drop cutter algorithms it's more reliable than Bullet Physics (Blender's built-in collision detection library) and offers better performance (up to 30 times faster than regular algorithm on 24-core machine).

To use OpenCAMLib with BlenderCAM, it needs to be built from source and installed inside Python distribution bundled with Blender.

To use OpenCAMLib waterlines, select "Show experimental features" in Blender User Preferences / Addons / CAM - gcode generation tools. Then select Waterline strategy and "Use OpenCAMLib". The current version lacks dialog for waterline resolution and automatic determination of cutter length, those can be adjusted in scripts/addons/cam/opencamlib/opencamlib.py.

For "parallel" strategy and other drop cutter sampling operations select both "Use exact mode" and "Use OpenCAMLib".

Updating Blendercam

Every once in a while, maybe even daily, you will want to update your copy of Blendercam to match what is on Github.

  1. at the command line, change to the directory of blendercam
  2. tell git to pull all the latest changes from Github and update your copy git pull

After git finishes updating blendercam you can run blender. If blender was already running, restart it (close blender and then start it).