A fast VC TTS bot
  • Kotlin 98.2%
  • Dockerfile 1.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-15 17:21:37 -04:00
.idea use modern version system, speed up dockerfile, update gradle 2026-10-11 11:24:38 -04:00
gradle use modern version system, speed up dockerfile, update gradle 2026-10-11 11:24:38 -04:00
src/main better ping information 2026-10-15 17:21:37 -04:00
.gitignore feat: other important features 2026-04-09 16:50:48 -04:00
build.gradle.kts use modern version system, speed up dockerfile, update gradle 2026-10-11 11:24:38 -04:00
Dockerfile use modern version system, speed up dockerfile, update gradle 2026-10-11 11:24:38 -04:00
gradle.properties feat(fix): emoji support, added missing edge cases, skip command, tone indicators, and better performance overall 2026-04-29 22:55:40 -04:00
gradlew feat: initial commit 2026-04-09 11:31:31 -04:00
gradlew.bat feat: initial commit 2026-04-09 11:31:31 -04:00
LICENSE feat: other important features 2026-04-09 16:50:48 -04:00
README.md better ping information 2026-10-15 17:21:37 -04:00
settings.gradle.kts feat: initial commit 2026-04-09 11:31:31 -04:00

Speech and Spell

Now spell... PAUL

A custom-made TTS bot because the others felt too slow. Add me today!

Features

  • Clear speech
  • Announces images and embeds
  • DecTalk syntax support
  • Open source (duh)
  • Pretty quick
    • Time-to-first-sample averages ~200ms warm to ~800ms cold
    • Actual time may be slightly longer due to latency introduced by Discord
  • Customizable prefixes and nicknames
  • Message edit support
  • Announces reactions
  • Reads emojis, tone indicators, abbreviations, and won't read URLs
  • Admin skip and clear commands

Motivation

I personally don't like to use my mic when in voice channels in discord, usually resorting to no mic or the voice chat text channel.

Some cool people have made TTS bots that announce out the messages from the channels so that people with "no mic" don't get ignored. However, the particular one I was using in a server was so slow that it was unbearable.

So, with help from a friend (who already have a speech synthesis API set up) I made this bot out of spite of the other one.

Building

Note

Requires Java 25! This is a hard requirement, unfortunately. Either that, or make my build 2x larger

Run ./gradlew build and pray

Deploying

Create a .env file in the root of your working directory with the following contents:

BOT_TOKEN=<your token here>
API_URL=<your api>
DATABASE=sqlite
# optional: if you are using Postgres
POSTGRES_PORT=5432
POSTGRES_USER=<username>
POSTGRES_PASSWORD=<password>

Next, run the .jar resulting from the ./gradlew build

$ java -jar SpeechAndSpell-1.0.0-all.jar

Optionally: use the included dockerfile for almost complete setup (except .env)