balasaravanakumar7890/dualbuds — explained in plain English
Analysis updated 2026-05-18
Play music or a video out of two Bluetooth headsets simultaneously.
Share audio between two people using their own earbuds on the same Linux machine.
Learn how PipeWire combined sinks can route audio to multiple outputs.
Add dual Bluetooth audio support to an Arch Linux desktop setup.
| balasaravanakumar7890/dualbuds | 123satyajeet123/bitnet-server | ahloiscreamo/pod-search | |
|---|---|---|---|
| Stars | 0 | 0 | 0 |
| Language | Shell | Shell | Shell |
| Setup difficulty | easy | easy | easy |
| Complexity | 2/5 | 2/5 | 2/5 |
| Audience | ops devops | developer | general |
Figures from each repo's GitHub metadata at analysis time.
Requires PipeWire and WirePlumber already working, most common on modern Arch Linux.
Dualbuds solves a specific annoyance on Linux: normally your computer can only send audio to one output device at a time, so if you own two sets of Bluetooth earbuds and want them both playing the same song, there is no built in way to do that. This project is a single shell script that fixes that. It works by using PipeWire, the modern Linux audio system, along with its PulseAudio compatible tools called pactl and wpctl. When you run the script, it looks for exactly two connected Bluetooth audio devices, then creates a temporary virtual audio destination called a combined sink. Every app currently playing sound, whether that is Firefox, Spotify, VLC, or Chrome, gets automatically redirected to this virtual sink, which then duplicates the sound out to both Bluetooth devices at once, unmuting them in the process. Setup is a short copy and paste job: you create a script file in your home folder, paste in the provided code, make it runnable, and optionally add a short alias so you can just type dualbuds from any terminal. From there, using it is three steps: connect two Bluetooth devices, start playing something, and run the dualbuds command. The README notes it should work with almost any pairing of Bluetooth earbuds or headphones, for example AirPods paired with a Sony headset, without needing to change the script for different hardware. It also includes a troubleshooting section for the two most likely problems, only one earbud playing audio or no sound at all, both solved by checking connected devices or restarting PipeWire services. This is a small, focused utility rather than a full application. It is aimed at Linux users, most likely on Arch Linux, who already have PipeWire and Bluetooth working. Planned future improvements include automatically enabling dual audio when two devices connect, and eventually a graphical interface. The project is released under the MIT license.
A Linux shell script that lets you play the same audio out of two Bluetooth earbuds or headphones at the same time.
Mainly Shell. The stack also includes Shell, PipeWire, WirePlumber.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly ops devops.
This repo across BitVibe Labs
double-check against the repo, no cap.