PassBridge

iCloud Passwords in Chrome, with the autofill behavior of the Bitwarden extension. macOS and Windows. Not affiliated with Apple or Bitwarden.

🇨🇳 简体中文

PassBridge started as a fork of Open Passwords. It speaks Apple's native-messaging protocol (com.apple.passwordmanager) so the live vault stays in iCloud, and it takes field detection lists from Bitwarden's browser extension. How to pull a newer Bitwarden, au2001, or open-passwords commit is in UPSTREAMS.md.

Start here: SETUP.md for macOS and Windows. The built extension is attached to each release. Unzip it and load that folder unpacked.

Quick install (details and checks in SETUP.md):

1. Turn off Apple's own iCloud Passwords extension in Chrome. Both use the same extension id.
2. Download passbridge.zip from the latest release and unzip it.
3. Open chrome://extensions, turn on Developer mode, click Load unpacked and choose the unzipped folder.
4. Click the toolbar icon and type the 6-digit code that macOS or iCloud for Windows shows.
5. Optional helper: on macOS run sh native/install.sh from passbridge-macos-helper.zip; on Windows unzip passbridge-windows-helper.zip and double-click install.cmd.

What you get

• An inline menu on login fields, with an icon in the field, keyboard navigation, and a top-layer popover the page cannot cover.
• Ctrl/Cmd+Shift+L to fill and cycle matching logins. A toolbar badge with the count.
• A right-click menu to fill, copy a username, password, or verification code, or generate a password.
• A save / update bar that hands the password to Apple's own save sheet. Nothing is written without that sheet.
• Verification codes from the Passwords app, and links that open the entry in the Passwords app.

Updates

PassBridge checks for a new release every 30 minutes, and the Updates tab in Settings has a Check now button. Install the helper once and updates then install by themselves:

• macOS: sh native/install.sh, as in SETUP.md.
• Windows: install Python, unzip passbridge-windows-helper.zip from the latest release and double-click install.cmd, then fully quit and reopen Chrome.

Without the helper, each update asks you to pick the PassBridge folder, and on Windows Chrome asks "Save X.js?" for every file. See SETUP.md.

What stays Apple's

• The 6-digit pairing code once per browser launch, and Touch ID or Windows Hello when the vault asks.
• Matching a login to a site. The helper does that. There is no per-item "exact URL" rule.
• Passkeys. Chrome on macOS uses iCloud Keychain passkeys itself. On Windows, use your iPhone through the QR code in Chrome's passkey dialog. PassBridge stores and signs no passkeys unless you turn on the optional Windows passkey store in Options. See SETUP.md.
• No Linux, and no Chrome Web Store listing. The helper only accepts Apple's extension id, so this copy is loaded unpacked. See SETUP.md.

Credits

• ManiForoughi2/open-passwords (Apache-2.0), the client PassBridge started from.
• au2001/icloud-passwords-firefox (Apache-2.0), the protocol implementation in src/apple/.
• bitwarden/clients (GPL-3.0), the autofill field lists. Snapshot under vendor/bitwarden/. Nothing from bitwarden_license/ is included.
• Open Runde (SIL OFL 1.1), the interface font. The license text is in fonts/OFL.txt.

Contributors:

• Mahmuthan Elbir (@mahelbir): the "Fill and save on HTTP pages" setting (#33) and verification codes grouped under their logins in the popup (#34).

See NOTICE. License: GPL-3.0, see LICENSE.

"Apple", "iCloud", and "Passwords" are trademarks of Apple Inc. "Bitwarden" is a trademark of Bitwarden Inc.