balasaravanakumar7890/dualbuds

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.