# Installation Guide

This guide explains how to install Ultimate Text Selection Translator on supported browsers.

## Step 1 — Install a Userscript Manager

I recommend **Tampermonkey**, which provides the best compatibility with Ultimate Text Selection Translator.

<table>
  <thead>
    <tr>
      <th>Browser</th>
      <th>Recommended userscript manager(s)</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/chrome/chrome-original.svg" width="16" alt="Chrome"> Chrome</td>
      <td><strong><a href="https://www.tampermonkey.net/">Tampermonkey</a></strong> · <a href="https://violentmonkey.github.io/">Violentmonkey</a></td>
    </tr>
    <tr>
      <td><img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/firefox/firefox-original.svg" width="16" alt="Firefox"> Firefox</td>
      <td><strong><a href="https://www.tampermonkey.net/">Tampermonkey</a></strong> · <a href="https://violentmonkey.github.io/">Violentmonkey</a></td>
    </tr>
    <tr>
      <td><img src="https://upload.wikimedia.org/wikipedia/commons/9/98/Microsoft_Edge_logo_%282019%29.svg" width="16" alt="Edge"> Edge</td>
      <td><strong><a href="https://www.tampermonkey.net/">Tampermonkey</a></strong> · <a href="https://violentmonkey.github.io/">Violentmonkey</a></td>
    </tr>
    <tr>
      <td><img src="https://cdn.simpleicons.org/brave" width="16" alt="Brave"> Brave</td>
      <td><strong><a href="https://www.tampermonkey.net/">Tampermonkey</a></strong> · <a href="https://violentmonkey.github.io/">Violentmonkey</a></td>
    </tr>
    <tr>
      <td><img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/opera/opera-original.svg" width="16" alt="Opera"> Opera</td>
      <td><strong><a href="https://www.tampermonkey.net/">Tampermonkey</a></strong> · <a href="https://violentmonkey.github.io/">Violentmonkey</a></td>
    </tr>
    <tr>
      <td><img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/safari/safari-original.svg" width="16" alt="Safari"> Safari</td>
      <td><a href="https://apps.apple.com/app/userscripts/id1463298887">Userscripts</a> · <a href="https://www.tampermonkey.net/">Tampermonkey</a></td>
    </tr>
  </tbody>
</table>

## Step 2 — Install Ultimate Text Selection Translator

Open the **[Ultimate Text Selection Translator page on GreasyFork](https://greasyfork.org/en/scripts/536284-ultimate-text-selection-translator-instantly-translate-any-selected-text)**.

Click **Install this script**, then confirm the installation in your userscript manager.

## Step 3 — Start Translating

Select any text on a webpage and translate it instantly using either:

- **Your configured keyboard shortcut** (default: **Ctrl + L**)
- **The floating translation button** that appears next to selected text

The keyboard shortcut can be changed at any time from the script settings, and the floating translation button can also be enabled or disabled globally or on a per-site basis.

## Updating

Most userscript managers automatically check for script updates.

You can also manually check for updates from your userscript manager dashboard.

## Need More Help?

If you're experiencing issues, please open a **[GitHub Issue](https://github.com/DREwX-code/Ultimate-Text-Selection-Translator/issues)** or leave feedback on **[GreasyFork](https://greasyfork.org/en/scripts/536284-ultimate-text-selection-translator-instantly-translate-any-selected-text/feedback)**.