> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mavioapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Browser Extension

> Record browser-based meetings with one click using the Mavio Chrome extension.

The Mavio browser extension adds a one-click recording button to your browser. It captures audio from browser-based meetings without adding a bot to your call — other participants will not see any additional participant join.

## Installation

<Steps>
  <Step title="Install from Chrome Web Store">
    Visit the [Mavio extension](https://chrome.google.com/webstore) on the Chrome Web Store and click **Add to Chrome**.
  </Step>

  <Step title="Pin the extension">
    Click the puzzle piece icon in Chrome's toolbar and pin **Mavio** for easy access.
  </Step>

  <Step title="Sign in">
    Click the Mavio icon and sign in with your Mavio account.
  </Step>
</Steps>

The extension works with Google Chrome, Microsoft Edge, Brave, Arc, and any Chromium-based browser.

## How to record

### One-click recording

1. Join a meeting in your browser (Google Meet, Zoom web, Teams web, etc.).
2. Click the Mavio icon in the toolbar.
3. Click **Start Recording**.
4. A small recording indicator appears on the tab.
5. Click **Stop Recording** when done, or close the meeting tab.

### Auto-recording

Configure the extension to start recording automatically when it detects a meeting:

1. Click the Mavio icon > **Settings**.
2. Toggle **Auto-record meetings** on.
3. Select platforms: Google Meet, Zoom, Teams, or all.

When you navigate to a meeting URL, recording starts automatically.

<Tip>
  Auto-recording is useful if you frequently forget to start recording. The extension detects meeting URLs based on domain patterns (meet.google.com, zoom.us, teams.microsoft.com).
</Tip>

## Extension popup

Click the Mavio icon to access:

| Feature                    | Description                                           |
| -------------------------- | ----------------------------------------------------- |
| **Start / Stop Recording** | Control recording for the current tab                 |
| **Recent Meetings**        | Quick links to your latest recordings                 |
| **Action Items**           | Your open action items at a glance                    |
| **Mavio AI**               | Ask a quick question about a recent meeting           |
| **Settings**               | Configure auto-recording, microphone, and preferences |

## Including your microphone

By default, the extension captures only the tab audio (remote participants). To include your own voice:

1. Click the Mavio icon during a recording.
2. Toggle **Include microphone** on.
3. Grant microphone permission if prompted by Chrome.

With microphone enabled, the extension mixes your voice with the tab audio so the full conversation is captured.

<Note>
  The microphone toggle is per-session. You can set the default in **Settings > Always include microphone**.
</Note>

## Meeting detection

The extension automatically detects when you are on a supported meeting page and shows a contextual banner:

* **Google Meet** — detected on `meet.google.com/*`
* **Zoom** — detected on `*.zoom.us/j/*` and `*.zoom.us/wc/*`
* **Microsoft Teams** — detected on `teams.microsoft.com/*`
* **Webex** — detected on `*.webex.com/*`

For unsupported platforms, you can still record by clicking the Mavio icon and selecting **Record this tab**.

## Keyboard shortcuts

| Action               | Shortcut          |
| -------------------- | ----------------- |
| Start/stop recording | `Alt + Shift + R` |
| Toggle microphone    | `Alt + Shift + M` |
| Open Mavio popup     | `Alt + Shift + F` |

Customize shortcuts in Chrome at `chrome://extensions/shortcuts`.

## Permissions explained

When you install the extension, Chrome asks for these permissions:

| Permission                | Why Mavio needs it                                   |
| ------------------------- | ---------------------------------------------------- |
| **Tab audio capture**     | To record audio from the meeting tab                 |
| **Active tab**            | To detect meeting URLs and show the recording banner |
| **Storage**               | To save your preferences and session data locally    |
| **Microphone** (optional) | Only requested when you enable "Include microphone"  |

The extension does **not** access your browsing history, passwords, form data, or any other tabs.

## Extension vs. meeting bot

|                           | Browser extension                    | Meeting bot                        |
| ------------------------- | ------------------------------------ | ---------------------------------- |
| **Visible to others**     | No                                   | Yes (appears as a participant)     |
| **Requires installation** | Yes (Chrome extension)               | No                                 |
| **Works in desktop apps** | No (browser only)                    | Yes                                |
| **Captures your voice**   | Optional (toggle microphone)         | Yes (from the meeting audio)       |
| **Supported browsers**    | Chromium-based only                  | Any (joins via meeting link)       |
| **Best for**              | Discreet recording, browser meetings | Automatic recording, all platforms |

## Troubleshooting

<AccordionGroup>
  <Accordion title="No audio is captured">
    Ensure the meeting tab is not muted in Chrome (right-click the tab, check for "Unmute tab"). Also verify no other extension is blocking audio capture.
  </Accordion>

  <Accordion title="Extension icon is not visible">
    Click the puzzle piece icon in Chrome's toolbar and pin the Mavio extension.
  </Accordion>

  <Accordion title="Auto-record does not trigger">
    Verify auto-recording is enabled for the correct platform in the extension settings. If using a custom meeting URL that does not match the standard patterns, use manual recording.
  </Accordion>

  <Accordion title="Chrome asks for permissions repeatedly">
    This can happen after Chrome updates. Click **Allow** when prompted. If the issue persists, remove and reinstall the extension.
  </Accordion>
</AccordionGroup>