str2speech 0.1.3

A tool/library to quickly turn text to speech.

str2speech

Overview

str2speech is a simple command-line tool for converting text to speech using Transformer-based text-to-speech (TTS) models. It supports multiple models and voice presets, allowing users to generate high-quality speech audio from text.

Features

• Supports multiple TTS models, including suno/bark-small, suno/bark, and various facebook/mms-tts models.
• Allows selection of voice presets.
• Supports text input via command-line arguments or files.
• Outputs speech in .wav format.
• Works with both CPU and GPU.

Installation

To install str2speech, first make sure you have pip installed, then run:

pip install str2speech

Usage

Command Line

Run the script via the command line:

str2speech --text "Hello, world!" --output hello.wav

Options

• --text (-t): The text to convert to speech.
• --file (-f): A file containing text to convert to speech.
• --voice (-v): The voice preset to use (optional, defaults to a predefined voice).
• --output (-o): The output .wav file name (optional, defaults to output.wav).
• --model (-m): The TTS model to use (optional, defaults to suno/bark-small).

Example:

str2speech --file input.txt --output speech.wav --model suno/bark

API Usage

You can also use str2speech as a Python module:

from str2speech.speaker import Speaker

speaker = Speaker()
speaker.text_to_speech("Hello, this is a test.", "test.wav")

Available Models

The following models are supported:

• suno/bark-small (default)
• suno/bark
• facebook/mms-tts-eng
• facebook/mms-tts-deu
• facebook/mms-tts-fra
• facebook/mms-tts-spa

Dependencies

• transformers
• torch
• scipy

License

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