What is this?
edge-tts is a Python module and CLI that lets you use Microsoft Edge's online text-to-speech service from your code or terminal, without needing Microsoft Edge, Windows, or an API key.
edge-tts is a Python module and CLI that lets you use Microsoft Edge's online text-to-speech service from your code or terminal, without needing Microsoft Edge, Windows, or an API key.Is this a library or a command-line tool?Both: it's a Python module you can import, and it also ships two CLI commands, edge-tts (generate audio/subtitles) and edge-playback (generate and play immediately).
Both: it's a Python module you can import, and it also ships two CLI commands, edge-tts (generate audio/subtitles) and edge-playback (generate and play immediately).How do I install and use it?Install with 'pip install edge-tts' (or 'pipx install edge-tts' if you only need the CLI commands), then run something like 'edge-tts --text "Hello, world!" --write-media hello.mp3 --write-subtitles hello.srt'.
Install with 'pip install edge-tts' (or 'pipx install edge-tts' if you only need the CLI commands), then run something like 'edge-tts --text "Hello, world!" --write-media hello.mp3 --write-subtitles hello.srt'.Do I need Microsoft Edge, Windows, or an API key?No - it talks directly to Edge's online TTS service, so you don't need the Edge browser, Windows, or any API key. The only extra dependency is the mpv command-line player if you want to use edge-playback on non-Windows systems.
No - it talks directly to Edge's online TTS service, so you don't need the Edge browser, Windows, or any API key. The only extra dependency is the mpv command-line player if you want to use edge-playback on non-Windows systems.Can I use custom SSML to fine-tune the speech?No, custom SSML support was removed because Microsoft only allows SSML that Edge itself could generate, so you're limited to the rate, volume, pitch, and voice options exposed by the tool.
No, custom SSML support was removed because Microsoft only allows SSML that Edge itself could generate, so you're limited to the rate, volume, pitch, and voice options exposed by the tool.Which voices and languages are available?It supports a large list of Microsoft Edge neural voices across many languages (e.g. Arabic, Amharic, Afrikaans, and many more), viewable with 'edge-tts --list-voices'.
It supports a large list of Microsoft Edge neural voices across many languages (e.g. Arabic, Amharic, Afrikaans, and many more), viewable with 'edge-tts --list-voices'.Does it work on Windows, macOS, and Linux?Yes, it's a pure Python package that works wherever Python/pip runs; only edge-playback's dependency on mpv differs, and that's not required on Windows.
Yes, it's a pure Python package that works wherever Python/pip runs; only edge-playback's dependency on mpv differs, and that's not required on Windows.Can I adjust speech rate, volume, and pitch?Yes, use the --rate, --volume and --pitch flags, e.g. --rate=-50% or --pitch=-50Hz; note negative values need the '=' syntax to avoid being parsed as separate CLI flags.
Yes, use the --rate, --volume and --pitch flags, e.g. --rate=-50% or --pitch=-50Hz; note negative values need the '=' syntax to avoid being parsed as separate CLI flags.Does it generate subtitles along with audio?Yes, the edge-tts command can write both an audio file and an .srt subtitle file in the same call, e.g. --write-media hello.mp3 --write-subtitles hello.srt.
Yes, the edge-tts command can write both an audio file and an .srt subtitle file in the same call, e.g. --write-media hello.mp3 --write-subtitles hello.srt.What other projects use edge-tts?README mentions hass-edge-tts, Podcastfy, and a 'tts-samples' repo of voice samples as examples of projects built on the edge-tts module.
README mentions hass-edge-tts, Podcastfy, and a 'tts-samples' repo of voice samples as examples of projects built on the edge-tts module.Which topics is it in?speech-synthesis, voice, tts, text-to-speech, audio, command-line, command-line-tool, terminal, cli, python, cross-platform, developer-tools
speech-synthesis, voice, tts, text-to-speech, audio, command-line, command-line-tool, terminal, cli, python, cross-platform, developer-tools