Install Refract

This guide gets Refract downloaded, installed, and logged in on Windows or Mac.

System requirements

• Memory (RAM): 4 GB

• Disk space: 5 GB

• Windows 10/11, Windows Server 2016 or newer, or macOS 12 (Monterey) or newer

Download the app

Downloads live in the Download tab of the dashboard: dashboard.refractbot.com/download. Choose the version that matches your device and it will download.

One Windows download, two Mac downloads. Pick the one that matches your device.

The installer is roughly 101 MB, so the download can take a while on slower networks. Give it time before assuming it failed.

Download not starting? Make sure you click Allow if your browser asks about popups or downloads from the dashboard. If it still will not download, try a new Chrome user: click your profile picture in the top right of Chrome, add a new profile, and download from there.

Install and log in

Windows

1

Download for Windows

On the Download tab, click Download for Windows.

2

Run the installer

Open the downloaded refract.exe file. You can also find it in File Explorer > Downloads. Follow the on-screen instructions.

3

Log in

Log in with the same email and password you use for the dashboard. Refract does not use license keys; your account is your license.

Mac

1

Pick your Mac version

There are two Mac downloads. Click the Apple menu and choose About This Mac to check yours: an Apple M1/M2/M3/M4 chip means Download for Apple Silicon, and an Intel processor means Download for Intel.

2

Run the installer

Open the downloaded file and follow the on-screen instructions.

3

Log in

Log in with the same email and password you use for the dashboard. Refract does not use license keys; your account is your license.

If the login details are correct, Refract opens and you are presented with the bot. You are ready to move on to setup.

Task Creation

FAQ

I lost access to my email, can I still log in?

Yes. Logging in takes your email address and your password, and nothing is sent to your inbox to complete it, so you can sign into the dashboard and the bot as normal without being able to open that inbox.

Your account email itself is never changed. Refract accounts are bound to the email they were purchased with, and that applies no matter why the inbox is gone, including a hacked, stolen, or deleted email account. Keep using the same email address and password.

If you need a new password, you can request the reset from inside the dashboard and have the link sent to an email you can access:

Refract shows in the taskbar, but the window is not on my screen

The app is running (it shows in the taskbar and Task Manager), but the window has ended up off screen, usually after a monitor change. On Windows, here is how to bring it back (video walkthrough):

1. Click the Refract icon in the taskbar so the window is selected.

2. Press Alt + Spacebar to open the window menu.

3. Press M to choose Move.

4. Tap any arrow key once, then move your mouse: the window sticks to the cursor. Drag it somewhere visible and click (or use the arrow keys alone and press Enter).