It's absolutely crucial for people with speech impairments like aphonia or dysphonia. It ensures inclusivity and allows everyone to participate fully, promoting accessibility and community engagement.

Setup#

1. Install Wamellow on your server by going to wamellow.com/add.
2. Head to the dashboard by going to wamellow.com/dashboard.
3. 🎉 Done! Use the commands /tts voice to talk inside voice channels.
   
   

Chat to Speech (optional)

3. Select a channel to be used in the "Text to Speech" section on the website
4. Join any voice channel in your Server (be sure Wamellow can join and talk in it).
5. 🎉 Done! Start writing messages in the selected channel for Wamellow to speak!
   
   

To get a quick .mp3 file of your message, use /tts file in any text channel. You can also generate Text to Speech files online.

📑 Usage logs#

Pick a channel where any Text to Speech events from your server should be logged, mainly for moderation purposes.

Note: This does not log any /tts file command usage.

😷 Priority role#

Pick a role that lets users override other messages that are currently being spoken. This lets users start talking right away without the "please wait..." message popping up. It's a good idea to give this role to people who are actually disabled.

🤚 Blacklist role#

Specify a role that is restricted from using Text-to-Speech.

🔉 Announce user#

Wamellow will announce which user is currently talking through it. If a user says "hello there," the bot will speak "Luna says: hello there."

Note: This feature is experimental. Please note that usernames written in languages other than the actual written message will cause the Text to Speech to fail.

🛒 Message queue#

Queue up sent chat to speech messages, to be spoken in the order they were sent. This is useful for long conversations or when multiple users want to speak at once and will prevent any messages from being skipped and Wamellow returning an error stating that someone else's message is still being spoken.

🔏 Max message length#

Set a maximum length for messages to avoid spamming.

Discord Nitro members can send messages with up to 4,000 characters, while non-Nitro members can only send 2,000. This is a Discord limitation.

While this feature is free, we would be grateful if you could consider shooting us a donation or voting on top.gg. Please note that messages longer than 300 characters are vote locked. Unfortunately, money and growth (sadly) don't grow on trees (money isn't exactly normal paper).

🤚 Blacklist users & roles#

If you want to prevent certain users from using text or chat to speech, you can either use Discord's channel or integration permission system. (watch a tutorial)

Moderation#

You can use Wamellow's native <:badge_automod:1307719909618225263> AutoMod to block certain words or phrases for Text-to-Speech by setting up rules on your server's Moderation tab. Separate words or phrases with a comma (e.g., dog, cat, tiger) or a new line. For each word, use an asterisk (*) at the beginning, end, or both for partial matching.

Members with Manage Server or Administrator permissions will bypass AutoMod. Separate whitelisted roles and channels can also be added to bypass AutoMod in the moderation settings.

Note: For /tts commands, only Wamellow's native AutoMod can block messages. Chat-to-Speech messages can also be blocked by Discord's native AutoMod — and all other bots that rely on it — in addition to Wamellow's own. If you're using a third-party moderation system, such as other bots, that only delete messages after they were sent, rather than blocking them directly, will not be able to block messages for Text-to-Speech.

Avoiding Chat-to-Speech#

To prevent Wamellow from speaking your messages inside of Chat to Speech channels, simply take the following actions:

• Just add some special characters at the start of your message, like !, ?, >, ., , and so on.
• If you're not connected to any voice channels, those messages will also be ignored.
• If you want to disable it permanently, you can use /tts set chat-to-speech.
  
  

Note: Any of those methods only apply to you and your own messages, and not to anyone else using chat to speech. If you want to disable it for everyone, read the setup section of these docs.

Voice filters#

Filters are a way to tamper with the voices when using Wamellow in VCs, they can be toggled using /tts set filter by VC moderators. This setting applies to anyone currently using Wamellow in the VC, all filters will be removed once Wamellow leaves. Some filters can be enabled and used at the same time. Pitch and Speed may not be used with other filters. Choosing a filter may override the pitch and speed settings.

All currently available filters:

• Vaporwave
• Nightcore
• Rotation
• Tremolo
• Vibrato
• LowPass
• Pitch (customizable between 0% and 100%; default 50%)
• Speed (customizable between 1% and 100%; default 50%)
  
  

To change the volume of the TTS or mute it entirely for yourself,

• (desktop) Right-click Wamellow, and set the "User Volume" slider.
• (mobile) Open Wamellows' profile, and set the "Volume" slider.

Voices#

You can change your default language and voice either by running /tts set speaker or by setting it on the dashboard.

You can also change the voice on a per-message basis by setting the voice option when using /tts file or /tts voice, i.e.: /tts voice text:Hello World voice:en_female_samc. This can also be combined with the auto translate flag.

🌎 Auto Translate#

Automatically translate messages from any language to match your current voice's language for free.

• For Commands: Set the translate option to yes (i.e.: /tts voice text:Hallo Welt translate:yes)
• For Chat to Speech: Append -tr to the end of your message (i.e.: Hallo Welt -tr)

<:YA_PepeStare:832631300132438046> List of Available Voices#

Server nodes & regions#

For optimal latency and performance when using Text to Speech in voice channels, Wamellow has multiple server nodes in different regions. A list of available nodes and regions can be found on the status page.

If the voice channel's Region Override is set to Automatic, it will default to Frankfurt, Germany. If an override is set, it will use the selected region, if available.

Troubleshooting#

If Wamellow joins the voice channel but doesn't speak, check that it has the Connect and Speak permissions in the channel settings. If it does, please report the issue to us.

If Wamellow says that someone else's message is still being spoken, but it's not talking, use /tts stop. You can also use this to stop any message that is currently being spoken (i.e.: because of spam).