tuimble

TUI Mumble client with voice support and push-to-talk.

Features

• Terminal-based UI (Textual)
• Voice transmission with Opus codec
• Push-to-talk via Kitty keyboard protocol, evdev, or toggle
• Channel browsing and text chat
• Chat input history (Up/Down arrow navigation)
• Self-deafen toggle

Key Bindings

Key	Action
Tab	Cycle focus (chat input / channel tree)
F1	Toggle self-deafen
F4	Push-to-talk (configurable)
Enter	Send message / join channel (sidebar)
Up	Previous message (input) / previous channel (sidebar)
Down	Next message (input) / next channel (sidebar)
q	Quit
Ctrl+C	Quit

Quick Start

make setup
make run

Configuration

mkdir -p ~/.config/tuimble

~/.config/tuimble/config.toml:

[server]
host = "mumble.example.com"
port = 64738
username = "myname"

[ptt]
key = "f4"
mode = "hold"
backend = "auto"

Requirements

• Python 3.11+
• libopus
• portaudio (libportaudio2)
• A Mumble server to connect to