2. Getting Started

System requirements

In order to run Modelur, you will need:

  1. SketchUp 2014 or above,
  2. Internet Explorer 10 or above (Windows) / Safari 5 or above (OS X).

Modelur works well with both, Make (free) and Pro (commercial) versions of SketchUp.

Installation

There are several ways you can install Modelur:

Note

We recommend you to use option #1 (universal RBZ installer) in order to ensure you install the latest version of Modelur.

To install a SketchUp Ruby plugin in RBZ format use the standard SketchUp installation procedure:

  1. We recommend logging into your computer as an admin before installing any Ruby scripts. This will make the installation go more smoothly and ensure that files get installed in the proper places.
  2. SketchUp 2016 and below: Select Window → Preferences (Windows) or SketchUp → Preferences (OS X).
    SketchUp 2017 and above: Select Window → Extension Manager (Windows) or SketchUp → Extension Manager (OS X). The Preferences dialog box is displayed.
  3. Click on Extensions. The Extensions panel is displayed.
  4. Click on the Install Extension button. The Open dialog box is displayed.
  5. Locate the Ruby zip file to install (.rbz).
  6. Click on the Open button. The Ruby plugin appears in the list of extensions.

Modelur Location

Upon installation, Modelur is saved to Sketchup's default Plugins folder, which resides at different locations, depending on the version of SketchUp you use:

  • On Windows: C:\Users\YOUR USERNAME\AppData\Roaming\SketchUp\SketchUp ####\SketchUp\Plugins\
  • On OS X: ~/Library/Application Support/SketchUp ####/SketchUp/Plugins/

Preferences Location

Files containing your Modelur preferences are stored

  • On Windows: C:\Users\YOUR USERNAME\AppData\Roaming\Modelur
  • On OS X: ~/Library/Application Support/Modelur

All preferences are stored using standard JSON data-interchange format. Upon Modelur upgrade, these files will be automatically updated. In case you edit them manually and something doesn't work, you can always restore them using the command available via SketchUp's menu Extensions → Modelur → Restore default settings.

Installation problems

If you encounter any problems with your Modelur installation, please do the following:

On Windows:

  1. Delete \Modelur folder and modelur.rb file from C:\Users\YOUR USERNAME\AppData\Roaming\SketchUp\SketchUp ####\SketchUp\Plugins\.
  2. Delete \Modelur folder from C:\Users\YOUR USERNAME\AppData\Roaming\ (if it exists).
  3. Install the newest RBZ version of Modelur and try to license it (make sure you are online).

On OS X:

  1. Delete \Modelur folder and modelur.rb file from ~/Library/Application Support/SketchUp ####/SketchUp/Plugins/.
  2. Delete \Modelur folder from ~/Library/Application Support/Modelur/ (if it exists).
  3. Install the newest RBZ version of Modelur and try to license it (make sure you are online).

Licensing

Upon purchase, you should have received a License Key. To license your copy of Modelur, please make sure you are online. You need to copy/paste received License Key into activation window, which opens automatically when you first initialize Modelur (Figure 2.01).

Activate Modelur

Figure 2.01 - Modelur Activation window.

In case you are not able to obtain your License Key or if you experience any other problem, please contact us at support@modelur.com.

Updating License

Once you renew your Modelur license, you need to update it in case the License Key is different from the one you used before.

In case you encounter some problems when trying to update the license using SketchUp Extensions > Modelur > Update Modelur License or Modelur can't do it automatically (if it is the same Key as before), please do the following:

On Windows:

  1. Delete modelur.lic file from C:\Users\YOUR USERNAME\AppData\Roaming\Modelur\ folder.
  2. Restart SketchUp and initialize Modelur. It will ask you for your License Key.

On OS X:

  1. Delete modelur.lic file from ~/Library/Application Support/Modelur/ folder.
  2. Restart SketchUp and initialize Modelur. It will ask you for your License Key.

Trial License

You can request free Trial License directly inside Modelur. To do so, install and initialize Modelur. Once activation window is shown, please click on a Request a Trial License link as shown below (Figure 2.02).

Request trial

Figure 2.02 - Request Trial button.