# Installation

::: info News
🍎 **Safari Native Extension is launched!** It is completely free and supports one-click installation.
:::

Choose your path.

> ⚠️ Note: Prompt Manager is the only feature that supports Gemini™ for Enterprise.

## 1. Extension Stores (Recommended)

The simplest way to get started. Updates are automatic.

**Chrome / Brave / Opera / Vivaldi:**

[<img src="https://img.shields.io/badge/Chrome_Web_Store-Download-4285F4?style=for-the-badge&logo=google-chrome&logoColor=white" alt="Install from Chrome Web Store" height="40"/>](https://chromewebstore.google.com/detail/iifacdnjakkhjjiengaffnegbndgingi?utm_source=github&utm_medium=docs&utm_campaign=organic_growth&utm_content=en)

**Microsoft Edge:**

[<img src="https://img.shields.io/badge/Microsoft_Edge-Download-0078D7?style=for-the-badge&logo=microsoft-edge&logoColor=white" alt="Install from Microsoft Edge Add-ons" height="40"/>](https://microsoftedge.microsoft.com/addons/detail/gemini-voyager/gibmkggjijalcjinbdhcpklodjkhhlne)

**Firefox:**

[<img src="https://img.shields.io/badge/Firefox_Add--ons-Download-FF7139?style=for-the-badge&logo=firefox&logoColor=white" alt="Install from Firefox Add-ons" height="40"/>](https://addons.mozilla.org/firefox/addon/gemini-voyager/)

## 2. The Manual Way (Latest Features)

The Web Store review process can be slow. If you want the cutting-edge version immediately, install manually.

**For Chrome / Edge / Brave / Opera:**

1. Download the latest `gemini-voyager-chrome-vX.Y.Z.zip` from [GitHub Releases](https://github.com/Nagi-ovo/gemini-voyager/releases).
2. Unzip the file.
3. Open your browser's Extensions page (`chrome://extensions`).
4. Enable **Developer mode** (top right).
5. Click **Load unpacked** and select the folder you just unzipped.

**For Firefox:**

1. Download the latest `gemini-voyager-firefox-vX.Y.Z.xpi` from [Releases](https://github.com/Nagi-ovo/gemini-voyager/releases).
2. Open the Add-ons Manager (`about:addons`).
3. Drag and drop the `.xpi` file to install (or click the gear icon ⚙️ -> **Install Add-on From File**).

> 💡 The XPI file is officially signed by Mozilla and can be permanently installed in all Firefox versions.

## 3. Safari (macOS)

Safari now supports direct distribution! Download the pre-signed app:

1. Download the <SafariDownloadLink>latest Safari version (.dmg)</SafariDownloadLink>.
2. Double-click to open and follow the prompts to install.
3. Double-click to launch the app.
4. Enable the extension in **Safari Settings > Extensions**.

> 💡 The Safari build is now directly signed for distribution—no Xcode conversion needed!
>
> ⚠️ **Limitations**: Due to Safari's nature, (a) Watermark removal (b) Image export (PDF recommended) are not supported.

---

_Development setup? If you are a developer looking to contribute, check out our [Contributing Guide](https://github.com/Nagi-ovo/gemini-voyager/blob/main/.github/CONTRIBUTING.md)._