{"id":30304764,"url":"https://github.com/jmdevita/chatterbox-ha","last_synced_at":"2025-08-17T07:33:06.117Z","repository":{"id":306683268,"uuid":"1026896937","full_name":"jmdevita/chatterbox-ha","owner":"jmdevita","description":"Unofficial Chatterbox Integration for Home Assistant","archived":false,"fork":false,"pushed_at":"2025-07-27T02:14:42.000Z","size":35,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-12T00:43:23.158Z","etag":null,"topics":["chatterbox-tts","custom-integration","hacs","hacs-integration","home-assistant"],"latest_commit_sha":null,"homepage":"","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/jmdevita.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-26T21:13:06.000Z","updated_at":"2025-07-27T02:14:45.000Z","dependencies_parsed_at":"2025-07-27T03:38:44.564Z","dependency_job_id":"94ce7718-df35-4fef-94e1-6b0ae3574334","html_url":"https://github.com/jmdevita/chatterbox-ha","commit_stats":null,"previous_names":["jmdevita/chatterbox-ha"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jmdevita/chatterbox-ha","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmdevita%2Fchatterbox-ha","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmdevita%2Fchatterbox-ha/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmdevita%2Fchatterbox-ha/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmdevita%2Fchatterbox-ha/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jmdevita","download_url":"https://codeload.github.com/jmdevita/chatterbox-ha/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmdevita%2Fchatterbox-ha/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270820679,"owners_count":24651515,"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","status":"online","status_checked_at":"2025-08-17T02:00:09.016Z","response_time":129,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["chatterbox-tts","custom-integration","hacs","hacs-integration","home-assistant"],"created_at":"2025-08-17T07:33:05.404Z","updated_at":"2025-08-17T07:33:06.112Z","avatar_url":"https://github.com/jmdevita.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chatterbox TTS Integration for Home Assistant\n\nThis is an unofficial Home Assistant integration for the Chatterbox-TTS-Server, a powerful, self-hosted text-to-speech engine created by devnen.\n\nThis integration allows you to use your self-hosted Chatterbox server as a Text-to-Speech (TTS) provider within Home Assistant, enabling you to generate dynamic voice notifications for your automations.\n\n-----\n\n## Prerequisites\n\nBefore installing this integration, you must have a running instance of the [Chatterbox-TTS-Server](https://github.com/devnen/Chatterbox-TTS-Server). Please follow the setup instructions in that repository to get your server up and running.\n\n## Installation\n\nThe recommended way to install this integration is through the Home Assistant Community Store (HACS).\n\n1.  **Add Custom Repository:**\n\n      * Go to HACS in your Home Assistant.\n      * Click on \"Integrations\", then click the three dots in the top right corner and select \"Custom repositories\".\n      * Add the URL to this repository in the \"Repository\" field.\n      * Select \"Integration\" as the category.\n      * Click \"Add\".\n\n2.  **Install the Integration:**\n\n      * Search for \"Chatterbox TTS\" and install it.\n\n3.  **Restart Home Assistant:**\n\n      * Restart your Home Assistant instance to complete the installation.\n\n## Configuration\n\nConfiguration is done entirely through the Home Assistant user interface.\n\n1.  **Navigate to Devices \u0026 Services:**\n\n      * Go to **Settings** \\\u003e **Devices \u0026 Services**.\n      * Click the **+ Add Integration** button in the bottom right corner.\n\n2.  **Search for Chatterbox TTS:**\n\n      * Search for \"Chatterbox TTS\" and select it.\n\n3.  **Enter Server URL:**\n\n      * You will be prompted to enter the address of your Chatterbox TTS Server. Provide the base address and port (e.g., `192.168.1.100:8004`).\n      * The integration will automatically connect to your server to fetch the list of available voices.\n\n4.  **Configure Voice and Settings:**\n\n      * On the next screen, select your desired default voice from the dropdown menu. This list is dynamically populated from your server.\n      * You can also set the default speech speed and a random seed value if desired.\n      * Click \"Submit\".\n\nThe integration is now configured and ready to use\\!\n\n## Usage\n\nYou can use the Chatterbox TTS service in your automations and scripts. The entity will be named based on the voice you selected during setup (e.g., `tts.chatterbox_tts_abigail`).\n\n### Basic Example\n\nHere is a basic example of how to use the service in a script to broadcast a message to a media player.\n\n```yaml\n- alias: \"Announce Visitor\"\n  sequence:\n    - service: tts.speak\n      target:\n        entity_id: tts.chatterbox_tts_abigail # Use the entity name from your setup\n      data:\n        media_player_entity_id: media_player.living_room_speaker\n        message: \"Hello, someone is at the front door.\"\n```\n\n### Overriding Default Options\n\nYou can override the default `voice`, `speed`, and `seed` directly in your service call. This is useful for creating dynamic announcements with different voice characteristics.\n\n```yaml\n- alias: \"Critical Alert\"\n  sequence:\n    - service: tts.speak\n      target:\n        entity_id: tts.chatterbox_tts_abigail\n      data:\n        media_player_entity_id: media_player.living_room_speaker\n        message: \"Warning: Water leak detected in the basement.\"\n        options:\n          voice: \"Adrian.wav\"  # Override the default voice\n          speed: 1.2           # Speak slightly faster, but may cause echoing\n          seed: 12345          # Use a specific seed for consistency\n```\n\n## Credits\n\n  * This integration was created to work with the excellent **Chatterbox-TTS-Server** by **devnen** and the [Chatterbox-TTS](https://github.com/resemble-ai/chatterbox) work by the Resemble.AI team. Thank you!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmdevita%2Fchatterbox-ha","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjmdevita%2Fchatterbox-ha","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmdevita%2Fchatterbox-ha/lists"}