Amado app icon

Amado

One tap, or just walk away.
Lock on demand from your Apple devices, or automatically when you leave.

brew install --cask PangMo5/tap/amado

Version 0.1.1 ยท macOS 15, iOS 18, watchOS 11 ยท Free & open source

โŒš๏ธWatchOne tap
relay
๐Ÿ“ฑiPhoneAuthenticates
LAN ยท HTTPS
๐Ÿ’ปMacLocked

One tap when you want it. Automatic when you leave.

One tap, everywhere

Lock the moment you ask.

The same paired Macs are available across the iPhone app, Home Screen, Control Center, and Apple Watch.

๐Ÿ“ฑ

iPhone app

Pair by scanning the QR code on your Mac, then lock any saved Mac with one tap.

โŒš๏ธ

Apple Watch

Send the lock action from your wrist through the paired iPhone.

โ—‰

Widget and Control

Put a Mac on the Home Screen or add Lock Mac directly to Control Center.

No tap required

Walk away. Your Mac closes up.

Bluetooth proximity is a primary Amado experience: the Mac watches for your iPhone to leave and locks without a button press.

๐Ÿšถ

No phone app needed

Proximity sensing runs on the Mac. The Amado iPhone app does not need to remain open.

๐Ÿ“ถ

Tunable for your room

Choose the RSSI threshold, grace period, and smoothing that fit your desk and environment.

โ˜๏ธ

Stable identity

Use the same iCloud account on Mac and iPhone so macOS can recognize the phone across Bluetooth address rotation.

Local first

Fast nearby. Reachable away.

Bonjour finds the Mac automatically on your LAN. Off-network, Amado can use an HTTPS tunnel you choose and operate.

โšก๏ธ

Direct on LAN

No cloud hop, account, or hosted Amado service. A valid command goes straight to the Mac agent.

๐ŸŒ

Bring your own tunnel

Use Cloudflare Tunnel, Tailscale Funnel, ngrok, or another HTTPS tunnel with a stable hostname.

โ†ฉ๏ธ

Clear fallback

The client tries LAN first, then remote. With neither available it reports the failure instead of silently queuing.

A narrow, authenticated capability

It can lock. It cannot unlock.

QR pairing provisions a 256-bit secret. Every command carries an HMAC, fresh timestamp, and one-time nonce.

๐Ÿ”‘

Keychain on Mac

The pairing secret is kept out of config.toml and stored in the macOS Keychain.

๐Ÿ›ก๏ธ

Replay resistant

HMAC-SHA256 authenticates commands. Timestamp and nonce checks reject stale or duplicated requests.

๐Ÿ 

Loopback remote listener

The tunnel-facing HTTP server binds only to 127.0.0.1, not directly to the LAN.

Get Amado.

One tap when you want it. Automatic when you leave.

brew install --cask PangMo5/tap/amado