Metadata-Version: 2.0
Name: ivona-speak
Version: 0.2.1
Summary: Python script that lets you easily convert text to synthesized audio files, with help of Amazon's IVONA.
Home-page: https://github.com/Pythonity/ivona-speak
Author: Paweł Adamczak
Author-email: pawel.adamczak@sidnet.info
License: MIT License
Download-URL: https://github.com/Pythonity/ivona-speak/releases/latest
Keywords: amazon ivona text to speech synthesize
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Utilities
Requires-Dist: click (>=6.7)
Requires-Dist: click-default-group (>=1.2)
Requires-Dist: ivona-api (>=0.2.0)
Provides-Extra: testing
Requires-Dist: flaky; extra == 'testing'
Requires-Dist: pytest; extra == 'testing'

Ivona, Speak!
=============

|Build status| |Test coverage| |PyPI version| |Python versions|
|License|

Python script that lets you easily convert passed text to synthesized
audio files, with help of Amazon's `IVONA <https://www.ivona.com/>`__.
All you need is a pair of
`keys <http://developer.ivona.com/en/speechcloud/introduction.html#Credentials>`__
and this script. Yes, that's *literally* everything you need to never
speak again. If that's your thing of course.

If you want to use IVONA Speech Cloud directly inside your Python
project then you should have a look at
`python-ivona-api <https://github.com/Pythonity/python-ivona-api>`__,
which this script uses in the background.

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

>From PyPI (recommended):

::

    $ pip install ivona_speak

With ``git clone``:

::

    $ git clone https://github.com/Pythonity/ivona-speak
    $ pip install -r ivona-speak/requirements.txt
    $ cd ivona-speak/bin

Usage
-----

::

    $ ivona-speak --help

      Easily convert passed text to synthesized audio files, with help of
      Amazon's IVONA. All you need is a pair of auth keys.

      See https://github.com/Pythonity/ivona-speak for more info.

    Options:
      --help  Show this message and exit.

    Commands:
      synthesize*  Synthesize passed text and save it as an...
      list-voices  List available Ivona voices

Examples
--------

You can provide keys either explicitly:

::

    $ ivona-speak --access-key 'YOUR_ACTUAL_ACCESS_KEY' --secret-key 'YOUR_ACTUAL_SECRET_KEY' list-voices

or export them as environment variables:

::

    $ export IVONA_ACCESS_KEY="YOUR_ACTUAL_ACCESS_KEY"
    $ export IVONA_SECRET_KEY="YOUR_ACTUAL_SECRET_KEY"
    $ ivona-speak list-voices

The default subcommand is ``synthesize``, so these do the same:

::

    $ ivona-speak synthesize -o hello_world.mp3 'Hello world!'
    $ ivona-speak -o hello_world.mp3 'Hello world!'

I want someone to say 'Hello world!', and say it quick:

::

    $ ivona-speak synthesize -o hello_world.mp3 'Hello world!'

She sounds so nice. I want someone special to respond her:

::

    $ ivona-speak synthesize -o response.mp3 -n Joey 'How you doin?'

Tests
-----

Package was tested with the help of ``py.test`` and ``tox`` on Python
2.7, 3.4, 3.5 and 3.6 (see ``tox.ini``).

Code coverage is available at
`Coveralls <https://coveralls.io/github/Pythonity/ivona-speak>`__.

To run tests yourself you need to set environment variables with secret
and access keys before running ``tox`` inside the repository:

.. code:: shell

    $ pip install -r requirements/dev.txt
    $ export IVONA_ACCESS_KEY="YOUR_ACTUAL_ACCESS_KEY"
    $ export IVONA_SECRET_KEY="YOUR_ACTUAL_SECRET_KEY"
    $ tox

Contributions
-------------

Package source code is available at
`GitHub <https://github.com/Pythonity/ivona-speak>`__.

Feel free to use, ask, fork, star, report bugs, fix them, suggest
enhancements, add functionality and point out any mistakes. Thanks!

Authors
-------

Developed and maintained by `Pythonity <http://pythonity.com/>`__.

Written by `Paweł Adamczak <https://github.com/pawelad>`__.

.. |Build status| image:: https://img.shields.io/travis/Pythonity/ivona-speak.svg
   :target: https://travis-ci.org/Pythonity/ivona-speak
.. |Test coverage| image:: https://img.shields.io/coveralls/Pythonity/ivona-speak.svg
   :target: https://coveralls.io/github/Pythonity/ivona-speak
.. |PyPI version| image:: https://img.shields.io/pypi/v/ivona_speak.svg
   :target: https://pypi.python.org/pypi/ivona_speak
.. |Python versions| image:: https://img.shields.io/pypi/pyversions/ivona_speak.svg
   :target: https://pypi.python.org/pypi/ivona_speak
.. |License| image:: https://img.shields.io/github/license/Pythonity/ivona-speak.svg
   :target: https://github.com/Pythonity/ivona-speak/blob/master/LICENSE


