{"data":{"slug":"pndurette-gtts","name":"gTTS","tagline":"Python library and CLI tool to interface with Google Translate's text-to-speech API","github_url":"https://github.com/pndurette/gTTS","owner":"pndurette","repo":"gTTS","owner_avatar_url":"https://avatars.githubusercontent.com/u/1653771?v=4","primary_language":"Python","stars":2635,"forks":390,"topics":["cli","gtts","pypi","python","python-library","speech","speech-api","text-to-speech","tts"],"archived":false,"github_pushed_at":"2026-04-06T01:34:42+00:00","maintenance_label":"Slowing","stars_delta_30d":11,"url":"https://www.graphcanon.com/tools/pndurette-gtts","markdown_url":"https://www.graphcanon.com/tools/pndurette-gtts.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/pndurette-gtts","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=pndurette-gtts","description":"Python library and CLI tool to interface with Google Translate's text-to-speech API","homepage_url":"http://gtts.readthedocs.org/","license":"MIT","open_issues":24,"watchers":62,"ai_summary":"gTTS is a Python-based text-to-speech conversion utility that can write audio data directly into MP3 files for later use in applications or as standalone media.","readme_excerpt":"# gTTS\n\n**gTTS** (*Google Text-to-Speech*), a Python library and CLI tool to interface with Google Translate's text-to-speech API. \nWrite spoken `mp3` data to a file, a file-like object (bytestring) for further audio manipulation, or `stdout`.\n<https://gtts.readthedocs.io/>\n\n\n\n\n\n\n\n\n\n## Features\n\n-   Customizable speech-specific sentence tokenizer that allows for unlimited lengths of text to be read, all while keeping proper intonation, abbreviations, decimals and more;\n-   Customizable text pre-processors which can, for example, provide pronunciation corrections;\n\n### Installation\n\n    $ pip install gTTS\n\n### Quickstart\n\nCommand Line:\n\n    $ gtts-cli 'hello' --output hello.mp3\n\nModule:\n\n    >>> from gtts import gTTS\n    >>> tts = gTTS('hello')\n    >>> tts.save('hello.mp3')\n\nSee <https://gtts.readthedocs.io/> for documentation and examples.\n\n### Disclaimer\n\nThis project is *not* affiliated with Google or Google Cloud. Breaking upstream changes *can* occur without notice. This project is leveraging the undocumented [Google Translate](https://translate.google.com) speech functionality and is *different* from [Google Cloud Text-to-Speech](https://cloud.google.com/text-to-speech/).\n\n### Project\n\n-   [Questions & community](https://github.com/pndurette/gTTS/discussions)\n-   [Changelog](CHANGELOG.md)\n-   [Contributing](CONTRIBUTING.rst)\n\n### Licence\n\n[The MIT License (MIT)](LICENSE) Copyright © 2014-2024 Pierre Nicolas Durette & [Contributors](https://github.com/pndurette/gTTS/graphs/contributors)","github_created_at":"2014-05-15T02:52:58+00:00","created_at":"2026-07-11T12:08:33.177972+00:00","updated_at":"2026-09-20T07:08:20.001499+00:00","categories":[{"slug":"speech-audio","name":"Speech & Audio","url":"https://www.graphcanon.com/categories/speech-audio","markdown_url":"https://www.graphcanon.com/categories/speech-audio.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/speech-audio"}],"tags":[{"slug":"cli","name":"cli"},{"slug":"gtts","name":"gtts"},{"slug":"pypi","name":"pypi"},{"slug":"python-library","name":"python library"},{"slug":"speech-api","name":"speech-api"},{"slug":"text-to-speech","name":"text-to-speech"},{"slug":"tts","name":"tts"}],"trust":{"provenance":{"is_fork":false,"github_id":19804107,"owner_type":"User","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-09-20T07:08:17.644Z","maintenance":{"label":"Slowing","score":36,"methodology":"github_public_v1","releases_90d":0,"days_since_push":167,"last_release_at":"2024-11-10T21:57:42Z","stars_delta_30d":11,"open_issues_delta_30d":2},"security_summary":{"status":"no_lockfile","scanner":null,"low_count":0,"high_count":0,"last_scan_at":"2026-07-11T12:08:34.904Z","medium_count":0,"scan_profile":"none","critical_count":0}},"capability_facts":{"scan":{"source":"repo_scan","observed_at":"2026-09-20T07:08:18.702Z"},"has_cli":{"value":true,"source":"pyproject.toml:[project.scripts]","observed_at":"2026-09-20T07:08:18.702Z"},"languages":{"value":["python"],"source":"github.language+pyproject.toml","observed_at":"2026-09-20T07:08:18.702Z"},"license_spdx":{"value":"MIT","source":"github.license","observed_at":"2026-09-20T07:08:18.702Z"}},"decision_facts":{"hosting":null,"pricing":{"model":"freemium","summary":"Free to use, no direct cost for using gTTS; any costs are passed on by Google in relation to usage of their API."},"requirements":{"min_ram_gb":null,"requires_docker":false},"constraints":{"min_ram_gb":null,"pricing_model":"freemium","requires_docker":false},"when_to_use":["You need to generate short audio clips from text dynamically within your applications without the overhead of setting up an official cloud service.","Your project focuses on simplicity in implementation, requiring minimal setup beyond installing a Python library and using simple commands or small code snippets."],"when_not_to_use":["You require advanced customization options for voice parameters such as pitch, speed, or gender which are more granular than what gTTS can provide.","Your application has legal constraints that prevent the use of unofficial APIs, or you need features backed by official support and service-level agreements from Google Cloud Text-to-Speech."],"source":"enrich:decision_facts","observed_at":"2026-07-17T00:12:50.715Z"},"constraint_facets":{"min_ram_gb":null,"pricing_model":"freemium","requires_docker":false},"decision_summary":[{"label":"Pricing","value":"freemium - Free to use, no direct cost for using gTTS; any costs are passed on by Google in relation to usage of their API."},{"label":"Adopt for","value":"gTTS is a Python library and CLI tool that interfaces with Google Translate's text-to-speech API to convert text into speech and save it as an MP3 file."},{"label":"License detail","value":"The MIT License (MIT), a permissive free software license originating from the X11 project."}]}}