Repository navigation
Releases
v1.3.0
Pair over Wi-Fi with one command
Android 11 and later can pair with no cable at all, but doing it by hand means two adb commands with two addresses. The pairing dialog and the Wireless debugging screen show different ports, and reusing the first one is the mistake nearly everyone makes.
pab pairYou type only the six digit code your phone shows. Wireless debugging advertises both ports over mDNS, so the command finds your phone, pairs, then looks up the port it has to connect on. Neither address is ever typed, so they cannot be mixed up.
When something does go wrong it says which of the usual causes fit, chosen by where it failed. Not finding a phone, a rejected code, and a refused connection have nothing in common, so it does not print one list for all three.
pab is on your PATH now
The docs have told people to run pab doctor for a while, and for anyone who installed with Homebrew it did not exist: the cask shipped the app and nothing else, leaving the script unreachable inside the bundle. The cask now declares it properly.
From the disk image there is no link, so it stays at:
/Applications/PixelAudioBridge.app/Contents/Resources/pabInstall
brew install --cask nicglazkov/tap/pixel-audio-bridgeSigned, notarized, and universal for Apple silicon and Intel.
v1.2.0
Installing this on someone else's Mac turned up three problems. This release is all three.
It now works on any Mac
The output device defaulted to the literal name AirPods Max, so a fresh install on any other machine matched nothing and refused to start with no output device matching 'AirPods Max' is connected.
Naming no device now means follow whatever your Mac is already playing through, which is correct everywhere and needs no configuration. Pick a specific device from the dropdown if you want it pinned.
AIRPODS_MATCH is now OUTPUT_MATCH. The old key is still read, so an existing config keeps its pinned device on upgrade.
It tells you what is missing
A missing dependency used to surface as a red adb not found with nowhere to go. The app now shows a setup screen naming what is missing, where the rest were found, and the exact command to install it, with a button to copy it and one to recheck.
It does not run that command for you. An app installing packages on your behalf is a bigger ask than this needs to make.
It can tell you about updates, if you let it
On first launch the app asks whether it may check for updates. Until you answer, and permanently if you decline, it contacts nothing at all. If you accept, it asks GitHub once a day whether a newer version exists, sending no identifier and no usage data.
The privacy policy has been rewritten to describe exactly this, because the previous version promised there were no update checks and that had to stay true or change honestly.
Install
brew install --cask nicglazkov/tap/pixel-audio-bridgeOr download PixelAudioBridge.dmg below. Signed, notarized, and universal for Apple silicon and Intel. You also need adb, and the app will now tell you if you do not have it.
v1.1.1
Packaging fix. The app itself is unchanged.
The v1.1.0 DMG was built before notarization returned, so the app inside it
carried no stapled ticket. Gatekeeper accepted it anyway by checking with Apple
over the network, which meant a first launch with no connection could be
blocked. The app and the DMG are both stapled now, so verification works
offline.
Install
brew install --cask nicglazkov/tap/pixel-audio-bridgeOr download PixelAudioBridge.dmg below and drag the app to Applications.
Signed with a Developer ID, notarized by Apple, and universal for Apple silicon
and Intel.
You also need adb, from the Android SDK platform-tools. The Homebrew route
installs scrcpy for you.
v1.1.0: notarized DMG and Homebrew cask
Superseded by v1.1.1. The app inside this DMG has no stapled notarization ticket, so a first launch with no network connection can be blocked. Use v1.1.1.
Install without build tools. Signed and notarized by Apple, so there is no
Gatekeeper warning and no right-click-to-open dance.
Install
brew install --cask nicglazkov/tap/pixel-audio-bridgeOr download PixelAudioBridge.dmg below and drag it to Applications. You will
also need scrcpy and adb; the Homebrew route installs scrcpy for you.
Fixed
The app is now universal. It was compiled arm64 only while the documentation
claimed Apple silicon and Intel, so it would not have run on an Intel Mac at all.
Both slices are now built and merged.
Verifying it yourself
spctl -a -vvv -t install /Applications/PixelAudioBridge.app
# accepted
# source=Notarized Developer IDFull notes in CHANGELOG.md.
v1.0.0: first release
First tagged release.
~191 ms end-to-end on USB. scrcpy plays the captured audio directly through
SDL. One process, one buffer, no intermediate player.
What's in it
- SwiftUI menu bar app with a window: status, transport, output and phone pickers
- Waiting state, which launches whatever is connected, starts on its own when the
headphones appear, returns to waiting when they leave - Output watchdog, which makes the chosen device the system default and stops
playback within ~0.5 s if that changes pabCLI underneath, usable standalone
Requirements
macOS 14+, scrcpy, adb, and an Android 11+ phone with USB debugging.
Build it yourself with ./build.sh. Nothing to notarize, no Gatekeeper prompt.