This repository contains the Archicad Python API Grasshopper Plugin, the easiest way to use the JSON/Python API from Archicad without knowing how to code. The repository contains the following components:
- grasshopper-plugin: This is set of nodes for a Grasshopper that handles functions of ARCHICAD Python API and helps with creation BIMx extensions (.bimxx).
- archicad-addon: The source code of the Tapir Additional JSON Commands Archicad Add-On. This Add-On registers some additional JSON commands on the Archicad JSON API.
- python-package: Contains the source code for IronPython friendly adaptation of the official archicad package.
- sandbox: Several useful information and code examples that we would like to keep for later reference.
The roadmap is publicly available here.
- Download manualy the api.zip file, and extract it on your computer.
- Copy ARCHICAD_API folder to Grasshopper's UserObjects folder (GH Menu: File/Special Folders/User Object Folder).
- Copy api2.py to Rhino's scripts folder. See how to locate scripts Folder for details.
Goto archicad-api.com to get more info on plugin usage
For some functions one must install an Addon developed by kovacsv which is based on tlorantfy's work. (Thank You guys!)
Download the latest version here:
Once you downloaded the Add-On files you have to install it in Archicad. Follow these steps to install the Add-On.
- Place the downloaded file somewhere on your computer.
- In Archicad run the command "Options > Add-On Manager".
- Open the "Edit List of Available Add-Ons" tabpage, and click on the "Add" button.
- Browse the downloaded Add-On file.
- Click "OK" in the Add-On Manager.
Important note for Mac users: The Add-On is not properly signed at the moment, so once you try to load the Add-On a warning will appear on the screen. You can ignore this warning, but after doing the process above go to Security Settings, allow the Add-On file to run and restart Archicad.
Currently three experimental nodes use this Addon:
- Pick Connection Port
- Get Project Info
- GetSelectedElements (NEW!!) and they can be found in 'Addon Commands' group on ARCHICAD_API Ribbon
You can find the documentation of the implemented commands here: https://enzyme-apd.github.io/tapir-archicad-automation/archicad-addon.