Azalea

Azalea(アザレア) is a simple and (relatively) lightweight unofficial GUI for VOICEVOX, a Japanese only TTS app. The Author aims to provide a simple and easy-to-use interface for VOICEVOX, with his own personal touch.

Warning

🚧 This project is still in development and is not ready for production use. 🚧

Installation

We don't provide a pre-built binary yet, as the project is still in heavy development. You can build it yourself by following the instructions below.

Important

According to here, bun has a bug on non-Linux platforms. The issue is with css-tree which UnoCSS depends on. Before it gets fixed, we will be using pnpm instead.

Development

Prerequisites

• Rust
• pnpm
• mold and clang, if you're on Linux
• tauri prerequisites

Setting up the core

Using VOICEVOX

If you have VOICEVOX installed, you already have a core. You can find it in the vv-engine directory under the VOICEVOX installation directory.

Using the official downloader

You can refer to the official VOICEVOX documentation (Japanese), download their script and execute it. The downloaded artifacts will be located in the voicevox_core directory.

Manually downloading

• Download the core from the VOICEVOX releases and extract it to a directory.
• Download the OpenJTalk dictionary from the OpenJTalk releases and extract it to the same directory.

The directory should look like this:

your_dir/
- voicevox_core_*
    - libvoicevox_core.so
    - libonnxruntime.so
    - ...
    - open_jtalk_dic_utf_8/
        - *.def
        - ...

Note

It would be .dylib for MacOS and .dll for Windows.

Setting the dev config

The config file used in development is located in config_dev/config.json. You can set the core path in the GUI launched by pnpm tauri dev and this file will be created automatically.

If you want to manually modify the config file, we also provide a config_dev/config.template.json, copy it to config_dev/config.json and modify it as below:

{"core_config":{"core_path":"/path/to/core","ojt_path":null,"cache_size":1024}}

Note

The ojt_path is not functional yet.

Setup

git clone https://github.com/Patchethium/Azalea.git
cd Azalea
# install the dependencies
pnpm i
# dev build
pnpm tauri dev
# production build
pnpm tauri build
# You may also want to clean the artifacts after building, it's 10 GB or so
cd src-tauri
cargo clean
# Frontend lint&format, dev only
pnpm check

Pitch Range

Azalea comes with a pre-computed pitch range for every speakers in VOICEVOX, for a higher utilization of the tuning panel space. The pitch range is computed by $\mu \pm 3\sigma$ of the pitch data of each speaker, where $\mu$ is the mean and $\sigma$ is the standard deviation.

Every time the core gets updated, we need to recompute the pitch range, by

cd src-tauri
cargo bench

Contributing

Azalea welcomes PRs, please open an issue before making one, as in the early stage, running git push --force is common for me.

I can read and write directly in Japanese and English, feel free to reach out to in any of these languages.

License

GPLv3 or later.

Credits

A great thank for these projects, which Azalea is based on:

• VOICEVOX
• tauri
• bindgen

About the name

I use flower names for my side projects.

Azalea^Wikipedia is a flower that blooms in spring, the flowers often last several weeks. Shade tolerant, they prefer living near or under trees.

By Jim Evans - Own work, CC BY-SA 4.0, Link