---
id: edge-tts
version: "7.2.8"
license: unclear
license_treatment: copyleft
maintenance: active
---

# edge-tts — Microsoft Edge's TTS

License: copyleft · Maintenance: active · Downloads: 13.0M/mo

## What it is and what it does

edge-tts wraps Microsoft Edge's online text-to-speech service, letting you generate speech audio and synchronized subtitles from text in your Python code or via command-line commands. It supports multiple voices across many languages, with control over speech rate, volume, and pitch. The package works asynchronously and depends on aiohttp for HTTP communication with the Edge service.

You can use it either as a standalone tool via edge-tts and edge-playback commands or import it as a Python module for programmatic access. The service requires no API key but depends on Microsoft's online service being available. Custom SSML is not supported due to Microsoft's restrictions on what the service will accept.

Use it for:

- Generate MP3 audio files with synchronized SRT subtitles from text for video production or accessibility
- Build a command-line tool that reads text aloud with voice selection and playback
- Add speech synthesis to a Python application without managing local TTS models
- Create multilingual audio samples by iterating over available voices and text in different languages
- Automate podcast or audiobook generation from written content with subtitle support

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts text to speech using Microsoft Edge's online TTS service, available as both a Python module and command-line tools for generating audio files and subtitles.

Yes, if you need free, zero-setup text-to-speech without local model management. The package is actively maintained, has no known vulnerabilities, and low install friction. The LGPLv3 copyleft license is permissive for most use cases. Main trade-off: you depend on Microsoft's online service availability; not suitable for offline-only or privacy-critical applications.

## Install

pip install edge-tts
uv add edge-tts
poetry add edge-tts

## Installing edge-tts

Before you install: Low friction installation with a pure Python wheel. Actively maintained with recent commits and substantial community adoption (11725 stars). Requires only four runtime dependencies (aiohttp, certifi, tabulate, typing-extensions).

License in practice: Licensed under LGPLv3 (copyleft). You may use and modify the package freely, but any derivative works must also be distributed under LGPLv3 and include source code availability.

Quickstart:

pip install edge-tts

edge-tts --text "Hello, world!" --write-media hello.mp3 --write-subtitles hello.srt

# Or in Python:
import asyncio
from edge_tts import Communicate

async def main():
    communicate = Communicate("Hello, world!", "en-US")
    await communicate.save("hello.mp3")

asyncio.run(main())

edge-playback command requires mpv player installed (except on Windows). Requires Python 3.7 or later.

Verify before relying:

- Whether the package handles network failures gracefully or requires manual retry logic
- Rate limiting or quota constraints from Microsoft's service
- Audio quality or latency characteristics compared to other TTS providers
- Offline fallback options or local model support

## Package facts

- License: not declared (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 13.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

text to speech python, microsoft edge tts, generate audio from text, tts command line tool, speech synthesis api, mp3 audio generation, subtitle generation, text-to-speech, async-io, cli-tool

[View on SkillFed](https://skillfed.io/packages/edge-tts) · [View on PyPI](https://pypi.org/project/edge-tts/)