What lands
Shows up like any
other banner.
Not a second app to watch. The notification your Mac already has a place for. Focusable, actionable, gone in one swipe. Calls on the left of your day, texts and one-time codes on the right of it.
Paired in one scan.
-
192.168.1.42 : 8765
01
Open it on the Mac
The app starts listening and shows its address as a QR code. Pick a network if there are two.
-
point · scan · done
02
Scan it with the phone
The address and the shared secret, if you set one, travel inside the code. No typing.
-
POST /call → 200 OK
test received from Pixel 8
03
Send a test, hear nothing
One POST should be all it takes. If the banner shows, you never open this app again.
The wire
The whole protocol
is this.
Any client that can POST JSON can stand in for the phone. curl
is a valid test device. One request, one notification. No session, no
second format, no ack beyond the status code.
$ curl -i http://192.168.1.42:8765/call \
-H 'Content-Type: application/json' \
-d '{"event":"ringing","number":"+15550148291",
"caller":"Alex","device":"Pixel 8"}'
HTTP/1.1 200 OK
{"ok":true}
Opt-in
Texts stay off
until you ask.
SMS forwarding is a switch, and it ships off. Leave it off and CallBridge never reads a message. Turn it on and a text that looks like a one-time code gets a Copy code action on the Mac. Detected on the phone, copied with one tap, never written to a log.
Deny contacts and the call still arrives. The name is simply missing.
Honesty
The limits, on purpose.
- Delivery
- One try. Four seconds. No queue, no retry. If the Mac is asleep, that ring is gone. That is what “no server” means.
- Network
- LAN-only. The phone refuses anything outside the private ranges. It will not send a notification through the internet, ever.
- Transport
- Plain HTTP, like the traffic between your printer and your Mac. Fine on a network you trust; the wrong tool for a café.
- Codebase
- ~3,000 lines you can read in an evening. The protocol fits on one page. There is nowhere to hide anything.
Two files. No installer.
CallBridge-macOS.zip
Unzip, drag to Applications. First launch asks for one approval (we don't pay Apple for notarization), then never again.
DownloadCallBridge-v0.4.1.apk
Sideload the APK (Android asks to allow installs from your browser once). Requires 8.0+, same Wi-Fi.
DownloadBoth apps update themselves after this · release notes · protocol · source