.env

This file contains API keys and settings related to the services AI-TTS-Donations uses. You really shouldn't share anything here!

Uberduck

To obtain an Uberduck API key, first create an account at uberduck.ai, then add an API key (under account management).

API Key The "key" part of the API key. API Secret The "secret" part of the API key.

Twitch

Log into Twitch's dev platform and register an application. Name is unimportant, but you must add two OAuth Redirect URLs: http://localhost:17563/ and http://localhost:17563. (One has a backslash at the end, the other doesn't.)
Make sure to generate a new secret!

Client ID The "Client ID" of the application. Secret The "Client Secret" of the application, obtained after clicking the "New Secret" button. Twitch Username Your Twitch username. Your MM API Key (Optional) The API key you get from either the Twitch extension or other private ways.

StreamElements

If you are using StreamElements, you can get your JWT token from here. Simply go to the channel, check the "Show Secrets" checkbox (!! DO NOT SHOW THIS ON STREAM !!), then copy and paste the JWT token into here!

JWT Token Your JWT token from your StreamElements settings page.

config.json

This file contains config settings for AI-TTS-Donations.

Maximum message length The maximum character length for the donation message. Use: Bits Listen for Twitch Bit donations. Channel Points Listen for Twitch Channel Points reward redemptions. Minimum Bit Amount The minimum amount of bits to donate for the TTS to activate.
(Note: You might want to subtract one from this, just in case.) Minimum Tip Amount The minimum amount of the StreamElements tip amount to donate for the TTS to activate.
(Note: You might want to subtract one from this, just in case.) Channel Points Reward The reward name for your Channel Point reward.
This must be the same as in your Twitch Dashboard. Blacklisted Words A list of words that will be blacklisted from the TTS, separated by commas. Blacklisted Voices A list of voices that will be blacklisted from the TTS, separated by commas. Query Tries The number of times to query the API for a TTS response. 100 is probably fine. Fallback Voice A voice that the bot automatically falls back to just in case the user's inputted voice doesn't exist. This uses the same voice ID codes as Uberduck. Voice Aliases (Optional) A dictionary of aliases for voices. First key being the alias, second key being the original.\nAlso, you must edit this in an external text editor at the moment. The text box shown here has an example of an alias.

How do I even use these files?

After you've filled this out, download both files (there's a download button) and put them in AI-TTS-Donation's folder (where bot.py is).

On some systems or browsers, you may need to rename "env" to ".env" (with a dot at the start, and nothing before the dot)! Sorry about that.

Do you want your viewers to see the progress of their TTS requests?

Just add in the overlay! Simply add a browser source on OBS, check the "Local File" box, then browse to where your TTS bot is stored! There will be a folder called "overlay" in which you can add "index.html" as a browser source and it will show to your viewers!