voice-changer/README_en.md

VC Client

Japanese

What's New!

• v.1.5.2.8

  • auto-downloader for weight of hubert.
  • auto detect half-precision.
  • auto detect onnx execution provider.
  • force onnx export by cpu.
  • support japanse hubert. (experimental)

• v.1.5.2.7

  • New Feature: model merger.

• v.1.5.2.6b

  • Bugfix: "clear setting" leaves some data in storage.

• v.1.5.2.6a

  • RVC:change light weight f0 estimator from pm to dio

• v.1.5.2.5

  • RVC: Support pitch-less model and rvc-webui model
  • so-vits-svc40: some bugfix

What is VC Client

1. This is a client software for performing real-time voice conversion using various Voice Conversion (VC) AI. The supported AI for voice conversion are as follows.

• MMVC
• so-vits-svc
• RVC(Retrieval-based-Voice-Conversion)
• DDSP-SVC

2. Distribute the load by running Voice Changer on a different PC The real-time voice changer of this application works on a server-client configuration. By running the MMVC server on a separate PC, you can run it while minimizing the impact on other resource-intensive processes such as gaming commentary.

3. Cross-platform compatibility Supports Windows, Mac (including Apple Silicon M1), Linux, and Google Colaboratory.

usage

Details are summarized here.

This is an app for performing voice changes with MMVC and so-vits-svc.

It can be used in three main ways, in order of difficulty:

• Using Google Colaboratory (MMVC only)
• Using a pre-built binary
• Setting up an environment with Docker or Anaconda and using it

For those who are not familiar with this software or MMVC, it is recommended to gradually get used to it from the top.

(1) Use on Google Colaboratory (MMVC only)

You can run it on Google's machine learning platform, Colaboratory. If you have already used Colaboratory, you do not need to prepare anything as the training of MMVC model has been completed. However, the voice changer may have a large time lag depending on the network environment or the situation of Colaboratory.

• Simple version: You can run it from Colab without any prior setup.
• Normal version: You can load the model by cooperating with Google Drive.

Explanation video

(2) Usage with pre-built binaries

You can download and run executable binaries. We offer Windows and Mac versions.

• For Windows user, after unzipping the downloaded zip file, please run the start_http.bat file corresponding to your VC.

• For Mac version, after unzipping the downloaded file, double-click the startHttp.command file corresponding to your VC. If a message indicating that the developer cannot be verified is displayed, please press the control key and click to run it again (or right-click to run it).

• If you are connecting remotely, please use the .command file (Mac) or .bat file (Windows) with https instead of http.

• Tsukuyomi-chan, Ami-taro, Kogane Mahiro, and Kogane Kaigetsu require the Content Vec model for their actions. Please download the ContentVec_legacy 500 model from this repository and place it in the same folder as startHttp.command or start_http.bat to execute it.

• To run DDSP-SVC, you need to download the hubert-soft and enhancer models. Download hubert-soft from this link and store it in the folder with the batch files. Download nsf_hifigan_20221211.zip from this site for enhancer. After unzipping, store the nsf_hifigan folder in the folder with the batch files.

• The encoder of DDPS-SVC only supports hubert-soft.

• Please refer to here for the description of each item of GUI to be used in RVC.

• Download (When you cannot download from google drive, try hugging_face)

Version	OS	フレームワーク	link	サポート VC	サイズ
v.1.5.2.8	mac	ONNX(cpu), PyTorch(cpu,mps)	normal *1	MMVC v.1.5.x, MMVC v.1.3.x, so-vits-svc 4.0, RVC	784MB
	win	ONNX(cpu,cuda), PyTorch(cpu,cuda)	normal *1	MMVC v.1.5.x, MMVC v.1.3.x, so-vits-svc 4.0, so-vits-svc 4.0v2, RVC, DDSP-SVC	2860MB
	win	ONNX(cpu,DirectML), PyTorch(cpu,cuda)*2	normal *1	MMVC v.1.5.x, MMVC v.1.3.x, so-vits-svc 4.0, so-vits-svc 4.0v2, RVC, DDSP-SVC	2744MB

