Mudmouth

                     _                 _   _
 _ __ ___  _   _  __| |_ __ ___   ___ | | | |_ ____
| '_ ` _ \| | | |/ _` | '_ ` _ \ / _ \| |_| | '_  /
| | | | | | |_| | (_| | | | | | | (_) |  _  | | | |
|_| |_| |_|\__,_|\__,_|_| |_| |_|\___/|_| |_|_| |_|

Mudmouth is a cross-platform, classic-MUD-inspired TUI for EverQuest Legends. It follows an EverQuest log, gives NPC dialogue a Kokoro-FastAPI voice, and remembers the chosen voice for each NPC. It is entirely local: your log, speaker mappings, generated audio, and TTS endpoint stay on your computer.

What it does

Watches an EverQuest log without replaying historical lines on startup.
Speaks Name says, '…' NPC dialogue by default.
Calls GET /health, shows live Kokoro connectivity in the status bar, and refreshes its selectable voice catalog from GET /v1/audio/voices.
Sends non-streaming WAV requests to POST /v1/audio/speech and plays clips sequentially with native audio support.
Repeats an NPC's identical line at 1.5x speed, then 2x speed when each repeat arrives within 15 seconds; a later line returns to normal speed.
Picks a real voice from your Kokoro server for a newly seen NPC and saves it.
Lets you pin an NPC to a particular voice, reroll a persistent random voice, or set the NPC to get a new random voice for every line.
Can optionally narrate zone entries (You have entered Lake Rathetear.). This is disabled by default, as are future optional message categories.

Requirements

A reachable Kokoro-FastAPI instance. Install and run it using the upstream Kokoro-FastAPI instructions; Mudmouth uses http://127.0.0.1:8880 by default.
An EverQuest log with /log on.

No ffplay, mpv, PipeWire command, or other external audio player is required; Mudmouth plays returned WAV audio itself.

Build and run

See development and build notes for local setup, running Mudmouth, validation, and multi-platform release packaging.

TUI controls

Key	Action
`d`	Dashboard / live tavern scroll
`s`	Settings
`p`	Choose EverQuest game folder during first-time setup
`r`	Rescan for character logs during first-time setup
`v`	NPC voice manager
`?`	Help
`q`	Quit
`↑` / `↓`, `j` / `k`	Move selection
`Enter`, `Space`	Edit or toggle a setting
`←` / `→`, `h` / `l`	Choose a voice
`p`	Pin selected NPC to selected voice
`r`	Random voice every NPC line
`x`	Choose a fresh persistent random voice
`Esc`	Close a menu or edit box

Data and privacy

Mudmouth writes only two human-readable files in the operating system's standard application-data directory:

config.toml — endpoint, log path, event toggles, and playback settings
speakers.json — NPC names, voice modes, and last-seen context

On Linux this is normally ~/.local/share/mudmouth; the equivalent platform directory is used on macOS and Windows.

The repeat behavior can be adjusted in config.toml:

repeat_window_seconds = 15
repeat_second_speed = 1.5
repeat_third_plus_speed = 2.0

3.3 KiB Raw Blame History