Verified project record

rany2/edge-tts

rany2/edge-tts is a Python library and command-line tool that converts text to speech using Microsoft Edge's online TTS service without requiring an API key, the Edge browser, or Windows. It outputs audio files and subtitle files from text input.

Project overview

By removing the need for API keys, specific browsers, or specific operating systems, rany2/edge-tts simplifies generating speech audio programmatically for Python developers.

Project type: Audio & Speech
Use cases: Translation & Subtitles
Deployment: Refer to project documentation
License: License pending

Best for

Python developers seeking to add text-to-speech functionality without managing API keys or relying on Windows and the Edge browser.

Key capabilities

Converts text strings into speech audio files using Microsoft Edge's online TTS service.
Allows changing the voice used by the text-to-speech service and listing all available voices.
Writes subtitle files alongside audio media during text-to-speech conversion.
Plays back text-to-speech audio immediately with subtitles via the edge-playback command.
Provides a Python module to use the TTS service from within Python code.

Limitations and risks

Support for custom SSML was removed because Microsoft prevents the use of any SSML that could not be generated by Microsoft Edge itself.

Getting started

Install the library via pip or pipx using a single command, then run the edge-tts command with your text and output file options.

Evidence and sources

GitHub project description: Use Microsoft Edge's online text-to-speech service from Python WITHOUT needing Microsoft Edge or Windows or an API key
README: `edge-tts` is a Python module that allows you to use Microsoft Edge's online text-to-speech service from within your Python code or using the provided `edge-tts` or `edge-playback…
README: To install it, run the following command: $ pip install edge-tts If you only want to use the `edge-tts` and `edge-playback` commands, it would be better to use `pipx`: $ pipx inst…
README: $ edge-tts --text "Hello, world!" --write-media hello.mp3 --write-subtitles hello.srt
README: You can change the voice used by the text-to-speech service by using the `--voice` option. The `--list-voices` option can be used to list all available voices.

Reviewed at: 2026-07-14T23:08:29Z