Command-line client for Nextcloud’s Passman.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Damien Goutte-Gattat 6e31780f28 Prepare 0.4.1 release. 1 year ago
docs Add a doc page on caching. 1 year ago
incenp Prepare 0.4.1 release. 1 year ago
.gitignore Prepare 0.3.0 release. 1 year ago
AUTHORS Update README file. 1 year ago
COPYING Initial commit. 2 years ago Prepare 0.2.0 release. 1 year ago
NEWS Prepare 0.4.1 release. 1 year ago Prepare 0.4.1 release. 1 year ago Start writing a proper documentation. 1 year ago

Pebble - Command-line Passman client

Pebble is a command-line client for the Passman password manager.

It supports read and write access to Passman vaults: it can list, show, create, modify or delete entries in a vault. It cannot, however, create or delete the vaults themselves.

Note that write support (creating, modifying, and deleting entries) should be considered experimental at this stage. Use it on your vaults at your own risks.


Pebble requires a configuration file describing the vault(s) to use. The configuration file uses the INI syntax and is expected to be at $XDG_CONFIG_HOME/pebble/config by default; another location may be specified using the -c option.

A vault is described in the configuration file by a section like in the following example:

user: alice
password: mypassword
vault: MyVault

The file may contain several sections, one for each different vault. Use the -s option to specify the name of the section to use (and thus, which vault to connect to). By default, a section named default will be used.

Inside a vault section, the password field may be omitted, in which case the password will be asked interactively. Note: This is the Nextcloud password, not the vault’s password! The vault password is always asked interactively.


With at least one vault configured, Pebble may then be used through the pbl command and its subcommands. Current available subcommands are:

  • list to list credentials in the vault;
  • show to display a credential’s details;
  • new to add a new credential;
  • edit to modify a credential;
  • del to remove a credential from the vault.

In addition, the shell command enters an interactive mode in which subcommands can be invoked successively without quiting the program.

Calling pbl with the -h option will display the general help; calling a given subcommand with the -h option will display the help for that subcommand.

The program will interactively for the vault passphrase when it is needed to decrypt or encrypt a credential.


Pebble is distributed under the terms of the GNU General Public License, version 3 or higher. The full license is included in the COPYING file of the source distribution.

Homepage and repository

The project is located at with the manual at The source code is available in a Git repository at