Installing the Replay Browser

Installing the Replay Browser is only required to record replays. If you’ve received a link to an existing replay, open it in any browser and skip straight to debugging.
Our default Replay Browser is a fork of Firefox. We have a beta version of Chromium that you can download on Linux today (Mac and Windows support coming soon).
To start recording your own replays, you first need to install the Replay Browser.
  1. Go to replay.io and download Replay for either Mac, Linux, or Windows.
  1. Install Replay like you would any other native application on your computer.
  1. Open Replay and create an account.

Importing browser settings

Image without caption
The first time you open the Replay Browser, you may be prompted to import your settings and data from another browser. This is not required, but may be helpful if you want access to data like saved passwords while recording with Replay.
You can also import these later by selecting File > Import From Another Browser in the Replay Browser menu.

Installing on Linux

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.

Installing on Windows

Replay has both a Windows installer and supports WSL. Check out the Windows Support guide for getting set up.

Installing Replay Chromium

Replay Chromium is currently in beta for Linux only, with these limitations: - The browser does not have login functionality or a β€œRecord” button - All tabs are automatically recorded to disk for as long as it runs. - Recordings are saved to your home directory and must be manually uploaded using the Replay CLI for debugging. - During both, recording and replaying, you will likely encounter some bugs.
Use these manual installation steps:
  1. Download the latest Replay Chromium build https://static.replay.io/downloads/linux-replay-chromium.tar.xz
  1. Extract the archive: tar xf linux-replay-chromium.tar.xz
  1. To record: cd replay-chromium and run ./chrome or ./chrome https://example.com
      • Note: It starts recording all tabs to disk immediately.
      • You can now interact with the website to produce the desired recording.
      • Recording will stop once you close Replay Chromium.
Initial setup before uploading recordings:
  1. Globally install the Replay CLI package:npm i -g @replayio/replay
  1. Create a Replay API access token using the β€œSettings” dialog in the Replay UI.
  1. Set the API key in your shell: export RECORD_REPLAY_API_KEY=$TheApiToken
To upload recordings:
  1. List recordings that have been saved locally: replay ls . View the list of recordings, find the correct recording based on the β€œURL” column, and copy the recording ID.
  1. Upload the recording: replay upload $RECORDING_ID
  1. Once uploaded, the CLI shows you a link where you can replay your recording as usual.