Iris

Browser extension

The Iris extension records the current browser tab plus audio, and (on Chrome) tracks clicks, typing, navigation, and tab switches as ground-truth user actions. Everything streams up to Iris when you stop recording.

Install

  • Chrome: install from the Chrome Web Store, or load the unpacked build from extensions/chrome/dist in developer mode.
  • Firefox: install from Firefox Add-ons, or load the temporary add-on from extensions/firefox/dist.

First-time setup

Open the extension’s options page and:

  1. Click Log in — a browser tab opens for OAuth/email login. The extension polls for completion and saves the session token.
  2. (Optional) In Advanced, set the API URL to your self-hosted server. Defaults to the public URL the extension was built against.
  3. (Optional) Paste an API key from the Integrations page if you prefer programmatic credentials over a session token.

Recording

Click the Iris toolbar icon. You get a 3-second countdown, then a floating bar appears with stop/pause controls. Pin the extension if you don’t see it.

On Firefox, system audio isn’t captured by default — the recording will be silent unless you enable microphone capture in the bar.

What gets uploaded

  • The video (WebM, 1080p where possible).
  • An action log: clicks, typing (without password fields), navigations, tab/app switches, scrolls.
  • The active tab URL at each event timestamp.

The upload happens after you stop. If your network drops mid-upload, the extension keeps the recording in IndexedDB and offers to retry on next launch.

Permissions

The extension requests tabCapture and activeTab for screen capture, plus storage for credentials. The content script is restricted to https://* and http://localhost; we never inject into about: or other browser-internal pages.

Found a gap or a typo? Open an issue or PR on GitHub.