Installation Guide
Rayscaper is a SketchUp extension, and installing it takes about a minute. You need SketchUp 2024, 2025, 2026 or 2027 on Windows. On a Mac, read the Mac page instead.
Installing Rayscaper
Section titled “Installing Rayscaper”The steps in SketchUp, from the Extensions menu to Rayscaper in the Extension Manager:
-
Download Rayscaper. On rayscaper.com, click Try for Free and enter your email address. Open the email we send you and click Download Rayscaper: the download starts by itself, and if it doesn’t, click download it here on that page. No email after a few minutes? Look in your spam folder. Always download Rayscaper from rayscaper.com: other websites may have an old version.
You get one file of about 160 MB with a name like
Rayscaper_Win_1.0.2.rbz, usually in your Downloads folder. An rbz file is the file a SketchUp extension is installed from. Leave it as it is, you don’t need to unzip it. -
Open the Extension Manager. In SketchUp, choose Extensions > Extension Manager.

-
Click Install Extension, at the bottom of the Extension Manager.

-
Select the Rayscaper file and click Open. Go to the folder you downloaded it to, usually Downloads. If SketchUp asks whether you trust the extension, click Yes.

-
Done. After a few seconds Rayscaper is in the list of the Extension Manager, signed and enabled. You don’t need to restart SketchUp.

The Rayscaper toolbar appears in SketchUp. Click Start Render, its first button, to open the render window.

The key button near the end, License, activates a license, see Activating a license.
Next, make your first render with the Quick Start.
Activating a license
Section titled “Activating a license”The free version has every feature and no time limit. Its renders have a watermark, are at most 1280 pixels on the longest edge and are for non-commercial use. A license removes these limits.
When you have bought a license, click License on the Rayscaper toolbar, or choose Extensions > Rayscaper > License…. In the License dialog, click Sign In. Your browser opens rayscaper.com, where you sign in with the email address you bought Rayscaper with and confirm your computer. Back in SketchUp, the dialog says Rayscaper Is Activated after a few seconds.

See How do I activate Rayscaper? for the steps, and How can I get a Rayscaper license? to buy one.
If something goes wrong
Section titled “If something goes wrong”- There is no Rayscaper toolbar. Choose View > Toolbars… in SketchUp and tick Rayscaper, see I lost my toolbar.
- Install Extension doesn’t show my file. Make sure you downloaded the file that ends in
.rbz. Look for it in your Downloads folder. - Your SketchUp is 2023 or older. Rayscaper needs SketchUp 2024 or newer, see the system requirements.
- The render window doesn’t open. See The Rayscaper window doesn’t open.
- Something else. Ask for help and tell us your SketchUp version and what you see.
Upgrading to a newer version
Section titled “Upgrading to a newer version”There is no update button: you install the new version over the old one.
-
Download the new Rayscaper rbz file from rayscaper.com, or with the link in the email we sent you.
-
In SketchUp, choose Extensions > Extension Manager and click Install Extension. Select the new rbz file and confirm. This is the same as a first install: you don’t need to uninstall the old version first.
-
Restart SketchUp. Until SketchUp closes, it keeps using the files of the old version. The new version only works correctly after a restart.
When the new version starts for the first time, it removes the files of the previous versions automatically. Your settings, saved materials and downloaded assets are kept.
To confirm the upgrade worked, check the version number as described in What version of Rayscaper am I running?.
Uninstalling Rayscaper
Section titled “Uninstalling Rayscaper”-
In SketchUp, choose Extensions > Extension Manager.
-
Open the Manage tab, find Rayscaper in the list and click Uninstall. Confirm when SketchUp asks.

-
Restart SketchUp.
Removing the remaining files
Section titled “Removing the remaining files”Uninstalling removes only the extension. Your settings, logs, saved materials and downloaded assets stay in a separate folder, so they survive an upgrade or a new install. To remove them as well, close SketchUp and delete this folder:
- On Windows:
%APPDATA%\Rayscaper(usuallyC:\Users\<you>\AppData\Roaming\Rayscaper). - On a Mac:
~/Library/Application Support/Rayscaper. In Finder, choose Go > Go to Folder and enter the path.
This folder also holds the activation of this computer. If you install Rayscaper again afterwards, click Sign In in the License dialog again. The computer gets its old place in your license back.
A rayscaper folder or rayscaper.rb file may still be in the SketchUp plugins folder after the restart. You can
delete them too. The plugins folder is %APPDATA%\SketchUp\SketchUp <version>\SketchUp\Plugins on Windows and
~/Library/Application Support/SketchUp <version>/SketchUp/Plugins on a Mac, for example with SketchUp 2026 as the
version.
Uninstalling doesn’t affect your license, which belongs to your account on rayscaper.com. This computer keeps its place in your license. To use the license on another computer instead, click Sign Out on This Computer in the License dialog before you uninstall, or remove the computer on your account page later. See How do I move my license to another computer?