A command-line tool to transform voices in (YouTube) videos with additional translation capabilities. ¹

• Voice Transformation
  Turn voices with the free Coqui TTS at no operating costs ^{(supports voice cloning, 58 voices included}

• Voice Variety
  Support for popular TTS engines like Elevenlabs, OpenAI TTS, or Azure for more voices. ²

• Translation
  Translates videos at zero costs, for example from english to chinese. ^{powered by free deep-translator}

• Change Speaking Styles ^{(AI powered)}
  Make every spoken sentence delivered in a custom speaking style for a unique flair using prompting. ³

• Full Rendering Control
  Precise rendering control by customizing the sentence text, timings, and voice selection.

  ^{💡 Tip: the Renderscript Editor makes this step easy}

• Local Video Processing
  Process any local video files.

• Background Audio Preservation
  Keeps the original background audio intact.

Discover more in the release notes.

Nvidia graphic card >8 GB VRAM recommended, tested on Python 3.11.4 / Windows 10.

• NVIDIA CUDA Toolkit 11.8 installed

  To install NVIDIA CUDA Toolkit:

  • Visit NVIDIA CUDA Toolkit Archive.
  • Select operating system and version.
  • Download and install the software.

• NVIDIA cuDNN installed.

  To install NVIDIA cuDNN:

  • Visit NVIDIA cuDNN Archive.
  • Download and install the software.
    (tested with v8.7.0, should also work with newer versions)

• Rubberband command-line utility installed ⁴

• ffmpeg command-line utility installed ⁵

  To install ffmpeg with a package manager:

  • On Ubuntu or Debian:

    sudo apt update && sudo apt install ffmpeg

  • On Arch Linux:

    sudo pacman -S ffmpeg

  • On MacOS using Homebrew (https://brew.sh/):

    brew install ffmpeg

  • On Windows using Chocolatey (https://chocolatey.org/):

    choco install ffmpeg

  • On Windows using Scoop (https://scoop.sh/):

    scoop install ffmpeg

• Huggingface conditions accepted for Speaker Diarization and Segmentation

• Huggingface access token in env variable HF_ACCESS_TOKEN ⁶

pip install turnvoice

turnvoice [-i] <YouTube URL|ID|Local File> [-l] <Translation Language> -e <Engine(s)> -v <Voice(s)> -o <Output File>

Submit a string to the 'voice' parameter for each speaker voice you wish to use. If you specify engines, the voices will be assigned to these engines in the order they are listed. Should there be more voices than engines, the first engine will be used for the excess voices. In the absence of a specified engine, the Coqui engine will be used as the default. If no voices are defined, a default voice will be selected for each engine.

Arthur Morgan narrating a cooking tutorial:

turnvoice -i AmC9SmCBUj4 -v arthur.wav -o cooking_with_arthur.mp4

Prepare a script with transcription, speaker diarization (and optionally translation or prompting) using:

turnvoice https://www.youtube.com/watch?v=cOg4J1PxU0c --prepare

Translation and prompts should be applied in this preparation step. Engines or voices come later in the render step.

1. Open script
   Open the editor.html file. Click on the file open button and navigate to the folder you started turnvoice from. Open download folder. Open the folder with the name of the video. Open the file full_script.txt.
2. Edit
   The Editor will visualize the transcript and speaker diarization results and start playing the original video now. While playing verify texts, starting times and speaker assignments and adjust them if the detection went wrong.
3. Save
   Save the script. Remember the path to the file.

Render the refined script to generate the final video using:

turnvoice https://www.youtube.com/watch?v=cOg4J1PxU0c --render <path_to_script>

Adjust the path in the displayed CLI command (the editor can't read that information out from the browser).

Assign engines and voices to each speaker track with the -e and -v commands.

• -i, --in: Input video. Accepts a YouTube video URL or ID, or a path to a local video file.
• -l, --language: Language for translation. Coqui synthesis supports: en, es, fr, de, it, pt, pl, tr, ru, nl, cs, ar, zh, ja, hu, ko. Omit to retain the original video language.
• -il, --input_language: Language code for transcription, set if automatic detection fails.
• -v, --voice: Voices for synthesis. Accepts multiple values to replace more than one speaker.
• -o, --output_video: Filename for the final output video (default: 'final_cut.mp4').
• -a, --analysis: Print transcription and speaker analysis without synthesizing or rendering the video.
• -from: Time to start processing the video from.
• -to: Time to stop processing the video at.
• -e, --engine: Engine(s) to synthesize with. Can be coqui, elevenlabs, azure, openai or system. Accepts multiple values, linked to the the submitted voices.
• -s, --speaker: Speaker number to be transformed.
• -snum, --num_speakers: Helps diarization. Specify the exact number of speakers in the video if you know it in advance.
• -smin, --min_speakers: Helps diarization. Specify the minimum number of speakers in the video if you know it in advance.
• -smax, --max_speakers: Helps diarization. Specify the maximum number of speakers in the video if you know it in advance.
• -dd, --download_directory: Directory for saving downloaded files (default: 'downloads').
• -sd, --synthesis_directory: Directory for saving synthesized audio files (default: 'synthesis').
• -ex, --extract: Enables extraction of audio from the video file. Otherwise downloads audio from the internet (default).
• -c, --clean_audio: Removes original audio from the final video, resulting in clean synthesis.
• -tf, --timefile: Define timestamp file(s) for processing (functions like multiple --from/--to commands).
• -p, --prompt: Define a prompt to apply a style change to sentences like "speaking style of captain jack sparrow" ³
• -prep, --prepare: Write full script with speaker analysis, sentence transformation and translation but doesn't perform synthesis or rendering. Can be continued.
• -r, --render: Takes a full script and only perform synthesis and rendering on it, but no speaker analysis, sentence transformation or translation.
• -faster, --use_faster: Usage of faster_whisper for transcription. If stable_whisper transcription throws OOM errors or delivers suboptimal results. (Optional)
• -model, --model: Transcription model to be used. Defaults to large-v2. Can be 'tiny', 'tiny.en', 'base', 'base.en', 'small', 'small.en', 'medium', 'medium.en', 'large-v1', 'large-v2', 'large-v3', or 'large'. (Optional)

-i and -l can be used as both positional and optional arguments.

Translate a video into another language using the -l parameter.

For example, to translate into chinese you could use:

turnvoice https://www.youtube.com/watch?v=ZTH771HIhpg -l zh-CN -v daisy

^{Output Video
💡 Tip: In the tests folder you find a voice "chinese.json" trained on chinese phonemes.}

Coqui engine is the default engine if no other engine is specified with the -e parameter.

turnvoice https://www.youtube.com/watch?v=cOg4J1PxU0c -e coqui -v female.wav

setx COQUI_MODEL_PATH "C:\Downloads\CoquiModels"

All voices are synthesized with the multilingual-v1 model.

turnvoice https://www.youtube.com/watch?v=cOg4J1PxU0c -e elevenlabs -v Giovanni

turnvoice https://www.youtube.com/watch?v=cOg4J1PxU0c -e openai -v shimmer

turnvoice https://www.youtube.com/watch?v=BqnAeUoqFAM -e azure -v ChristopherNeural

turnvoice https://www.youtube.com/watch?v=BqnAeUoqFAM -e system -v David

• early alpha / work-in-progress, so bugs might occur (please report, need to be aware to fix)
• might not always achieve perfect lip synchronization, especially when translating to a different language
• speaker detection does not work that well, probably doing something wrong or or perhaps the tech⁷ is not yet ready to be reliable
• translation feature is currently in experimental prototype state (powered by deep-translate) and still produces very imperfect results
• occasionally, the synthesis might introduce unexpected noises or distortions in the audio (we got way better reducing artifacts with the new v0.0.30 algo)
• spleeter might get confused when a spoken voice and backmusic with singing are present together in the source audio

• delivers best results with YouTube videos featuring clear spoken content (podcasts, educational videos)
• requires a high-quality, clean source WAV file for effective voice cloning

First perform a speaker analysis with -a parameter:

turnvoice https://www.youtube.com/watch?v=2N3PsXPdkmM -a

Then select a speaker from the list with -s parameter

turnvoice https://www.youtube.com/watch?v=2N3PsXPdkmM -s 2

TurnVoice is proudly under the Coqui Public Model License 1.0.0.

Share your funniest or most creative TurnVoice creations with me!

And if you've got a cool feature idea or just want to say hi, drop me a line on

• Twitter
• Reddit
• EMail

If you like the repo please leave a star
✨ 🌟 ✨