# Getting Started

This guide walks you through the initial setup and basic usage of VNTranslator.

<div align="left"><figure><img src="https://4121582948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKz66WcKqTPRwdFrHi4mM%2Fuploads%2FgP5ach9tt2AqbqqrBNbq%2Finterface-launcher.png?alt=media&#x26;token=48d0440f-06b0-48ce-aed3-cc555ffdb749" alt=""><figcaption></figcaption></figure></div>

{% stepper %}
{% step %}

### Install the App

If you haven't installed VNTranslator yet, refer to the [Download & Installation](https://docs.vntranslator.com/getting-started/download-and-installation) section.
{% endstep %}

{% step %}

### Launch VNTranslator

After installation:

* Open **VNTranslator**
* The **VNTranslator Launcher** window will appear
  {% endstep %}

{% step %}

### Configure Translation Settings

Configure the translator and languages:

* Click **Translator** in the menu bar and select a **Translation Service**
* Select the **Source Language**
* Select the **Target Language**
  {% endstep %}

{% step %}

### Basic Usage

**Quick Start Example: Using Clipboard**

* Select **Clipboard** from the module list&#x20;
* Select **Extra Window** from the output list&#x20;
* Click the **Start** button&#x20;
* Copy any text - the translation appears automatically
  {% endstep %}
  {% endstepper %}

***

## Launcher Interface

The launcher interface is divided into three main sections:

#### **Menu Bar (Top Section)**

* **App icon** (left corner):
  * Translation Editor - Edit and manage translations
  * Settings - Open settings
  * Relaunch - Relaunch the app
  * Exit - Close the app
* **Translator** - Configure and select translation services
* **Glossary** - Manage custom translation dictionaries
* **About** - App information and version details

#### **Translation Control (Middle Section)**

* **Source Language** - Select the language to translate from
* **Start Button** - Begin or stop the translation process
* **Target Language** - Select the language to translate to

#### **Module Configuration (Bottom Section)**

* **Settings button** (left corner) - Open module settings
* **Module Selection**\
  Choose the input method from the module list:
  * [**Clipboard**](https://docs.vntranslator.com/user-guide/clipboard) **-** Translate text copied to your clipboard
  * [**OCR**](https://docs.vntranslator.com/user-guide/ocr) **-** Capture and translate text from your screen (images/games)
  * [**AutoTrans**](https://docs.vntranslator.com/user-guide/autotrans) **-** Automatically translate text directly in games
* **Module Options**\
  These settings vary depending on the selected module:
  * **Clipboard**: No additional options required
  * **OCR**: Select an OCR engine and language
  * **AutoTrans**: Click Browse and select the game executable file
* **Output Options**

  Available output methods vary by module:

  * **Clipboard**: [Extra Window](https://docs.vntranslator.com/features/extra-window)
  * **OCR**: [Extra Window](https://docs.vntranslator.com/features/extra-window) or [Hyper Overlay](https://docs.vntranslator.com/features/hyper-overlay)
  * **AutoTrans**: In-game injection (displays translated text directly in the game)
* **Logs button** (right corner) - Open logs folder


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vntranslator.com/getting-started/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.