2017-03-21 18:05:18 -04:00
[](https://ci.appveyor.com/project/bitwarden/browser)
2017-05-20 17:23:46 -04:00
[](https://crowdin.com/project/bitwarden-browser)
2016-10-13 22:03:11 -04:00
[](https://gitter.im/bitwarden/Lobby)
2016-09-11 00:22:18 -04:00
# bitwarden Browser Extension
2017-03-29 20:35:26 -04:00
< a href = "https://chrome.google.com/webstore/detail/bitwarden-free-password-m/nngceckbapebfimnlniiiahkandclblb" target = "_blank" > < img src = "https://imgur.com/3C4iKO0.png" width = "64" height = "64" > < / a >
< a href = "https://addons.mozilla.org/firefox/addon/bitwarden-password-manager/" target = "_blank" > < img src = "http://imgur.com/JXP9jir.png" width = "64" height = "64" > < / a >
< a href = "#" target = "_blank" > < img src = "https://imgur.com/RlmwPGO.png" width = "64" height = "64" > < / a >
< a href = "https://addons.opera.com/extensions/details/bitwarden-free-password-manager/" target = "_blank" > < img src = "http://imgur.com/nSJ9htU.png" width = "64" height = "64" > < / a >
< a href = "https://chrome.google.com/webstore/detail/bitwarden-free-password-m/nngceckbapebfimnlniiiahkandclblb" target = "_blank" > < img src = "https://imgur.com/j8qsZ5q.png" width = "64" height = "64" > < / a >
< a href = "https://brave.com/" target = "_blank" > < img src = "https://imgur.com/bWzsEN8.png" width = "64" height = "64" > < / a >
2017-03-31 23:51:34 -04:00
< a href = "https://addons.mozilla.org/firefox/addon/bitwarden-password-manager/" target = "_blank" > < img src = "https://imgur.com/uhb8M86.png" width = "64" height = "64" > < / a >
2016-09-11 00:22:18 -04:00
2016-10-09 22:50:58 -04:00
The bitwarden browser extension is written using the Chrome Web Extension API and AngularJS.
2016-09-11 00:22:18 -04:00
2016-11-09 21:24:38 -05:00
2016-10-21 13:42:46 +02:00
2016-12-24 00:13:36 -05:00
# Build/Run
**Requirements**
2016-12-28 23:53:58 -05:00
- [Node.js ](https://nodejs.org/en/ )
- [Gulp ](http://gulpjs.com/ ) (`npm install --global gulp-cli` )
2016-12-24 00:13:36 -05:00
- Chrome (preferred), Opera, or Firefox browser
2016-12-28 23:53:58 -05:00
By default the extension is targeting the production API. If you are running the [Core ](https://github.com/bitwarden/core ) API locally,
you'll need to switch the extension to target your local API. Open `src/services/apiService.js` and set `this.baseUrl` to your local
API instance (ex. `http://localhost:4000` ).
2016-12-24 00:13:36 -05:00
Then run the following commands:
2017-01-04 00:17:49 -05:00
- `npm install`
2016-12-24 00:13:36 -05:00
- `gulp build`
You can now load the extension into your browser through the browser's extension tools page:
- Chrome/Opera:
1. Type `chrome://extensions` in your address bar to bring up the extensions page.
2. Enable developer mode (checkbox)
3. Click the "Load unpacked extension" button, navigate to the `src` folder of your local extension instance, and click "Ok".
- Firefox
1. Type `about:debugging` in your address bar to bring up the add-ons page.
2. Click the `Load Temporary Add-on` button, navigate to the `src/manifest.json` file, and "Open".
2016-09-11 00:22:18 -04:00
# Contribute
2016-11-25 23:16:24 -05:00
Code contributions are welcome! Please commit any pull requests against the `master` branch. Learn more about how to contribute
by reading the [`CONTRIBUTING.md` ](CONTRIBUTING.md ) file.
2016-09-11 00:22:18 -04:00
2017-05-19 13:27:57 -04:00
Security audits and feedback are welcome. Please open an issue or email us privately if the report is sensitive in nature. You can read our security policy in the [`SECURITY.md` ](SECURITY.md ) file.
