Skip to main content

Install the WhatPulse client on MacOS

The WhatPulse Mac client is simple to install. You can either watch this short video of how to install using the wizard, or you can check out the stop by step instructions below the video. If you'd like to install WhatPulse using the terminal or homebrew, check out the last chapters on this page.

Installation steps​

  1. Navigate to the Downloads.
  2. Click the Download for Mac button.
  3. Open the downloaded whatpulse-mac-latest.dmg file.
  4. Open the installer application.
  5. Click Open on the an app downloaded from the internet macOS warning and follow the prompts to complete the installation.
  6. After you complete the installation, enable system permissions: 2. Click Open Accessibility>>Open Sytem Preference. 3. In the Security and Privecy window, from the left navigation pane, click Accessibility. 5. Click the lock icon and enter your system password. 6. Select the WhatPulse checkbox on the Accessibility panel. 3. From the left navigation pane, click Input Monitoring, and select the WhatPulse checkbox. 4. Click the Quit & Reopen button to restart WhatPulse.

After you complete the installation and enable system permissions, you are greeted by the welcome screen. Now, you can choose to log in to an existing account or create a new one.

Creating a New WhatPulse Account​

  1. Click "Register Account" and click Continue. The WhatPulse website opens in a new browser tab.
  2. Complete the registration form and activate your account.
  3. After you activate your account, you can create a new computer profile. The website will show you how to create this computer profile and link it to the computer you're installing WhatPulse.
  4. When the computer profile is created, the WhatPulse software automatically logs in and start monitoring your stats.

Using an Existing WhatPulse Account​

  1. In the WhatPulse client Welcome screen, click on Login. The WhatPulse website opens in a new browser tab.
  2. Sign in to your WhatPulse account.
  3. In the Authorize Client page, do one of the following:
    • If you are reinstalling WhatPulse on a computer that you have used before, click Use an existing Computer.
    • If it's a new computer, click Create a new computer.
  4. After you select or create a create a computer profile, the WhatPulse client automatically log in and start monitoring your stats.

Installing via Homebrew​

If you prefer using Homebrew, a package manager for macOS, you can easily install WhatPulse by following these steps:

  1. Open Terminal on your macOS. You can find it by going to Spotlight (press Cmd + Space) and typing "Terminal".
  2. If you haven't installed Homebrew yet, run the following command in Terminal:
    1. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  3. Once Homebrew is installed, you can use the following command to install WhatPulse:
    1. brew install --cask whatpulse/whatpulse/whatpulse
  4. Wait for Homebrew to download and install the WhatPulse package. The installation process will automatically handle all necessary dependencies.
  5. WhatPulse will open when it's done installing. When it's open, you can refer to Creating a New WhatPulse Account or Using an Existing WhatPulse Account to log into WhatPulse and start collecting statistics.

Congratulations! You have successfully installed WhatPulse using Homebrew on macOS.

Installing via the Terminal​

If you prefer to install WhatPulse on macOS using the installer instead of Homebrew, you can follow these steps:

  1. Navigate to the Downloads.
  2. Click the Download for Mac button.
  3. Once the download is complete, locate the downloaded .dmg file in your Downloads folder or the designated download location.
  4. Double-click on the downloaded .dmg file to open and mount it.
  5. Open Terminal on your macOS. You can find it by going to Spotlight (press Cmd + Space) and typing "Terminal".
  6. In Terminal, run the following command, replacing VERSION with the appropriate version number:
    1. /Volumes/WhatPulse\ VERSION/WhatPulse-VERSION-Installer.app/Contents/MacOS/WhatPulse-VERSION-Installer --root /Applications/WhatPulse --accept-messages --accept-licenses --confirm-command install
  7. Wait for the installation process to complete. Once finished, you can close Terminal.
  8. WhatPulse will open when it's done installing. When it's open, you can refer to Creating a New WhatPulse Account or Using an Existing WhatPulse Account to log into WhatPulse and start collecting statistics.

Congratulations! You have successfully installed WhatPulse on macOS using the installer.

note

When you are using remote deployment tools, you can download the latest WhatPulse installer to a central file repository from where the remote computers can retrieve it for their installation.