broo
broo copied to clipboard
Connect your phone as microphone wirelessly. Supports both PipeWire and PulseAudio.
Broo
- Connect your phone as microphone wirelessly.
- Get clear voice and low latency with minimal CPU overhead.
- Just run one command (
$ broo) to quickly set-up the mic and start talking with peers. - Supports both modern PipeWire and legacy PulseAudio.
- For PulseAudio use case, restores backed-up ALSA settings stored in
~/.config/asound.state, if it exists.
Reason for such a name
- Sanskrit धातु (lexical word stem) " ब्रू " (brU) which means "to speak".
- You go like "BROOOOOOOOO that was NICE" while vibing with your homies.
Requirements
- A GNU/Linux distro with either PipeWire or PulseAudio.
- A smartphone (or anything with a mic which can connect to a local Mumble server).
- For Android → Mumla app (F-Droid) [Source]
- For iOS → Official Mumble app (App Store) [Source, unmaintained]
For distros with the apt package manager.
- The setup script will do the heavy lifting for you. Please proceed to the installation.
Otherwise
Install the following:
mumblemurmurormumble-serveravahioravahi-daemoniproute2
If you want, you may build Mumble and its server directly from the source to get improved PipeWire support, performance, and bug fixes. Compilation doesn't take much time and completes under a few minutes. Though, you may want to build a package instead of directly going the sudo make install route.
Installation
$ git clone https://github.com/siddhpant/broo.git
$ cd broo
$ chmod +x broo setup_broo
$ ./setup_broo
Then follow the on-screen instructions.
Run
$ broo
Do you want to start Broo, or close it? (s/c):
- Press
sto start Broo, orcto stop it. - Use the mic by choosing
Monitor of Brooas your input source / mic in applications. - The script will reside in
~/.local/bin, so you can run Broo from anywhere. - You can use
-hor--helpfor help.
Audiophile?
Then you can eliminate the WiFi latency by connecting your phone to your computer with a wire.
Use USB tethering to share your smartphone's active internet connection with your computer. When Broo creates a local server, due to direct connection with the phone the WiFi latency will be bypassed, and you can observe Mumla showing 0ms latency before connecting.
This will reduce the total audio latency by a significant percentage. For example, you might reduce the latency by 15ms, but the gain can be more or less since it depends on your connection.
The network latency to the web servers of services such as Teams, Google Meet, Discord, etc. is usually higher, so in the grand scheme of things, this optimisation might not matter for the average user.
Further, this may come in handy when your WiFi adapter / card / driver is borked.
Miscellaneous
If you see that your PC's user isn't in the channel when you join from your mobile, then restart Broo and press p on the starting prompt of Broo. After following the on-screen steps, run Broo normally.
If the problem still persists, it would be nice to go through the setup again.
You can also force close broo with q and force start with f.
Credits
Inspired by the implementation of https://github.com/pzmarzly/mic_over_mumble/.
I have tried to hopefully iron out some problems with the original implementation by making the script from scratch to streamline the code, and added absolutely necessary features such as supporting PipeWire, adding prompt and ability to close the terminal, ALSA setting restore, etc.