(*1) You can alson download from hugging_face (*2) The developer does not have an AMD graphics card, so it has not been tested. This package only includes onnxruntime-directml.

Version	OS	Framework	link	VC Support	Size
v.1.5.1.14	mac	-	Tsukuyomi-chan	-	874MB
	mac	-	Kikoto Mahiro	-	872MB
	mac	-	Amitaro	-	872MB
	mac	-	Kikoto Kurage	-	873MB
	win	-	Tsukuyomi-chan	-	823MB
	win	-	Kikoto Mahiro	-	821MB
	win	-	Kikoto Kurage	-	823MB
	win	-	Amitaro	-	821MB

*1 Tsukuyo Michan uses free character "Tsukuyo Michan" voice data that is publicly available for free. (Details such as terms of use are at the end of the document)

*2 If unpacking or starting is slow, there is a possibility that virus checking is running on your antivirus software. Please try running it with the file or folder excluded from the target. (At your own risk)

(2-3) Usage after setting up the environment such as Docker or Anaconda

Clone this repository and use it. Setting up WSL2 is essential for Windows. Additionally, setting up virtual environments such as Docker or Anaconda on WSL2 is also required. On Mac, setting up Python virtual environments such as Anaconda is necessary. Although preparation is required, this method works the fastest in many environments. Even without a GPU, it may work well enough with a reasonably new CPU (refer to the section on real-time performance below).

Explanation video on installing WSL2 and Docker

Explanation video on installing WSL2 and Anaconda

To run docker, see start docker.

To run on Anaconda venv, see server developer's guide

Real-time performance

Conversion is almost instantaneous when using GPU.

https://twitter.com/DannadoriYellow/status/1613483372579545088?s=20&t=7CLD79h1F3dfKiTb7M8RUQ

Even with CPU, recent ones can perform conversions at a reasonable speed.

https://twitter.com/DannadoriYellow/status/1613553862773997569?s=20&t=7CLD79h1F3dfKiTb7M8RUQ

With an old CPU (i7-4770), it takes about 1000 msec for conversion.

Software Signing

This software is not signed by the developer. A warning message will appear, but you can run the software by clicking the icon while holding down the control key. This is due to Apple's security policy. Running the software is at your own risk.

https://user-images.githubusercontent.com/48346627/212569645-e30b7f4e-079d-4504-8cf8-7816c5f40b00.mp4

Acknowledgments

• Tachizunda-mon materials
• Irasutoya
• Tsukuyomi-chan

This software uses the voice data of the free material character "Tsukuyomi-chan," which is provided for free by CV. Yumesaki Rei.

• Tsukuyomi-chan Corpus (CV. Yumesaki Rei)

https://tyc.rei-yumesaki.net/material/corpus/

Copyright. Rei Yumesaki

• Amitaro's Onsozai kobo
• Replica doll

Terms of Use

In accordance with the Tsukuyomi-chan Corpus Terms of Use for the Tsukuyomi-chan Real-time Voice Changer, the use of the converted voice for the following purposes is prohibited.

• Criticizing or attacking individuals (the definition of "criticizing or attacking" is based on the Tsukuyomi-chan character license).

• Advocating for or opposing specific political positions, religions, or ideologies.

• Publicly displaying strongly stimulating expressions without proper zoning.

• Publicly disclosing secondary use (use as materials) for others. (Distributing or selling as a work for viewing is not a problem.)

Regarding the Real-time Voice Changer Amitaro, we prohibit the following uses in accordance with the terms of use of the Amitaro's koe-sozai kobo.detail

Regarding the Real-time Voice Changer Kikoto Mahiro, we prohibit the following uses in accordance with the terms of use of Replica doll.detail

Disclaimer

We are not liable for any direct, indirect, consequential, incidental, or special damages arising out of or in any way connected with the use or inability to use this software.