Metadata-Version: 1.1
Name: gTTS
Version: 1.2.0
Summary: Create an mp3 file from spoken text via the Google TTS (Text-to-Speech) API
Home-page: https://github.com/pndurette/gTTS
Author: Pierre Nicolas Durette
Author-email: pndurette@gmail.com
License: MIT
Description: # gTTS
        
        **gTTS** (_Google Text to Speech_): a *Python* interface for Google's _Text to Speech_ API. Create an _mp3_ file with the `gTTS` module or `gtts-cli` command line utility. It allows unlimited lengths to be spoken by tokenizing long sentences where the speech would naturally pause.
        
        [![Build Status](https://travis-ci.org/pndurette/gTTS.svg?branch=master)](https://travis-ci.org/pndurette/gTTS)
        [![PyPI version](https://badge.fury.io/py/gTTS.svg)](https://badge.fury.io/py/gTTS)
        
        ## Install
        
        ```
        pip install gTTS
        ```
        
        ## Usage
        
        You may either use `gTTS` as a **__python module__** or as a **__command-line utility__**
        
        ### A. Module
        
        ##### 1. Import `gTTS`
        
        ```
        >> from gtts import gTTS
        ```
        
        ##### 2. Create an instance
        
        ```
        >> tts = gTTS(text='Hello', lang='en', slow=True)
        ```
        
        ###### _Parameters:_
        *  `text` - String - Text to be spoken.
        *  `lang` - String - [ISO 639-1 language code](#lang_list) (supported by the Google _Text to Speech_ API) to speak in.
        *  `slow` - Boolean - Speak slowly. Default `False` (Note: only two speeds are provided by the API).
        
        ##### 3. Write to a file
        
        * _To disk_ using `save(file_name)`
           
        ```
        >> tts.save("hello.mp3")
        ```
        
        * _To a file pointer_ using `write_to_fp(file_object)`
           
        ``` 
        >> f = TemporaryFile()
        >> tts.write_to_fp(f)
        >> # <Do something with f>
        >> f.close()
        ```
        
        ### B. Command line utility
        
        ##### Command
        ```
        gtts-cli.py [-h] (["text to speak"] | -f FILE) [-l LANG] [--slow] [--debug] [-o destination_file]
        ```
         
        ###### _Example:_
          
        ```
        $ # Read the string 'Hello' in English to hello.mp3
        $ gtts-cli "Hello" -l 'en' -o hello.mp3
        
        $ # Read the string 'Hello' in English (slow speed) to hello.mp3
        $ gtts-cli "Hello" -l 'en' -o hello.mp3 --slow
        
        $ # Read the contents of file 'hello.txt' in Czech to hello.mp3:
        $ gtts-cli -f hello.txt -l 'cs' -o hello.mp3
        
        $ # Read the string 'Hello' from stdin in English to hello.mp3
        $ echo "Hello" | gtts-cli -l 'en' -o hello.mp3 -
        ```
        
        ## Supported Languages <a name="lang_list"></a>
        
          * 'af' : 'Afrikaans'
          * 'sq' : 'Albanian'
          * 'ar' : 'Arabic'
          * 'hy' : 'Armenian'
          * 'bn' : 'Bengali'
          * 'ca' : 'Catalan'
          * 'zh' : 'Chinese'
          * 'zh-cn' : 'Chinese (Mandarin/China)'
          * 'zh-tw' : 'Chinese (Mandarin/Taiwan)'
          * 'zh-yue' : 'Chinese (Cantonese)'
          * 'hr' : 'Croatian'
          * 'cs' : 'Czech'
          * 'da' : 'Danish'
          * 'nl' : 'Dutch'
          * 'en' : 'English'
          * 'en-au' : 'English (Australia)'
          * 'en-uk' : 'English (United Kingdom)'
          * 'en-us' : 'English (United States)'
          * 'eo' : 'Esperanto'
          * 'fi' : 'Finnish'
          * 'fr' : 'French'
          * 'de' : 'German'
          * 'el' : 'Greek'
          * 'hi' : 'Hindi'
          * 'hu' : 'Hungarian'
          * 'is' : 'Icelandic'
          * 'id' : 'Indonesian'
          * 'it' : 'Italian'
          * 'ja' : 'Japanese'
          * 'km' : 'Khmer (Cambodian)'
          * 'ko' : 'Korean'
          * 'la' : 'Latin'
          * 'lv' : 'Latvian'
          * 'mk' : 'Macedonian'
          * 'no' : 'Norwegian'
          * 'pl' : 'Polish'
          * 'pt' : 'Portuguese'
          * 'ro' : 'Romanian'
          * 'ru' : 'Russian'
          * 'sr' : 'Serbian'
          * 'si' : 'Sinhala'
          * 'sk' : 'Slovak'
          * 'es' : 'Spanish'
          * 'es-es' : 'Spanish (Spain)'
          * 'es-us' : 'Spanish (United States)'
          * 'sw' : 'Swahili'
          * 'sv' : 'Swedish'
          * 'ta' : 'Tamil'
          * 'th' : 'Thai'
          * 'tr' : 'Turkish'
          * 'uk' : 'Ukrainian'
          * 'vi' : 'Vietnamese'
          * 'cy' : 'Welsh'
        
        ## Contributing
        
        1. _Fork_ [pndurette/gTTS](https://github.com/pndurette/gTTS) on GitHub and clone it locally
        2. Make sure you write tests for new features or modify the existing ones if necessary
        3. Open a new _Pull Request_ from your feature branch to the `master` branch.
        4. Thank you!
        
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
