Skip to content

Installation

Addon installation

  • Download the ZIP archive from github (ensure it's a ZIP Archive, on Mac you might have to repack as it gets unzipped automatically)
  • Open Blender and go to: Edit > Preferences > Add-ons > Press "Install..." button
  • Browse to the location of the ZIP and select it, then press "Install Add-on"
  • Enable the addon by pressing the checkbox

You can get the latest state of the addon and easily update it with git

  • Get Git
  • In Blender, add the scripts-path under Preferences->File Paths->Script Directories->Add (e.g. ~/blender_scripts)
  • Open your scripts_folder

    1
    cd ~/blender_scripts
    
  • Create an addons folder

    2
    3
    mkdir addons
    cd addons
    

  • Clone the addon repository
    4
    git clone https://github.com/hlorus/CAD_Sketcher.git
    
  • Blender will now automatically load addons from that path

Dependency installation

CAD Sketcher heavily depends on the solvespace python module and won't be functional without it.

Once the 3D View CAD Sketcher plugin is installed check its preferences for the "Solver Module" tab to see if the module is already available, otherwise follow one of the guides below.

  • Press "Install from PIP"
  • Wait for the process to finish
  • Download the appropriate *.whl file here (make sure the python version matches the one from your blender installation)
  • Choose the file in the filepath selector
  • Press "Install from local File"

Extra step on Mac OS:

Due to an ongoing Blender bug, Mac OS users with Metal need to change their GPU Backend to OpenGL: Edit > Preferences > System > GPU Backend > Select "OpenGL". Remember to restart Blender after this.

Installation fails

There are multiple reasons why the installation might fail. Try the following:

  • If you're on windows start blender as administrator when installing the dependency
  • If you've installed blender through a package manager try again with a version from blender.org
  • Check the application's output in the system console for any warnings or hints to find out why it's failing
  • Blender can be installed through package managers, installing external python packages with such installations might not be possible. Try to use the addon with Blender installed from the official website.
  • Ask for help

Updating

  • Simply redo the installation steps with the latest addon version
  • Delete the old version from the addons list under Edit > Preferences > Add-ons

If you've cloned the addon with git you can easily update it:

  • Open the addon folder in a terminal
    1
    cd ~/BLENDER_SCRIPTS_PATH/CAD_Sketcher
    
  • Pull the changes
    2
    git pull