Skip to content

Releases

v1.3.0

Choose a tag to compare

@nicglazkov nicglazkov released this 04 Aug 23:11
f5d23df

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 pair

You 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/pab

Install

brew install --cask nicglazkov/tap/pixel-audio-bridge

Signed, notarized, and universal for Apple silicon and Intel.

v1.2.0

Choose a tag to compare

@nicglazkov nicglazkov released this 03 Aug 03:26
d4b4bec

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-bridge

Or 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

Choose a tag to compare

@nicglazkov nicglazkov released this 02 Aug 06:50
060c1f5

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-bridge

Or 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

Choose a tag to compare

@nicglazkov nicglazkov released this 02 Aug 06:33
6606c0f

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-bridge

Or 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 ID

Full notes in CHANGELOG.md.

v1.0.0: first release

Choose a tag to compare

@nicglazkov nicglazkov released this 01 Aug 20:19
fd1dd08

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
  • pab CLI 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.