Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/suBDavis/Tusk
🐘 🔒 KeePass-compatible browser extension for filling passwords.
https://github.com/suBDavis/Tusk
chrome-extension firefox-addon javascript keepass keeweb password-manager vue
Last synced: 3 months ago
JSON representation
🐘 🔒 KeePass-compatible browser extension for filling passwords.
- Host: GitHub
- URL: https://github.com/suBDavis/Tusk
- Owner: subdavis
- License: other
- Created: 2017-01-03T19:13:49.000Z (almost 8 years ago)
- Default Branch: develop
- Last Pushed: 2024-08-02T19:50:14.000Z (3 months ago)
- Last Synced: 2024-08-02T22:43:49.278Z (3 months ago)
- Topics: chrome-extension, firefox-addon, javascript, keepass, keeweb, password-manager, vue
- Language: JavaScript
- Homepage: https://subdavis.com/Tusk
- Size: 14.7 MB
- Stars: 469
- Watchers: 14
- Forks: 72
- Open Issues: 77
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- chrome-extensions - KeePass Tusk - KeePass-compatible browser extension for filling passwords. (General)
README
# Tusk
> A modern, clean keepass browser extension built with Vue.js and kdbxweb. Rebooted from perfectapi/CKP
## Back in business
[Read the blog post](https://medium.com/@brandon.a.davis/keepass-tusk-is-back-from-the-dead-a367697212fd) and stay tuned for more updates.
## Installation
**Firefox:** https://addons.mozilla.org/en-GB/firefox/addon/keepass-tusk/
**Chrome:** https://chrome.google.com/webstore/detail/fmhmiaejopepamlcjkncpgpdjichnecm
## User Guide
This section provides how-to instructions for various features of Tusk.
* [WebDAV Support](https://github.com/subdavis/Tusk/wiki/WebDAV-Support) - Support for WebDAV file servers.
* [Custom Fields](https://github.com/subdavis/Tusk/wiki/Custom-Fields) - list of custom fields that Tusk supports.
* [Warnings and Errors](https://github.com/subdavis/Tusk/wiki/Warnings-and-Errors) - An explanation of the messages you may encounter.
#### How it works: Implementation Details
This section provides in-depth information about how tusk works under the hood. We aim to provide better transparency and give users peace-of-mind. Tusk may not be perfect, but it's better than proprietary black-box applications that hide design flaws from the community.
* [Credential Cache Memory](https://github.com/subdavis/Tusk/wiki/Credential-Cache-Memory) - How Tusk can optionally keep your master password cached.
* [Sensitive Data](https://github.com/subdavis/Tusk/wiki/Sensitive-Data) - How Tusk handles sensitive data like KeePass databases and keyfiles.
## Build Setup
Tusk requires:
* `node`
* `npm`
* `yarn`
```bash
# install dependencies
yarn install
# build static DLL resources (optional)
yarn build-dll
# build for production with minification
yarn build
# run the packer script targeted for 'chrome' and 'firefox' after build.
# this step generates the zip archives submitted to Chrome/Firefox addon marketplaces.
yarn bundle
# static reload with file watch for tests
yarn dev-tests
```
For detailed explanation on how things work, consult the [docs for vue-loader](http://vuejs.github.io/vue-loader).
## Running tests
To run tests, first build them with `yarn build-tests` or `yarn watch-tests` then open `tests/test.html` in a browser.
## Browser Permissions
> Tusk requires cross-origin permissions in order to inject credentials and query the storage backends on the user's behalf.
In chrome, these permissions requests are __always__ prompted to the user upon first use.
Because of Firefox's implementation of `browser.permissions`, it was necessary to request all permissions at install time to avoid code rot. A deeper explanation of the firefox permissions can be found [on stackoverflow](https://stackoverflow.com/questions/47723297/firefox-extension-api-permissions-request-may-only-be-called-from-a-user-input)
## FAQ
> Why is it called Tusk?!
I originally wanted to call it *Elephant*, as in *An elephant never forgets.* I tried this name on a couple of friends and they were unimpressed. I wanted to find a name that was more concise but keep the elephant imagery. Ergo, tusk.
> What happened to CKPX?
This is it! CKPX has been rebranded as Tusk to mark its Firefox release. The C in CKPX stood for 'Chrome'.
> Can I donate money?
I don't want your money. Take whatever you would have given me and find a local charity -- a food bank, a women's shelter or an animal shelter, for example. Enjoy your free software.
> So how can I support Tusk?
If you ❤️ Tusk, please consider leaving a positive review on [the Firefox Add-on store](https://addons.mozilla.org/en-GB/firefox/addon/keepass-tusk/) or [the Chrome webstore](https://chrome.google.com/webstore/detail/fmhmiaejopepamlcjkncpgpdjichnecm) - I'll be eternally grateful.
> Who made that awesome logo?
A super cool artist and graphic designer named [Gabriel Garcia](https://github.com/ggabogarcia)! Thanks for our logo!