You need to have Pebble installed with the
program available from the command line.
You also need an account on a Nextcloud instance with the Passman application installed, and at least one Passman vault created.
Creating a configuration file¶
Pebble requires a configuration file describing the vault(s) to use and
cannot function properly without one. By default, Pebble will look for a
config under the directory
A simple configuration file may look like the following:
[default] host: cloud.example.org user: alice password: XXXXXX vault: MyVault
cloud.example.org is the Nextcloud or Owncloud server,
alice is the username of an account on that server,
corresponding password, and
MyVault the name of a Passman’s vault.
Listing, searching and viewing credentials¶
list command to print the labels for all credentials
stored in the vault:
$ pbl list example.com social.example.org bank.example
Called with one or more parameters, the command will only print credentials whose label matches one of the specified pattern(s):
$ pbl list bank bank.example
-i option to also print the credential’s unique identifier.
This identifier will be needed to edit or delete the credential.
$ pbl list -i 29:example.com 30:social.example.org 31:bank.example
To print the actual contents of a credential, use the
The command will either print all available credentials (if called
without any argument), all the credentials matching the specified
pattern(s), or the one credential with the unique identifier specified
You will be asked for the vault’s passphrase to decrypt the encrypted fields.
$ pbl show bank Passphrase for vault MyVault on firstname.lastname@example.org: +---- bank.example (31) ----- | URL: https://bank.example/ | Email: email@example.com | Password: 123456 +----
Adding, editing, and deleting credentials¶
new command to create a new credential and add it to the
vault. The command will fire your favorite editor (as specified in the
$EDITOR environment variable) in which you will be able to set the
contents of the credentials to add. Once you are done, save your
modifications and quit the editor.
To edit an existing credential, use the
edit command with a single
argument representing the unique identifier of the credential to edit
(as displayed by
list -i). Again, your editor will be started and
loaded with a textual representation of the credential for you to edit.
The modified credential is sent to the server when you quit the editor
after saving your modifications.
When you are in the editor, if you wish to cancel adding a new credential or modifying an existing credential, simply quit the editor without saving anything.
To delete a credential, use the
del command with a single argument
representing the unique identifier of the credential to delete.