Metadata-Version: 1.1
Name: ivona-speak
Version: 0.2.0
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
Description: 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 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
        
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
