{"id":21769931,"url":"https://github.com/mideind/icespeak","last_synced_at":"2025-04-13T16:32:43.783Z","repository":{"id":192569613,"uuid":"628778972","full_name":"mideind/Icespeak","owner":"mideind","description":"Icelandic-language speech synthesis with Python","archived":false,"fork":false,"pushed_at":"2024-10-29T17:55:24.000Z","size":328,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-29T18:57:45.583Z","etag":null,"topics":["icelandic","icelandic-language","speech-synthesis","text-to-speech"],"latest_commit_sha":null,"homepage":"https://mideind.is","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mideind.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-17T00:51:19.000Z","updated_at":"2024-10-29T17:55:25.000Z","dependencies_parsed_at":"2023-09-05T02:55:01.353Z","dependency_job_id":"60794b48-183c-489b-a6f5-061b52edabc9","html_url":"https://github.com/mideind/Icespeak","commit_stats":null,"previous_names":["mideind/icespeak"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mideind%2FIcespeak","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mideind%2FIcespeak/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mideind%2FIcespeak/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mideind%2FIcespeak/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mideind","download_url":"https://codeload.github.com/mideind/Icespeak/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248743890,"owners_count":21154761,"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":["icelandic","icelandic-language","speech-synthesis","text-to-speech"],"created_at":"2024-11-26T14:10:40.247Z","updated_at":"2025-04-13T16:32:43.763Z","avatar_url":"https://github.com/mideind.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![Python 3.9](https://img.shields.io/badge/python-3.9-blue.svg)](https://www.python.org/downloads/release/python-390/)\n[![Release](https://shields.io/github/v/release/mideind/Icespeak?display_name=tag)]()\n[![PyPI](https://img.shields.io/pypi/v/icespeak?logo=pypi)](https://pypi.org/project/icespeak/)\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n[![tests](https://github.com/mideind/Icespeak/actions/workflows/main.yml/badge.svg)]()\n\n# Icespeak\n\n_Icespeak_ is a Python 3.9+ library that makes Icelandic-language speech synthesis easy.\n\n## Local installation\n\n\u003e _Note: The Azure TTS package currently only supports OpenSSL version 3.0.\\*_\n\nClone the repository and cd into the folder.\nThen create and activate a virtual environment:\n\n```sh\npython3 -m venv venv\nsource venv/bin/activate\n```\n\nInstall minimal set of dependencies to use the library:\n\n```sh\npython3 -m pip install .\n```\n\nIn order to use the CLI interface, `tts`, install with:\n\n```sh\npython3 -m pip install '.[cli]'\n```\n\nAlternatively, to install in editable mode with extra dev dependencies:\n\n```sh\npython3 -m pip install -e '.[dev]'\n```\n\n## Usage\n\nBefore using, place API keys for the relevant services in the `/keys` folder\n(or a folder specified by the `ICESPEAK_KEYS_DIR` environment variable).\n\nAlternately, you can set the following environment variables:\n\n```sh\nexport ICESPEAK_AWSPOLLY_API_KEY=your-aws-polly-api-key\nexport ICESPEAK_AZURE_API_KEY=your-azure-api-key\nexport ICESPEAK_GOOGLE_API_KEY=your-google-api-key\nexport ICESPEAK_OPENAI_API_KEY=your-openai-api-key\n```\n\nOutput audio files are saved to the directory specified\nby the `ICESPEAK_AUDIO_DIR` environment variable.\nBy default Icespeak creates the directory `\u003cTEMP DIR\u003e/icespeak`\nwhere `\u003cTEMP DIR\u003e` is the temporary directory on your platform,\nfetched via `tempfile.gettempdir()`.\n\nBy default, generated audio files are removed upon a clean exit,\nbut this can be disabled by setting `ICESPEAK_AUDIO_CACHE_CLEAN=0`.\n\n### Text-to-speech\n\nSimple example of TTS, which includes phonetic transcription:\n\n```py\nfrom icespeak import tts_to_file, TTSOptions\ntext = \"\"\"\\\nÞetta er texti fyrir talgervingu. \\\nÍ honum er ýmislegt sem mætti vera hljóðritað, \\\nt.d. ræður talgerving oft illa við íslenskar skammstafanir, \\\ntölvupósta eins og ekki.tolvupostur@vefsida.is,\neða prósentur eins og 48,3%, o.fl.\\\n\"\"\"\ntts_out = tts_to_file(\n    text,\n    TTSOptions(\n        text_format=\"text\", # Set to 'ssml' if SSML tags in text should be interpreted\n        audio_format=\"mp3\", # Output audio will be in mp3 format\n        voice=\"Gudrun\" # Azure TTS voice\n    ),\n    transcribe=True # Default is True\n)\nprint(tts_out.file) # pathlib.Path instance pointing to file on local file system\nprint(tts_out.text) # text that was sent to the TTS service (after the phonetic transcription)\n```\n\nResults are cached, so subsequent calls with the same arguments should be fast.\n\n## License\n\nIcespeak is Copyright \u0026copy; 2024 [Miðeind ehf.](https://mideind.is)\n\n\u003ca href=\"https://mideind.is\"\u003e\u003cimg src=\"https://github.com/mideind/Icespeak/blob/master/img/mideind_logo.png?raw=true\" alt=\"Miðeind ehf.\"\n    width=\"214\" height=\"66\" align=\"right\" style=\"margin-left:20px; margin-bottom: 20px;\"\u003e\u003c/a\u003e\n\nThis set of programs is free software: you can redistribute it and/or modify it\nunder the terms of the GNU General Public License as published by the Free\nSoftware Foundation, either version 3 of the License, or (at your option) any later\nversion.\n\nThis set of programs is distributed in the hope that it will be useful, but WITHOUT\nANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR\nA PARTICULAR PURPOSE. See the GNU General Public License for more details.\n\n\u003ca href=\"https://www.gnu.org/licenses/gpl-3.0.html\"\u003e\u003cimg src=\"https://github.com/mideind/Icespeak/blob/master/img/GPLv3.png?raw=true\"\nalign=\"right\" style=\"margin-left:15px;\" width=\"180\" height=\"60\"\u003e\u003c/a\u003e\n\nThe full text of the GNU General Public License v3 is\n[included here](https://github.com/mideind/Icespeak/LICENSE.txt)\nand also available here: [https://www.gnu.org/licenses/gpl-3.0.html](https://www.gnu.org/licenses/gpl-3.0.html).\n\nIf you wish to use this set of programs in ways that are not covered under the\nGNU GPLv3 license, please contact us at [mideind@mideind.is](mailto:mideind@mideind.is)\nto negotiate a custom license. This applies for instance if you want to include or use\nthis software, in part or in full, in other software that is not licensed under\nGNU GPLv3 or other compatible licenses.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmideind%2Ficespeak","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmideind%2Ficespeak","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmideind%2Ficespeak/lists"}