Notice: This user guide is based on the legacy connector.
We recommend using our new connectors instead, as they are easier to use and actively maintained. This legacy documentation may not be up to date.
Legacy Speckle supports versions:

​
Installation

Before using this connector, you’ll need to follow our standard setup instructions to install Speckle Manager and add a Speckle account. Once the Blender Connector has been installed through Manager, you will find it under the “Add-ons” tab of your Preferences menu, under the “Scene” category. Activate it by checking the tick box next to the Add-on name. Once Enabled, a restart of blender may be required.
Feel free to reach out to us on the forums if you’re having any difficulties.

​
Manual installation

Installation through Speckle Manager is recommended for most users, however, for users looking to install the blender connector on unsupported platforms or Blender versions, the connector can be installed through a manual zip. However, you will still need to add your accounts, either through Speckle Manager (recommended) or manually
  1. Head to releases.speckle.systems and, under the drop down, download the latest manual installer.
Screenshot of speckle-blender releases tab, showing manual installer highlighted in the drop-down menu
  1. Open Blender, and navigate to the Add-ons menu, under Edit -> Preferences
  2. Press the Install button in the top right, and select the downloaded zip.
  3. Once enabled, a restart of blender may be required.

​
User interface

The Blender Connector lives in the 3D viewport toolbar (N) under the Speckle tab. It contains three main panels:
  • User Panel for switching between different local accounts.
  • Projects Panel for browsing your existing projects, creating new projects, or deleting old projects.
  • Active Project Panel for sending and receiving data to and from Speckle.
panels overview
The Projects Panel shows a list of your most recent projects, which you can search through by name. You can add new projects with the ”+” button, delete projects with the ”-” button, and refresh the projects with the refresh button.
add by url
From version 2.1.9, you can also add existing projects by their URL. You can use the URL to a project, a specific model, or a specific version. Simply paste it into the popup and the correct account, project, model, and version will get selected for you. The Active Project Panel will show more details about the project you’ve selected in the Projects Panel. From here, you can change the active model and version. You can also Send and Receive any items you have selected in Blender. Under the Send and Receive buttons, you can use the dropdown menus to select a script to run on all elements during the send / receive process. At the very bottom of the panel (not pictured), you’ll find a button that will open the project in the Speckle Web App.

​
Clean meshes

One of the new features we added with the 2.9. release is Clean Meshes for Blender. With this feature, a single surface is obtained by combining triangular coplanar faces. This is especially useful for geometry that is coming from applications that do not support NGON meshes. With Clean Meshes, Material Assignment and UV Mapping will be much easier now.
Clean Meshes
Clean Mesh option can be accessed from the dialog that pops up after clicking the Receive button. By default, this will be unchecked🔳.
Clean Meshes Option

​
BlenderBIM

There is currently some limited support for BlenderBIM, though this is intended as an export and does not work coming back. To take advantage of this, simply open an IFC using BlenderBIM then use the Speckle connector to send to Speckle.
There are a few things to keep in mind when sending an IFC to Speckle using BlenderBIM:
  • Structure: The hierarchical structure of collections and objects is preserved when sending to Speckle.
    • The name of each object is attached in the name field.
    • Any / in names will be replaced with ::
  • Materials: If the object has a material, this will be simplified into a Render Material and attached in the renderMaterial field.
  • Properties: Custom properties added within Blender are always added to a properties field on respective objects. For BlenderBIM objects, this includes the ifc_definition_id.
    • Additional IFC properties that aren’t stored in Blender are currently not extracted from the IFC and attached. This may be explored as an enhancement in the future.
  • Type: Objects are all sent as meshes and collections are sent as Base objects. None of the objects are currently being converted and sent as BIM objects.