Metadata-Version: 2.1
Name: audify
Version: 0.0.2
Summary: A simple command line tool to transform text to speech with AWS.
Home-page: https://github.com/JordonPhillips/audify
Author: Jordon Phillips
Author-email: pypi@jkphillips.me
License: MIT
Keywords: aws polly tts
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
Requires-Dist: boto3 (>=1.9.75<2.0.0)
Requires-Dist: pydub (<1.0.0,>=0.23.0)

audify
======

A simple command line tool / python helper to convert a body of text to an mp3
using Amazon Polly. To use audify, you must first have AWS credentials set up.

Installation
------------

It is recommended to install audify using `pip`:

```
$ pip install audify
```

Examples
--------

The most common usage will be to pass in a simple text file and get the output:

```
$ echo "Hello World" > input.txt
$ audify -i input.txt -o output.mp3
```

You can also pass in text from stdin:

```
$ echo "Hello World" | audify -i - -o output.mp3
```

If you want to access audify from a Python script, you can import and call it
directly:

```python
from audify import audify

audify(
    input_filename='input.txt',
    output_filename='output.mp3',
)
```
You can also pass file-like objects:

```python
import io

from audify import audify_fileobj

audify_fileobj(
    fileobj=io.StringIO('Hello World'),
    output_filename='output.mp3',
)```

Any voice supported by Amazon Polly can be used:

```
$ echo "Hello World" | audify -i - -o output.mp3 -v Joey
```

```python
from audify import audify

audify(
    input_filename='input.txt',
    output_filename='output.mp3',
    voice='Ivy',
)```


