{"id":16195251,"url":"https://github.com/mrf345/django_gtts","last_synced_at":"2025-03-19T04:30:52.570Z","repository":{"id":46857076,"uuid":"140072358","full_name":"mrf345/django_gtts","owner":"mrf345","description":"Django app extension to add gTTS google text-to-speech","archived":false,"fork":false,"pushed_at":"2021-09-22T17:43:08.000Z","size":34,"stargazers_count":7,"open_issues_count":4,"forks_count":8,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-19T13:40:33.546Z","etag":null,"topics":["django","google","gtts","text-to-speech"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrf345.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-07-07T09:51:36.000Z","updated_at":"2023-06-16T13:28:28.000Z","dependencies_parsed_at":"2022-08-27T05:21:06.584Z","dependency_job_id":null,"html_url":"https://github.com/mrf345/django_gtts","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrf345%2Fdjango_gtts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrf345%2Fdjango_gtts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrf345%2Fdjango_gtts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrf345%2Fdjango_gtts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrf345","download_url":"https://codeload.github.com/mrf345/django_gtts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243971156,"owners_count":20376784,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["django","google","gtts","text-to-speech"],"created_at":"2024-10-10T08:26:48.090Z","updated_at":"2025-03-19T04:30:52.293Z","avatar_url":"https://github.com/mrf345.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align='center'\u003e Django-Gtts \u003c/h1\u003e\n\u003cp align='center'\u003e\n\u003ca href='https://travis-ci.com/mrf345/django_gtts'\u003e\u003cimg src='https://travis-ci.com/mrf345/django_gtts.svg?branch=master' /\u003e\u003c/a\u003e\u003ca href='https://coveralls.io/github/mrf345/django_gtts?branch=master'\u003e\u003cimg src='https://coveralls.io/repos/github/mrf345/django_gtts/badge.svg?branch=master' alt='Coverage Status' /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003ch3 align='center'\u003e\n    A Django app to add gTTS google text-to-speech to the template \n    and cache generated text-to-speech .mp3 files.\n\u003c/h3\u003e\n\n## Install:\n\n#### - With pip\n\u003e - `pip install Django-Gtts` \u003cbr /\u003e\n\n#### - From the source:\n\u003e - `git clone https://github.com/mrf345/django_gtts.git`\u003cbr /\u003e\n\u003e - `cd django_gtts` \u003cbr /\u003e\n\u003e - `python setup.py install`\n\n## Setup:\n#### - Add it to the `settings.py` in `INSTALLED_APPS`:\n```python\nINSTALLED_APPS = [\n    'gTTS',\n    ...\n]\n```\n\u003e After adding the app make sure to do migration for caching model :\n\u003e - `python manage.py makemigrations gTTS`\n\u003e - `python manage.py migrate gTTS`\n\n#### - Inside your [Django Template](https://docs.djangoproject.com/en/2.2/topics/templates/):\n\u003e NOTE: `load gTTS` should be used once in the begining of every template that uses `say`, Or once in the begining of the base template.\n```jinja\n{% load gTTS %}\n\u003caudio\n    src=\"{% say 'en-us' 'text to say' %}\"\n    controls\n\u003e\u003c/audio\u003e\n```\n\n#### - To add a dynamic translation view to `urls.py`: \n```python\nfrom django.urls import path, include\n\nurlpatterns = [\n    ...\n    # for unauthorized access dynamic translation \n    path('gtts/', include('gTTS.urls')),\n    # for user authorized dynamic translation\n    path('gtts_auth/', include('gTTS.urls_auth')),\n    ...\n]\n```\n\u003e now you can access `http://localhost:8000/\u003clanguage\u003e/\u003ctext\u003e` and, it should return json response `{'mp3': 'static mp3 link'}`\n\n#### - To clean up stored cache of mp3 files and modal records\n```python\nfrom gTTS.cache import remove_cache\n\nremove_cache()\n```\n\n\n## - Options:\n```python\nsay(\n    language='en-us', # language to convert text to\n    text='say hi'): # text to be converted`_\u003cbr /\u003e\n```\n\n\n#### - List of supported languages:\n\n`\n    'af' : 'Afrikaans'\n    'sq' : 'Albanian'\n    'ar' : 'Arabic'\n    'hy' : 'Armenian'\n    'bn' : 'Bengali'\n    'ca' : 'Catalan'\n    'zh' : 'Chinese'\n    'zh-cn' : 'Chinese (Mandarin/China)'\n    'zh-tw' : 'Chinese (Mandarin/Taiwan)'\n    'zh-yue' : 'Chinese (Cantonese)'\n    'hr' : 'Croatian'\n    'cs' : 'Czech'\n    'da' : 'Danish'\n    'nl' : 'Dutch'\n    'en' : 'English'\n    'en-au' : 'English (Australia)'\n    'en-uk' : 'English (United Kingdom)'\n    'en-us' : 'English (United States)'\n    'eo' : 'Esperanto'\n    'fi' : 'Finnish'\n    'fr' : 'French'\n    'de' : 'German'\n    'el' : 'Greek'\n    'hi' : 'Hindi'\n    'hu' : 'Hungarian'\n    'is' : 'Icelandic'\n    'id' : 'Indonesian'\n    'it' : 'Italian'\n    'ja' : 'Japanese'\n    'km' : 'Khmer (Cambodian)'\n    'ko' : 'Korean'\n    'la' : 'Latin'\n    'lv' : 'Latvian'\n    'mk' : 'Macedonian'\n    'no' : 'Norwegian'\n    'pl' : 'Polish'\n    'pt' : 'Portuguese'\n    'ro' : 'Romanian'\n    'ru' : 'Russian'\n    'sr' : 'Serbian'\n    'si' : 'Sinhala'\n    'sk' : 'Slovak'\n    'es' : 'Spanish'\n    'es-es' : 'Spanish (Spain)'\n    'es-us' : 'Spanish (United States)'\n    'sw' : 'Swahili'\n    'sv' : 'Swedish'\n    'ta' : 'Tamil'\n    'th' : 'Thai'\n    'tr' : 'Turkish'\n    'uk' : 'Ukrainian'\n    'vi' : 'Vietnamese'\n    'cy' : 'Welsh'\n`\n\n## Credit:\n\u003e - [gTTS][2c6d97b1]: Python Google text-to-speech\n\n  [2c6d97b1]: https://github.com/pndurette/gTTS \"gTTs repo\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrf345%2Fdjango_gtts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrf345%2Fdjango_gtts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrf345%2Fdjango_gtts/lists"}