> 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/)
