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

# Immersive Translate

> Immersive Translate Browser Extension Integration Guide

## Introduction

Immersive Translate is an excellent browser translation extension that supports bilingual reading of web pages. By integrating MixRoute API, you can leverage powerful AI models for more accurate and natural translations.

## Quick Installation

### Supported Browsers

* Chrome / Edge / Brave
* Firefox
* Safari

### Installation Steps

1. Visit your browser's extension store
2. Search for "Immersive Translate"
3. Click "Install" and add to browser toolbar
4. Or visit [Immersive Translate official site](https://immersivetranslate.com/)

## Configure Mixroute Api

<Steps>
  <Step title="Open Settings">
    Click the extension icon in browser toolbar, select "Settings"
  </Step>

  <Step title="Select Translation Service">
    In left menu, click "Translation Service", find "OpenAI"
  </Step>

  <Step title="Fill Configuration">
    * **APIKEY**: Your Mixroute Api key
    * **Custom API URL**: `https://api.mixroute.ai/v1/chat/completions`
    * **Custom Model**: Optional (e.g., `gpt-5.5`)
  </Step>
</Steps>

## Core Features

### 1. Web Page Translation

**Auto Translation**

* Auto-detects language when visiting foreign pages
* Click toolbar "Translate" button for full page translation

**Manual Translation**

* Click extension icon, select "Translate This Page"

### 2. Translation Modes

<CardGroup cols={2}>
  <Card title="Bilingual (Recommended)" icon="columns">
    Preserves original format, translation shown below original text. Great for learning and term verification.
  </Card>

  <Card title="Translation Only" icon="file-lines">
    Completely replaces original text. Good for quick reading.
  </Card>
</CardGroup>

### 3. Highlight Translation

* Select text, click popup "Translate" button
* Supports copy, pronunciation and more

## Advanced Settings

### 1. Custom Prompts

<Tabs>
  <Tab title="Technical Docs">
    ```text theme={null}
    As a technical documentation translation expert:
    1. Preserve all technical terms in original language
    2. Provide Chinese explanation in parentheses
    3. Keep code and commands in original format
    ```
  </Tab>

  <Tab title="Academic Papers">
    ```text theme={null}
    As an academic translation expert:
    1. Use academic standard expressions
    2. Preserve citation format
    3. Accurately translate professional terminology
    ```
  </Tab>

  <Tab title="Literature">
    ```text theme={null}
    As a literary translation expert:
    1. Maintain the literary beauty of the original
    2. Pay attention to cultural context conversion
    3. Preserve rhetorical effects
    ```
  </Tab>
</Tabs>

### 2. Translation Rules

Set auto-translation for specific sites:

1. Go to "Translation Rules" settings
2. Add website domain (e.g., `en.wikipedia.org`)
3. Select behavior: Always translate / Never translate / Smart detect

### 3. Style Customization

```css theme={null}
.immersive-translate-target {
    font-family: "Microsoft YaHei", sans-serif;
    font-size: 14px;
    color: #333;
}

.immersive-translate-target-wrapper {
    background-color: #f5f5f5;
    padding: 5px;
    margin: 5px 0;
    border-radius: 3px;
}
```

## Special Features

### 1. PDF Translation

* Supports online PDF document translation
* Maintains original format, bilingual display

### 2. Video Subtitle Translation

Supports YouTube, Netflix, Bilibili and more:

1. Enable "Video Subtitle Translation"
2. Select subtitle display mode
3. Adjust subtitle style

### 3. E-book Translation

* Upload EPUB format e-books
* Select translation language and mode
* Download bilingual version

### 4. Input Box Translation

* Type text in input box
* Press `Alt + S` to trigger translation
* One-click replace with translation

## Keyboard Shortcuts

| Function                | Default Shortcut |
| ----------------------- | ---------------- |
| Translate/Show Original | `Alt + T`        |
| Toggle Translation Mode | `Alt + M`        |
| Translate Selected Text | `Alt + S`        |
| Open Settings           | `Alt + O`        |

## Performance Optimization

### 1. Cache Settings

* Enable "Translation Cache"
* Set cache duration (recommended 24 hours)

### 2. Batch Translation

* Adjust batch size (5-10 paragraphs/batch)
* Set reasonable concurrency (2-3)

### 3. Trigger Conditions

* Minimum translation length: 10 characters
* Ignore nav menus, ads, etc.
* Delay translation: 200ms

## FAQ

<AccordionGroup>
  <Accordion title="Translation Failed">
    * Verify API key is correct
    * Check network connection
    * Refresh page or switch translation mode
    * Open console (F12) to check error logs
  </Accordion>

  <Accordion title="Slow Translation">
    * Switch to faster model (e.g., `gpt-5.5`)
    * Reduce text per translation
    * Enable caching
    * Check network latency
  </Accordion>

  <Accordion title="Format Issues">
    * Toggle between "Bilingual" and "Translation Only" modes
    * Adjust translation layout style
    * Add custom translation rules for the site
  </Accordion>
</AccordionGroup>

## Best Practices

### Optimize Reading Experience

* Choose clear fonts (Microsoft YaHei, Source Han Sans)
* Increase contrast between translation and original
* Set line spacing to 1.5x

### Learning Assistance

* Use "Bilingual" mode for comparative learning
* Use highlight translation for professional terms
* Export translations for review

### Cost Control

* Use `gpt-5.4-mini` for daily browsing
* Use `gpt-5.5` or Claude for important documents
* Leverage caching to reduce repeated translations