Files
tuimble/docs/DEBUG.md
Username 836018d146 feat: scaffold tuimble TUI mumble client
Core modules: TUI app (textual), mumble protocol client,
audio pipeline (sounddevice + opus), push-to-talk with
kitty protocol / evdev / toggle backends. Config via TOML.
2026-02-24 11:44:06 +01:00

858 B

Debugging

Verbose Mode

tuimble --verbose                # (planned)

Common Issues

No audio devices found

python3 -c "import sounddevice; print(sounddevice.query_devices())"

Check that portaudio is installed and devices are accessible.

opuslib import error

python3 -c "import opuslib"

If this fails, install libopus: apt install libopus0

Kitty protocol not detected

Verify terminal supports the Kitty keyboard protocol. Known working: Kitty, WezTerm, Ghostty, foot.

evdev permission denied

ls -la /dev/input/event*
groups                           # should include 'input'

Add user to input group: sudo usermod -aG input $USER

Connection refused

  • Verify server address and port
  • Check firewall allows outbound TCP/UDP to port 64738
  • Test with: nc -zv <host> 64738