🌏 Buttercup browser extension
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Buttercup for Browsers

Buttercup Browser Extension

Buttercup credentials manager extension for the browser.

Buttercup Build Status Chrome users Firefox users Join the community on Spectrum


This browser extension allows users to interface with password archives authored by the Buttercup password manager (though it does not require the application to be installed).

The extension can remotely connect to archives via Buttercup's common communication protocols (WebDAV, Dropbox etc.).

This extension uses Locust to perform login form detection. Issues relating to the detection and operation of login forms should be opened there.

Supported browsers

Chrome, Firefox and Opera are supported.

Other browsers will be supported in order of request/popularity. Issues created for unsupported browsers, or for browsers not on the roadmap, may be closed without warning.

Supported platforms

The browsers listed above, running on Windows, Mac or Linux on a desktop platform. This extension is not supported on any mobile or tablet devices.


The browser extension can be controlled from the popup menu, which is launched by pressing the Buttercup button in the browser menu. This menu displays a list of archives as well as settings and other items.

When viewing pages that contain login forms, Buttercup can assist logging in when you interact with the login buttons (displayed beside detected login inputs).

Buttercup can also remember new logins, which are detected as they occur.

You can block Buttercup from detecting forms and inputs by applying the attribute data-bcupignore=true:

<input type="email" data-bcupignore="true" />


Development of features and bugfixes is supported in the following environment:

  • NodeJS version 8 (latest minor version)
  • Linux / Mac
  • Tested in at least Chrome / Firefox / Opera

To set up your development environment:

  • Clone this repo
  • Execute npm install inside the project directory
  • Execute npm run dev to build and watch the project
  • Add the ./dist directory to the browser of your choice as an unpacked extension

Adding to Chrome

You can load an unpacked extension in Chrome by navigating to chrome://extensions/. Simply locate the project's directory and use dist/ as the extension directory.

Adding to Firefox

You can load an unpacked extension in Firefox by navigating to about:debugging. Click "Load Temporary Add-on" and locate the project's directory, using dist/ as the extension directory.