> 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/features/extensions/text-to-speech/voicevox.md).

# VoiceVox

{% hint style="info" %}
**VoiceVox** is an offline TTS engine developed for Japanese speech synthesis. It supports a wide range of voice characters and runs on CPU without requiring a GPU.
{% endhint %}

### Installation

This guide uses **VoiceVox Engine version 0.25.1**. Steps may differ slightly for other versions.

**Step 1 - Download VoiceVox Engine**

* Go to the VoiceVox Engine releases page:\
  <https://github.com/VOICEVOX/voicevox_engine/releases>
* Find version **0.25.1** and download the **Windows (CPU版)** file

**Step 2 -** Extract the Downloaded File

Once the download is complete, extract the downloaded file to a folder of your choice.

The extracted folder structure will look like this:

```
voicevox_engine-windows-cpu-0.25.1\
└── windows-cpu\
    ├── run.exe
    ├── resources\
    └── ...
```

**Step 3 - Run VoiceVox**&#x20;

To start VoiceVox, navigate to the `windows-cpu` folder and **double-click** `run.exe`.

```
voicevox_engine-windows-cpu-0.25.1\windows-cpu\run.exe
```

***

### Integrating with VNTranslator

After VoiceVox server is running, follow these steps to connect it with VNTranslator:

* Go to **Settings -> Extensions -> Text to Speech**
* Scroll to the **VoiceVox** settings section
* Enter the **Host** and **Port** of your running VoiceVox server. By default, these are already set to:
  * **Host:** `http://localhost`
  * **Port:** `50021`
* Enter the **Resource Path** - The path to the `resources` folder inside your extracted VoiceVox Engine folder. For example: \
  `path\to\voicevox_engine-windows-cpu-0.25.1\windows-cpu\resources`

{% hint style="info" %}
The **Resource Path** is used to display voice character avatars and play audio samples directly within VNTranslator. If left empty, avatars and audio previews will not be available.
{% endhint %}

{% hint style="warning" %}
Make sure the VoiceVox server is running **before** launching a game in VNTranslator. If the server is not running, TTS playback will not work.
{% endhint %}

***

### References

* [VoiceVox Engine GitHub Releases](https://github.com/VOICEVOX/voicevox_engine/releases)
* [VoiceVox Official Website](https://voicevox.hiroshiba.jp/)


---

# 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 dynamically by asking a question.

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

```
GET https://docs.vntranslator.com/features/extensions/text-to-speech/voicevox.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.