Download the PHP package afaya/edge-tts without Composer

Edge TTS PHP

Overview

Edge TTS is a powerful Text-to-Speech (TTS) package for PHP that leverages Microsoft Edge's speech synthesis capabilities. This package allows you to synthesize speech from text, manage voice options, and process audio streams with real-time callbacks through both programmatic and command-line interfaces.

Features

• Text-to-Speech: Convert text into natural-sounding speech using Microsoft Edge's TTS capabilities.
• Multiple Voices: Access a wide variety of voices to suit your project's needs.
• Real-time Streaming: Support for audio streaming with real-time processing callbacks.
• Word Boundaries Metadata: Get word boundary information with precise timestamps.
• Flexible Export Options: Export synthesized audio in different formats (raw, base64, file, or PHP stream).
• Command-Line Interface: Use a simple CLI for easy access to functionality.
• Easy Integration: Modular structure allows for seamless inclusion in existing PHP projects.
• Extended Compatibility: Compatible from PHP 7.4+ to PHP 8.1+
• SSML Custom: 🥳🥳 Edge TTS accepts raw SSML with all characteristics of Azure AI Speech.

Requirements

• PHP 7.4+ (compatible up to PHP 8.1+)
• PHP Extensions: json, curl
• Composer for dependency management

Installation

You can install Edge TTS via Composer. Run the following command in your terminal:

This package is a fork of the original afaya/edge-tts package with improvements and fixes. We've downgraded the dependencies to be compatible from PHP 8.1+ to PHP 7.4+ while maintaining the original functionality .

Usage

Command-Line Interface

To synthesize speech from text:

From file in format SSML:

To list available voices:

Custom SSML (Advanced)

Edge TTS accepts raw SSML so you can control prosody, styles, pauses, pronunciations, and more. You can pass SSML from code or the CLI. By default the library auto-detects if your input is SSML; you can also force the mode.

More information Azure AI Speech

SSML-builder Javascript

@andresaya/ssml-builder A powerful, type-safe TypeScript library for building Speech Synthesis Markup Language (SSML) documents. Create expressive text-to-speech applications with Azure Speech Service and other SSML-compliant engines.

What the library does for you

• Auto-detect / force mode: options.inputType may be 'auto' | 'ssml' | 'text' (default: auto).
• Validation: Throws helpful errors if SSML is malformed (e.g., missing , , or the synthesis namespace).
• Voice injection: If your SSML lacks , it injects one with the voice you passed.
• Text wrapping: If you pass plain text (or inputType: 'text'), it wraps it in a valid SSML envelope using your rate, pitch, and volume.

Integration into Your Project

Real-time Streaming Synthesis

For real-time audio processing:

Available Methods

Audio Information

Word Boundaries Metadata

Export Options

After synthesizing speech, you can export the audio in various formats:

• toBase64(): Returns the audio as a Base64 string
• toFile($path): Saves the audio to a specified file
• toRaw(): Returns the raw audio stream
• toStream(): Returns a PHP stream resource

Voice Management

Audio Configuration

The package uses high-quality audio settings by default:

• Format: MP3 (audio-24khz-48kbitrate-mono-mp3)
• Sample Rate: 24kHz
• Bitrate: 48kbps
• Channels: Mono

Error Handling

The package includes comprehensive error handling:

Testing

Contributing

We welcome contributions! Please read our CONTRIBUTING.md for guidelines on how to contribute to this project.

License

This project is licensed under the GNU General Public License v3 (GPLv3).

Acknowledgments

We would like to extend our gratitude to the developers and contributors of the following projects for their inspiration and groundwork:

• https://github.com/rany2/edge-tts/tree/master/examples
• https://github.com/rany2/edge-tts/blob/master/src/edge_tts/util.py
• https://github.com/hasscc/hass-edge-tts/blob/main/custom_components/edge_tts/tts.py