Skip to content

OpenStudio SketchUp Plug in Wiki

Dan Macumber edited this page Sep 7, 2024 · 20 revisions

Installation

  1. Install desired OpenStudio Application version from releases page
  2. Download desired openstudio.rbz plugin from releases page
  3. Launch SketchUp desktop client. Navigate to: Extensions -> Extension Manager -> Install Extension -> Browse to openstudio.rbz
  4. A dialog box will prompt for root path of OpenStudio Application, e.g. 'C:\openstudioapplication-1.6.0'. It should automatically populate if the OpenStudio Application was installed to the default location.
  5. SketchUp should now load the extension.

Troubleshooting

  1. If SketchUp will not launch because of the OpenStudio SketchUp Plug-in, try removing the OpenStudio settings from your SketchUp Preferences.
    1. Windows location: C:\Users\<username>\AppData\Local\SketchUp\SketchUp 2021\SketchUp\PrivatePreferences.json
    2. Mac location: /Users/<username>/Library/Application Support/SketchUp 2021/SketchUp/PrivatePreferences.json

OpenStudio SketchUp Plug-in Version Compatibility Matrix

See the OpenStudio Application Version Compatibility Matrix for more information about OpenStudio Application versions.

SketchUp Version Ruby OpenStudio Application OpenStudio SketchUp Plug-in
SU Pro/Studio 2024 3.2.2 v1.8.0 or higher v1.8.0 or higher
SU Pro/Studio 2021-2023* 2.7.1 v1.2.0 to v1.7.* v1.2.0 or higher
SU Pro/Studio 2019-2020 2.5.5 v1.1.0 (v1.1.1 on Mac) v1.1.0 or higher
  • SketchUp 2023 for Mac (x86 or M1) is not compatible with the OpenStudio SketchUp Plug-in, see #133

The OpenStudio SketchUp Plug-in v1.0.0 and above may work with SketchUp 2017 and OS 2.9.1. However, this configuration is not tested or supported.