Azure TTS Client

A terminal-based Text-to-Speech client for Azure Cognitive Services, built with Textual.

Features

• Multiple voice options (English, French, German, Spanish, Chinese)
• Beautiful terminal UI with live playback
• Save audio to WAV files
• Secure API key storage
• Fast and lightweight

Usage

Running the app

Run directly without installation:

uvx azure-tts-client

First-time setup

On first launch, you'll be prompted to enter your Azure Speech API key. The key will be saved securely to ~/.azure_tts_env.

To get an Azure Speech API key:

1. Go to Azure Portal
2. Create a Speech Service resource
3. Copy the API key from the resource

Using the app

1. Type your text in the text area
2. Select a voice from the dropdown menu
3. Click Play to hear the speech
4. Click Save to export audio to output.wav
5. Click Clear Text to reset the input

Development

Local development

Clone the repository:

git clone <repository-url>
cd azure-client-tts

Run with uv:

uv run -m azure_tts_client

Requirements

• Python 3.10+
• Azure Speech API key

Publishing to PyPI

Prerequisites

1. Set up PyPI credentials:
   • Create an account on PyPI
   • Generate an API token at https://pypi.org/manage/account/token/
   • Store the token for publishing

Publishing Steps

1. Update the version in pyproject.toml

2. Build the package:

uv build

3. Publish to PyPI:

uv publish

You'll be prompted for your PyPI token during publish.

Alternatively, set the token as an environment variable:

export UV_PUBLISH_TOKEN=pypi-your-api-token-here
uv publish

To publish to TestPyPI first:

uv publish --publish-url https://test.pypi.org/legacy/

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.