Skip to content
Torbjorn Tyridal edited this page Dec 5, 2021 · 5 revisions

I can't find the addon in the browser? How do I use it?

On Chrome and Chromium (Edge) based browsers, you will need to enable the addon before you can use it. see here how to find it. You will then get the three dotted icon in the address bar. This is where you access the extension, try it when visiting a login page.

Privacy mode

This addon is marked as respecting privacy mode. When used from a private window no username or site settings will be stored. (note that settings -> privacy -> "firefox will never remember history" makes all your browsing considered private)

Regardless, you will have to manually enable this addon for use in private / incognito browsing. see example for firefox or chrome. You'll find this in the extension / addon settings menu

Changing the site name

Many sites (like google) have localized url's (google.de, google.co.uk etc). It is recommended that you use the global (ie google.com) as the site name in such cases.

When you first open masterpassword on a localized domain, that domain will be suggested in masterpassword. You can change this. It will be remembered for your next visit.

If you have several accounts at a domain, it is suggested to prefix the site name with something like username@ (ie myself@google.com). The site name in masterpassword will change to a dropdown if you have multiple variants.

Login name auto fill

Masterpassword will auto fill your password if you've highlighted the password field when opening masterpassword.

Masterpassword can also auto fill your username. You must then position the cursor at the username field. In addition, to avoid accidental data leak, a couple of conditions must be met: The next input must be a password field. The two must be on the same form and the "name" attribute on the input must contain the string 'user', 'name', 'email' or 'login'. If the site you're using does don't adhere to these best practices, the auto fill will not happen.

Algorithm versions and compatibility

The MasterPassword algorithm has gone through several revisions as bugs and unfortunate design descisions have been discovered. This addon implements v3 of the algorithm. You should have no problem interoperating with other apps using the same version. Additionally you will get the same passwords for apps using the v2, as long as your master user name only contains ascii letters, numbers and symbols. In particular that means you should avoid non english/latin characters like æ,ø,å,ß,€ and similar in your name, if you need to mix v2 and v3.