https://github.com/leafac/org-password-manager.git
git clone 'git://github.com/leafac/org-password-manager.git'
org-password-manager is a minimal password manager for Emacs Org mode.
org-password-manager is available in MELPA and
can be installed using M-x package-install
.
Password generation depends on pwgen and it should be installed if you want to use this feature.
If you want to use the default keybindings described below on the Usage section, add the following line to your Emacs configuration:
(add-hook 'org-mode-hook 'org-password-manager-key-bindings)
If you want some other keybindings, refer to the body of the function
org-password-manager-key-bindings
for an example on how to do it.
Follow the example:
* [[http://example.com][My favorite website]]
:PROPERTIES:
:USERNAME: leandro
:PASSWORD: chunky-tempeh
:END:
* SSH key
:PROPERTIES:
:PASSWORD: tofu
:END:
Type C-c C-p u
(org-password-manager-get-username
) and search for the title
of the entry containing the USERNAME
property (e.g. “My favorite
website”). Then it's going to be copied to your clipboard.
If the point is at an entry that contains the USERNAME
property, it's copied
without querying you for the heading. If you still want to be queried (because
you want the username for a different entry) use the C-u
argument typing C-u
C-c C-p u
.
Type C-c C-p u
(org-password-manager-get-password
) and search for the title
of the entry containing the PASSWORD
property (e.g. “My favorite
website”). Then it's going to be copied to your clipboard. It tries to increase
the security by skipping the kill ring and copying the password directly to the
system's clipboard and by erasing it after 30 seconds (this period is
customizable, refer to the Configuration section).
If the point is at an entry that contains the PASSWORD
property, it's copied
without querying you for the heading. If you still want to be queried (because
you want the password for a different entry) use the C-u
argument typing C-u
C-c C-p u
.
Type C-c C-p g
(org-password-manager-generate-password
) and the generated
password will be inserted under the point on the buffer. It's also copied to
your clipboard. It tries to increase the security by skipping the kill ring and
copying the password directly to the system's clipboard and by erasing it after
30 seconds (this period is customizable, refer to the
Configuration section).
If you want to customize the pwgen
command before running it (e.g. you want a
shorter password), use the C-u
argument by typing C-u C-c C-p g
.
Refer to M-x customize-group org-password-manager
.
This work was first inspired by Emacs and Org mode, obviously.
But I also want to cite two other projects that are similar in spirit to org-password-manager. They aim to accomplish the same goal - i.e. using Emacs Org mode as a password manager. Though they differ on design from each other and from org-password-manager. Thus, the effort to create org-password-manager is still justified.
Those related projects are both called org-passwords. One was created by Jorge Alfaro-Murillo and the other by Andrea Crotti.
Jorge Alfaro-Murillo's org-passwords has lots of features, way more than org-password-manager plans to have. For example, it implements its own password generator, requires configuration for pointing to a password file that should only contain passwords and opens that file in read-only mode with a timeout. It's so complete that it's in the official distribution of Org mode under org-contrib.
org-password-manager, on the other hand, uses pwgen to generate passwords, handles passwords stored on the middle of any Org mode file with other contents and doesn't open those files in any special way.
Andrea Crotti's org-passwords is more minimal than org-password-manager aims to be. It only retrieves passwords for the entry under the point, generates passwords by calling pwgen and has almost no documentation, requiring the user to read the source.
I appreciate the mentioned works and thank its authors.