# What changed in edge-tts

> 17 changes in edge-tts 7 from its official release notes, upgrade guides and advisories: 1 breaking, 5 new APIs and options. Each one cited. Sources checked 2026-10-29. HTML: https://unstale.sh/pypi/edge-tts/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## edge-tts 7

### Breaking changes

- SubMaker now returns subtitles in SRT format; VTT support has been dropped. (7.0.0) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.0.0)

### New APIs and options

- Adds support for Sec-MS-GEC v2 tokens. (7.3.0) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.3.0)
- Adds --version to print the version of edge-tts. (7.2.6) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.2.6)
- Adds support for a custom aiohttp connector. (7.0.0) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.0.0)
- Adds .feed(), which takes a TTS chunk, simplifying SubMaker usage. (7.0.0) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.0.0)
- Adds .merge_cues(), simplifying SubMaker usage. (7.0.0) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.0.0)

### Performance

- Caches the SSL context at module level to avoid per-call overhead. (7.2.8) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.2.8)

### Behavior and default changes

- A progress bar is shown on stderr during synthesis. (7.3.0) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.3.0)
- The edge-tts CLI output for the voice list is prettier. (7.0.0) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.0.0)

### Tooling

- The Voice TypedDict was updated to provide up-to-date types; functionality is unchanged. (7.2.7) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.2.7)
- Adds type support for all dicts in the project, enabling IDE autocomplete for TTS chunks and list_voices return output. (7.0.0) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.0.0)

### Fixes and other changes

- Fixes locale-dependent server date parsing. (7.3.1) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.3.1)
- Works around an mpv CoreAudio playback failure on macOS. (7.3.0) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.3.0)
- Replaces metadata-based offset compensation with CBR byte-count math. (7.2.8) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.2.8)
- Switches back to the endpoint currently in use by Microsoft Edge on macOS. (7.2.6) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.2.6)
- Resolves the NoAudioReceived issue. (7.2.4) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.2.4)
- The project is relicensed to LGPLv3, reducing restrictions on users of the library. (7.0.0) — [release notes](https://github.com/rany2/edge-tts/releases/tag/7.0.0)