Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/au2001/icloud-passwords-firefox

Firefox extension which lets you use your passwords stored on iCloud Keychain®.
https://github.com/au2001/icloud-passwords-firefox

firefox firefox-addon firefox-extension icloud-keychain icloud-passwords keychain macos password-manager passwords webextension

Last synced: 11 days ago
JSON representation

Firefox extension which lets you use your passwords stored on iCloud Keychain®.

Host: GitHub
URL: https://github.com/au2001/icloud-passwords-firefox
Owner: au2001
License: apache-2.0
Created: 2023-10-22T11:34:46.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-07-10T23:36:43.000Z (4 months ago)
Last Synced: 2024-08-01T16:56:10.727Z (3 months ago)
Topics: firefox, firefox-addon, firefox-extension, icloud-keychain, icloud-passwords, keychain, macos, password-manager, passwords, webextension
Language: TypeScript
Homepage: https://addons.mozilla.org/en-US/firefox/addon/icloud-passwords/
Size: 347 KB
Stars: 86
Watchers: 8
Forks: 7
Open Issues: 26
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

        














iCloud Passwords for Firefox

















This Firefox extension lets you securely fill passwords from iCloud Keychain® when signing in to websites.\

It also provides you with strong passwords, one-time codes, and passkeys to secure your online accounts.\

Your passwords are automatically synchronized accross your Apple and other compatible devices.

## Installation

**➡️ Recommended:** Download this extension from [AMO (addons.mozilla.org)](https://addons.mozilla.org/en-US/firefox/addon/icloud-passwords/).

Alternatively, download the latest GitHub release and install it on Firefox by navigating to `about:addons`.

Refer to the following table to see if your configuration is supported:

| Platform                                                                                          | Version         | Status                                                                         |

| ------------------------------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------ |

| ![macOS](https://img.shields.io/badge/macos-white?style=for-the-badge&logo=apple&logoColor=black) | >= Sonoma (14)  | ✅ Fully supported                                                             |

| ![macOS](https://img.shields.io/badge/macos-white?style=for-the-badge&logo=apple&logoColor=black) | <= Ventura (13) | [❌ Unsupported](https://github.com/au2001/icloud-passwords-firefox/issues/33) |

| ![Windows](https://img.shields.io/badge/windows-blue?style=for-the-badge&logo=windows10)          | >= 7            | ⚠️ Requires additional setup (see below)                                       |

| ![Windows](https://img.shields.io/badge/windows-blue?style=for-the-badge&logo=windowsxp)          | <= Vista        | ❌ Unsupported                                                                 |

| ![Linux](https://img.shields.io/badge/linux-black?style=for-the-badge&logo=linux)                 | Any             | [❌ Unsupported](https://github.com/au2001/icloud-passwords-firefox/issues/34) |

### Additional setup

For some operating systems, additional steps are required for the extension to work:

1. Install [iCloud for Windows](https://support.apple.com/kb/DL1455).

2. Enable the `Passwords` option.

3. Click on `Install Extension...` for either Microsoft Edge or Google Chrome.

4. Download the `icloud_passwords_install` file from the [latest GitHub Release](https://github.com/au2001/icloud-passwords-firefox/releases/latest).

5. Run the downloaded executable **as administrator**.

6. Restart Firefox, and you should be good to go!

#### Why is this required?

macOS Sonoma (14) and later come with `PasswordManagerBrowserExtensionHelper.app` preinstalled.\

It's a utility which allows Apple's iCloud Passwords Chrome and Edge extensions to work.\

This extension uses the same utility, so it works natively without any further steps.

Unfortunately, this utility is not available on previous versions of macOS, on Windows, nor on Linux.\

For such operating systems, this utility needs to be replaced. iCloud for Windows serves this purpose.\

By default, iCloud for Windows does not grant access to Firefox to access passwords.\

The provided executable thus enables the communication between Firefox and iCloud for Windows.

The source code for the Golang executable is available [in the `scripts/install` directory](https://github.com/au2001/icloud-passwords-firefox/tree/main/scripts/install/main.go).

## Need Help?

- [Report a bug](https://github.com/au2001/icloud-passwords-firefox/issues/new)

- [Request a new feature](https://github.com/au2001/icloud-passwords-firefox/issues/new)

- [Reach out](https://aurelien.garnier.dev/contact#contact)

## Features

| Feature                            | Status                                                             |

| ---------------------------------- | ------------------------------------------------------------------ |

| List accounts for current website  | ✅                                                                 |

| Select an account to auto-fill     | ✅                                                                 |

| Copy account password to clipboard | ✅                                                                 |

| Generate new secure passwords      | ✅                                                                 |

| In-page auto-complete suggestions  | ✅                                                                 |

| Search through existing accounts   | [⛅️](https://github.com/au2001/icloud-passwords-firefox/issues/5) |

| Auto-fill one-time codes           | [❌](https://github.com/au2001/icloud-passwords-firefox/issues/8)  |

| Copy one-time codes to clipboard   | [❌](https://github.com/au2001/icloud-passwords-firefox/issues/8)  |

| Register one-time codes            | [❌](https://github.com/au2001/icloud-passwords-firefox/issues/8)  |

| Save newly created accounts        | [❌](https://github.com/au2001/icloud-passwords-firefox/issues/12) |

| Login with a passkey               | [❌](https://github.com/au2001/icloud-passwords-firefox/issues/9)  |

| Create new passkeys                | [❌](https://github.com/au2001/icloud-passwords-firefox/issues/9)  |

| Create new accounts manually       | [❌](https://github.com/au2001/icloud-passwords-firefox/issues/7)  |

| Delete existing accounts           | ❌                                                                 |

The full list of planned features and known bugs is available under [Issues](https://github.com/au2001/icloud-passwords-firefox/issues).

## Contributing

Contributions are welcome, whether that be code, documentation, testing, feature ideas, or bug reporting.

🤝 If you are willing to contribute to tackle a specific GitHub Issue, please add a comment stating your intentions.\

👾 To submit code patches, please open a [GitHub Pull Request](https://github.com/au2001/icloud-passwords-firefox/compare).\

📕 If you are not sure where to start, take a look at open [GitHub Issues](https://github.com/au2001/icloud-passwords-firefox/issues).

Thanks for your interest!

### Development

To build and run the extension locally when developing, you should follow these instructions:

1. Clone this repository.

2. Open the folder in your favorite IDE.

3. Run `npm ci` to install the required Node dependencies.

4. Run `npm build:watch` to start building the code after each file change.

5. Navigate to `about:debugging#/runtime/this-firefox` and click on `Load Temporary Add-on...`.

6. Find where you cloned this repository, and select the `manifest.json` file in the `dist` folder (NOT in `meta`).

7. Click on `Inspect` to access the console which displays errors, warnings, and debug logs.

8. All user interface components refresh live when you save files in your IDE.

9. Background scripts do NOT refresh live, you need to click `Reload` under `Temporary Extensions`.

10. The AMO version will be restored after closing Firefox, or when clicking `Remove`.

## License

This extension is licensed under the [Apache License 2.0](https://github.com/au2001/icloud-passwords-firefox/blob/main/LICENSE).

**⚠️ All forks of this repository should explicitly state their changes in a clear manner within the README.**