Skip to content

README.md

Latest commit

 

History

History
105 lines (74 loc) · 3.97 KB

README.md

File metadata and controls

105 lines (74 loc) · 3.97 KB

TikTok TTS

GitHub Release GitHub Activity License

hacs Project Maintenance

Integration to use the reverse engineered TikTok speech API by Weilbyte.

As @Weilbyte work is based on the following repository, I want to attribute them here as well.

https://github.com/oscie57/tiktok-voice

Visit their page and appreciate their work as well!

This integration will set up the following platforms.

Platform Description
tts Generate a audio file based on given input text to play over speakers.

Installation

There are two methods to install this custom_integration.

Installation with HACS

As this is a HACS component, you can simply add this repository philipp-luettecke/tiktoktts as custom repository to HACS and afterwards search for the TikTokTTS Integration. Now you can install it.

  1. Add https://github.com/philipp-luettecke/tiktoktts to HACS as custom repository
  2. Install TikTokTTScomponent
  3. Restart Home Assistant
  4. Now add tiktoktts as platform in your configuration.yaml
tts:
  - platform: tiktoktts

Manual Installation

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called tiktoktts.
  4. Download all the files from the custom_components/tiktoktts/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. Now add tiktoktts as platform in your configuration.yaml
tts:
  - platform: tiktoktts

How to use

After installing the integration you will be presented with a new Service tiktoktts_say. You can now call this service and add a option voice to select one of the voices available in custom_component/tiktoktts/const.py.

I'm trying to keep the list equivalent to the voices available on the original tiktok-voice rpositories Wiki page.

service: tts.tiktoktts_say
data:
  cache: false
  message: Sample Text
  entity_id: media_player.<entity_id>
  options:
    voice: en_us_001

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines
⚡