mumble-voip/mumble

Support of variuous PTT hardware

Open

#6,784 opened on Apr 16, 2025

View on GitHub
 (7 comments) (0 reactions) (0 assignees)C++ (5,642 stars) (1,062 forks)batch import
GlobalShortcutsclientfeature-requesthelp wanted

Description

Context

There are plenty of PTT apps exist on a market mostly for mobile devices and they already have existing hardware which meant to be used in scenarios similar to Mumble. Most of that hardware has APIs and protocols which are open and well documented such as PTT mics, headsets and buttons for Zello, NuovoTeam, RealPTT.

Description

Add support for PTT hardware

Mumble component

Client

OS-specific?

No

Additional information

I did a quick prototype using my AinaPTT Remote-Speaker-Microphone. In essence its just a BT headset with a serial port for buttons data. Documented both on Zello and Aina websites

So the simple python sketch which reads serial input and simulates a hotkey press for Mumble woks as a charm =)

import serial, keyboard

with serial.Serial('COM18', 115200, timeout=0.1) as ser:
    print("Connected")
    while(True):
        rxdata = ser.read(8)
        #print(str(rxdata))
        if rxdata == b'+PTT=P':
            print('PTT DOWN')
            keyboard.press("capslock")
        elif rxdata == b'+PTT=R':
            print('PTT UP')
            keyboard.release("capslock")

Would be great to implement it natively in Mumble app. I don't have experience with BLE stack so I don't know how much work is needed to add this, but serial port looks pretty simple and platform agnostic.

Contributor guide

Tech stack
cpp
Domain
desktop
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
needs maintainer response
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
needs investigation
Prerequisites
Basic understanding of serial communicationC++ programming experience
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
35
Research direction
The issue proposes adding native support for PTT hardware like Zello and Aina remotes via serial or BLE. The submitter provided a Python prototype that reads serial input and simulates a hotkey. To implement this in Mumble, one should study the referenced Zello and Aina API docs, and explore Mumble's existing input handling (likely in src/mumble/). The client uses Qt, so integrating serial port reading via QSerialPort or BLE via Qt Bluetooth would be needed. No linked PRs or assignees exist, so the approach is open for discussion.