Skip to content

Latest commit

 

History

History
77 lines (33 loc) · 5.95 KB

README.md

File metadata and controls

77 lines (33 loc) · 5.95 KB

Add URL To Window Title

This add-on is designed to add information about the current web page to the browser window's title. The add-on was initially designed to facilitate usage of the KeePass's auto-type feature on logon forms, but can likely be used with other password managers or for other purposes where another application needs to monitor the details about the current page opened in a browser (e.g., web development debugging and pen testing).

Features

In its most basic usage, this add-on will add the full URL of the current web page running in the active tab of a given browser window. Optionally, the user can configure the addon to only add the hostname. There is also an option which will monitor for when an input or password field is selected and will then add the id and name attributes, in addition to the full URL or hostname, to the window title. This is to provide further granularity for auto-type rules, and is useful for many reasons, such as:

Why did I create this extension?

I am an avid user of KeePass for managing my passwords at various website. In order to simplify using my credentials from KeePass, I usually try to use KeePass's auto-type feature. Auto-type depends upon the window's title. For most websites, the title is unique enough to create a matching rule in KeePass. However, some websites simply set the title "Sign In" or similar. In addition, many sites now use two-page or two-step sign-ins, but may not change or update the page's title, further complicating the usage of auto-type.

While there are plugins that can integrate KeePass more directly with the browser, from a security standpoint I prefer auto-type because it keeps the browser and KeePass separate. Using a browser plugin to read directly from KeePass may allow browser flaws to be used to compromise KeePass. I also find auto-type to be easier to configure and more portable.

Using this extension directly from source

No external libraries are used for this extension and all code is vanilla JavaScript.

To load a local version, follow the docs to load local extension

As a regular user, you can install the Chrome Webstore version if you use Chrome, Edge, Vivaldi, or similar Chromium based browser. This extension also works in Firefox and can be installed from the Firefox Add-Ons Directory.

Running the tests

To test that the extension is properly updating the window title value (i.e., the <title /> field), we use Katalon Recorder to run simulated navigation scenarios and check that values are updated as we expect. To learn more about how to run the tests and how to create your own, visit the README in the katalon-recorder tests folder. (2024 Note: These test have not been updated, many of the test pages have changed in the past few years. I am currently doing some small tests, but most functionality has not changed in the core of the extension.)

We are exploring migration to selenium web driver and CI via Travis. If you have some experience with this type of testing and would like to help, please open an issue to discuss.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

We are actively looking for contributors to create translations. You can generate a pull request with a new locale and translate messages.json from the "en" locale. You can learn more about the internationalization process for chrome extensions in the chrome.i18n documentation.

Help and Documentation

Please visit the wiki on GitHub for documentation.

If you encounter issues or have general questions about functionality, please open an issue on GitHub.

Some documentation may reflect an older version of this extension. We are making efforts to update as needed and record new videos. Should you see a major problem, broken link, please open an issue and we will work to remediate.

Donate and Support

Please rate and leave feedback on the Chrome Webstore, Firefox Add-Ons Directory, star it on GitHub, share with your friends, blog about it, etc.

If you find this extension useful and it saved you some time, please help support development by donating $2.22 USD:

No money? Feel free to send a thank you note, drawing, etc. You can also support the continued development of this extension by helping with translations and reporting any issues or problems.

Versioning

We use SemVer for versioning.

License

This project is licensed under the GPLv3 License - see the LICENSE.txt file for details.