Installing the Replay browser
To start recording your own replays, you first need to install the Replay Browser. There are several ways to install it.
Installing the Replay Browser is only required to record replays. If you want to view an existing replay, open it in any browser and skip straight to debugging.
Replay Chrome is currently built for automated recordings with tools like Playwright and Cypress so it does not have a record button yet. If you would like to use Chrome to record a replay, you can use the
npm i @replayio/replay -g
We recommend installing the Replay CLI globally. This will add
replay to your path so you can skip
npx and just call
To open Replay type following command into your terminal
replay record http://localhost:3000
http://localhost:3000 is the URL of an application that you want to start recording. Recording will automatically stop when you close the browser. To check list of all your recordings type
replay ls into your terminal. To see more details on how to use Replay CLI, follow these docs.
To instal Replay Browser for Mac, follow these steps:
- Download Replay browser here (opens in a new tab)
.dmgfile and drag Replay Browser icon to your Applications folder
- Open Replay Browser from your Applications folder
To install our Windows build, follow these steps:
- Download Replay Browser for Windows (BETA) here (opens in a new tab)
- Unzip the folder.
- Open the folder in File Explorer and open replay.exe. The Replay Browser should now launch.
Note: If you use Virus/Threat protection software, you may need to update the software to exclude the Replay Browser before using.
To install Linux version, download Replay Browser for Linux here (opens in a new tab)
You will need to install
libgtk version 3.0 (for libgtk-3.so.0) and
libdbus-glib version 1.2 (for libdbus-glib-1.so.2). These may already be installed on your distribution if you use Ubuntu or Fedora. If you have Firefox installed, then you already have these shared libraries.
A simple way to get setup on most Linux distributions is to first install Firefox which will install the necessary dependencies. After that, it should be easy to download Replay and get started.
Check out our Linux Support guide for more details.