002 Installation

Chris McKeown / August 2, 2024

Licensing

~2 min read463 words
0 views

Bonus Tools supports Revit 2019 to 2027. It installs once per PC, for every Windows user on it, to:

C:\Program Files\BonusTools

Before you start: close every Revit session. Revit locks the Bonus Tools files, so the installer won't run while Revit is open.







Install

  1. Download the latest Bonus Tools installer (BonusTools-<version>.msi) from either:

    Both give you the same installer.

  2. Double-click the .msi. The BonusTools Setup wizard opens. Click Next.
    Welcome page

  3. Read the license agreement, tick I accept the terms in the License Agreement, and click Next.
    End-User License Agreement page

  4. Enter your Bonus Tools license key and click Next. One key activates Bonus Tools for every Windows user on the PC. You can leave it blank and activate later from Revit (see KC License Activation).
    License key page

  5. Click Install.
    Ready to install page

  6. Windows asks whether to allow the app to make changes to your device. Click Yes. You need administrator rights on the PC.

  7. On the last page, two options are ticked:

    • Open the BonusTools tutorials
    • Sign in to your BonusTools account

    Untick any you don't want, then click Finish.
    Completed page

  8. Start Revit. Bonus Tools appears on the ribbon.

What the installer does

  • Installs Bonus Tools to C:\Program Files\BonusTools.
  • Registers it with each installed Revit version (2019 to 2027).
  • Saves the license key to C:\ProgramData\BonusTools, so every Windows user on the PC shares it.
  • Removes any older Bonus Tools install from every user profile on the PC.

Upgrading from an older version

Older versions of Bonus Tools installed separately for each Windows user, to:

C:\Users\%username%\AppData\Roaming\Autodesk\ApplicationPlugins\BonusTools.bundle

If Bonus Tools is in that folder, you are on an old version. Download and run the latest installer (steps above). It removes the old version for every user on the PC and keeps your license key, so you don't need to uninstall anything first.

Updating

Bonus Tools doesn't update itself. To update, download and run the latest installer. It replaces the installed version and keeps your license key. Use About > Check For Updates in Revit to see if a newer version is out.

Silent install (IT deployment)

Deploy without any prompts, and set the license key at the same time:

msiexec /i "BonusTools-<version>.msi" /qn LICENSEKEY=XXXXXXXX

Use /qb instead of /qn to show a progress bar with no other prompts.

Uninstall

First open About in Revit and click Release License to free the seat. Then uninstall BonusTools from Windows Settings > Apps > Installed apps.

Troubleshooting

If Revit shows '.\BonusTools.dll' does not exist after installing, see this FAQ.