SketchUp - Installation

Owned by Systems Next Limit (Unlicensed)
Last updated: 08 Jul, 2024 by Next Limit
5 min read



Compatibility

  • SketchUp Make and SketchUp Pro, 64-bit only, from SketchUp 2017 to 2021)

  • Maxwell Render 5

  • Windows Windows 7 and up

  • Mac OSX 10.12 and up

Installation

You can download the installer from your account at the portal, from the “My Downloads” section.

 

Windows

  1. Unzip the downloaded zip file to your Desktop.

  2. Double-click the installer (Maxwell_for_SketchUp-x.x.x.exe) file.

  3. Choose the desired SketchUp versions and Maxwell Render if it's not installed yet (the installer actually includes two installers inside, the core of the render engine and the plugin itself) and then click Install.

Mac OSX

  1. Double-click the downloaded .dmg installer file (Maxwell_for_SketchUp-x.x.x_osx.dmg).

  2. Double-click the icon to install the required version of Maxwell Render if it's not installed already and follow the instructions.

  3. Double-click the icon to install Maxwell for SketchUp.

  4. Choose the desired SketchUp versions and click Install.

Uninstallation

Windows

  1. Open Windows Control Panel > Apps.

  2. Uninstall the desired versions of Maxwell for SketchUp.

  3. Optionally, use the Plugin Files section below to confirm the plugin's files have been removed.

Mac OSX

  1. Double-click the installer (Maxwell_for_SketchUp-x.x.x.dmg) file.

  2. Double-click the Maxwell for SketchUp icon

  3. Choose the desired SketchUp versions and click Uninstall.

  4. Optionally, use the Plugin Files section below to confirm the plugin's files have been removed.

Plugin Version

The plugin supports running in one of two modes: Demo or Licensed, with the determination of which depending on the type of license found at start-up (with the plugin first checking for a Maxwell Render Suite license, then a Standalone Maxwell for SketchUp license). If no license is found, the plugin will run in unlicensed mode, in which resolution is restricted, and the Production render engine is not available.

Troubleshooting

If the plugin menu and/or toolbars do not show up in SketchUp after installing, the first thing to do is to go to SketchUp’s Preferences > Extensions  panel and make sure the Maxwell for SketchUp extension is enabled. If the still plugin fails to load, or causes any malfunction as it is loaded into SketchUp, it is recommended to manually perform a clean install, in case the issue is due either to the presence of files from different plugin versions, or files that are missing or corrupted.

Windows

First, use Programs and Features to uninstall any currently-installed instances of the Maxwell for SketchUp plugin. Next, use Explorer to confirm that the following files have been deleted:

  • maxwell.rb

  • maxwell (folder)

The locations of these files, for different versions of SketchUp, may be found in the Plugin Files section below. After ensuring that the listed files have been deleted, re-run the plugin's installer. Should the issue continue to occur, repeat the process using a fresh download of the plugin, in case the one you are using has been damaged (by a third-party virus scanner, or unzip program, for instance).

Mac OSX

The plugin's installer application may also be used to uninstall the plugin. To do so, run the installer again, choose the versions of SketchUp for which you wish to uninstall the plugin, and click Uninstall. The installer will generate a report indicating whether the uninstall was successful; if not, use Finder to locate and delete:

  • maxwell.rb

  • maxwell (folder)

The locations of these files, for different versions of SketchUp, may be found in the Plugin Files section below. After ensuring that the listed files have been deleted, re-run the plugin's installer. Should the issue continue to occur, repeat the process using a fresh download of the plugin, in case the one you are using has been damaged (by a third-party virus scanner, or unzip program, for instance).

Manual installation

If the installer should fail to properly install the plugin, note that it is also possible to perform a manual installation, using files contained directly inside of the installer .app. To access these files, right-click the installer .app and choose Show Package Contents. Inside the package, you will find the various plugin files, in the Contents/Resources subfolder. The files should be placed according to the paths specified below.

Plugin Files

The plugin is a SketchUp Ruby Extension, consisting of a maxwell.rb file and maxwell folder. The standard location of these files, for each OS and version of SketchUp, is as follows:

maxwell.rb and the maxwell folder on Windows:

  • C:\ProgramData\SketchUp\<SketchUp version>\SketchUp\Plugins

maxwell.rb and the maxwell folder on Mac OSX:

  • /Users/<username>/Library/Application Support/<SketchUp version>/SketchUp/Plugins

Note: the ~/Library folder may be hidden by default; to locate it in Finder, use Go > Go to Folder, type ~/Library, and click Go.

Other Issues

Very rarely, but more than a couple of times now, it has been reported that upon opening one of the plugin windows, all that is seen in the window is a message stating "This page requires CSS! Please ensure that you have not disabled styles in your browser." Each time this has been reported, it has been found that Dreamweaver has been installed on the machine, and that it has erroneously altered the registry, adversely affecting how web page files (in this case, .css files) are handled by the browser when they are located on the local file system, as they are in a SketchUp plugin.

When you browse to a web page, several files are downloaded to your browser, and it determines what to do with each one based on what is known as a MIME type. The MIME type is sent to the browser from the server, along with the data, but if you are viewing a file locally, there is no server, and therefore nobody to tell the browser what type of file it is. In that case, Internet Explorer apparently uses some information in the registry to determine what to do with the file, and it is this information, in this case pertaining to how CSS files are to be handled, which is damaged by the Dreamweaver installer.

In order to fix the issue, it is necessary to fix the registry, which may be able to be done using these steps:

  1. Go to the page for NirSoft's FileTypesMan and download the x64 version (assuming you are using a 64-bit OS).

  2. Unzip the downloaded package and run the FileTypesMan.exe application.

  3. Once the list of file types has been populated, scroll down to the .css entry.

Here, we will be looking at the MIME Type column for the .css extension, which should be set to text/css. If it is not, you should double-click the line, and set the MIME Type back to text/css. After doing so, and restarting SketchUp, the browser windows should load the plugin's user interface as expected. As you can see, it is not necessarily Dreamweaver which will have done this, but that has been the case when we've had it reported.

Lastly, it must be said that these instructions are given on a strictly use-at-your-own-risk basis; though the procedure is not especially difficult, the fact is that Next Limit can accept no responsibility for any damage you may inadvertently do to your registry while attempting this fix.