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.
Pebble requires a configuration file describing the vault(s) to use. The
configuration file uses the INI
and is expected to be at
$XDG_CONFIG_HOME/pebble/config by default;
another location may be specified using the
A vault is described in the configuration file by a section like in the following example:
[default] host: host.example.com user: alice password: mypassword vault: MyVault
The file may contain several sections, one for each different vault.
-s option to specify the name of the section to use (and thus,
which vault to connect to). By default, a section named
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:
listto list credentials in the vault;
showto display a credential’s details;
newto add a new credential;
editto modify a credential;
deleteto remove a credential from the vault;
confto create or edit the configuration file;
refreshto forcefully refresh the local cache;
clearto empty the local cache.
In addition, calling
pbl without any subcommand will start an
interactive shell in which subcommands can be invoked successively
without quitting the program.
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.
Pebble include codes that was originally distributed under a 3-clause BSD license. The original copyright notice and license can be found in the header of any file of the source distribution containing such code.
The project is located at https://incenp.org/dvlpt/pebble.html with the manual at https://incenp.org/dvlpt/pebble/index.html. The source code is available in a Git repository at https://git.incenp.org/damien/pebble.
Download the latest release tarball:
Or install through PyPI:
pip install incenp.pebble