> For the complete documentation index, see [llms.txt](https://docs.vntranslator.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vntranslator.com/user-guide/clipboard.md).

# Clipboard

The Clipboard feature automatically translates any text copied to the clipboard.

## How to Translate Any Text with Clipboard

The Clipboard feature automatically translates any text copied to your clipboard, in real time - not just from games, but from any application on your computer.

***

### How It Works

When you copy text to your clipboard from any source, VNTranslator automatically detects it and displays the translation in the Extra Window. This works with any application on your computer, without needing to switch windows or paste anything manually.

***

### What You Can Translate

The Clipboard Translator works with:

* Visual novels and games that have a "Copy Text to Clipboard" feature
* Third-party applications or game mods that support clipboard copying
* Text from websites in any web browser
* Chat applications and messaging platforms
* Documents and text files from any program
* Any other application that supports text selection and copying

***

### Getting Started

<figure><img src="https://4121582948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKz66WcKqTPRwdFrHi4mM%2Fuploads%2FqPiQUefqplNSUJnszzxC%2Fstep-clipboard.png?alt=media&amp;token=27be321f-31ff-40b7-aa8e-77fade4d6d38" alt=""><figcaption></figcaption></figure>

1. Select **Clipboard** from the module list
2. Select **Extra Window** from the output list
3. Click the **Start** button

***

### Integration with Games

Many visual novels and PC games include a built-in clipboard copy feature. When playing these games, simply use their copy function, and VNTranslator will translate the text automatically without any additional setup.

Ren'Py games in particular have two dedicated Clipboard-based methods - the RenPy Clipboard Plugin and Clipboard Voicing - covered in detail in the [Ren'Py Games guide](/user-guide/renpy-games.md).

***

### FAQ: Translating Text with Clipboard

<details>

<summary><strong>What is the Clipboard feature in VNTranslator?</strong></summary>

Clipboard is a VNTranslator module that automatically translates any text copied to your clipboard and displays the result in the Extra Window, in real time. It works across any application on your computer, not just games.

</details>

<details>

<summary><strong>Does Clipboard translation only work with games?</strong></summary>

No. While it's commonly used with visual novels and PC games that support clipboard copying, Clipboard translation works with any application that lets you copy text, including web browsers, chat apps, documents, and text files.

</details>

<details>

<summary><strong>Where does the translated text appear?</strong></summary>

Translated text appears in the [Extra Window](/features/extra-window.md), which needs to be selected as the output when starting the Clipboard module.

</details>

<details>

<summary><strong>Why isn't my copied text being translated?</strong></summary>

Check that both **Clipboard** is selected from the module list and **Extra Window** is selected from the output list before clicking Start. If translation still doesn't appear, confirm the source application actually copies text to the clipboard when you use its copy function.

</details>

<details>

<summary><strong>What's the difference between Clipboard and OCR?</strong></summary>

Clipboard translation reads text that's been copied to the clipboard, either manually or through an application's built-in copy feature. OCR instead captures text directly from the screen, which makes it useful for games or applications that don't support clipboard copying.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.vntranslator.com/user-guide/clipboard.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
