The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
App-Raps2-0.50
River stage zero No dependents
/ raps2

NAME

raps2 - "Right, Another Password Store" take two

SYNOPSIS

raps2 action args ...

VERSION

This manual documents raps2 version 0.50

DESCRIPTION

raps2 is a simple password safe. You give it a name, a password and optional metadata, and it will encrypt and store them for you. You probably want to start with raps2 add accountname, and then later use raps2 get accountname and paste the corresponding password into whatever application requires it. raps2 will automatically initialize its store when used for the first time.

Supported metadata are "URL", "Login" and the multiline "Extra" field. URL and Login will be saved as plaintext, Extra is encrypted like the password.

ACTIONS

add account

Adds account to the store. It will ask you for the store's master password, some metadata and the new password and then store them.

del account

Remove account from the store.

dump account

Dump everything saved for account, including the clear-text password, to stdout.

edit account

Edit saved data for account. Note that editing the multiline "extra" field is not yet possible.

get account

Decrypt account's password and store it in the primary X Clipboard. Note that it can only be pasted once. Prints the content of the multiline extra field (if present) to stdout.

info account

Show information about account, does not require the master password.

list

List all saved accounts with their respective Logins and URLs

version

Show version information

OPTIONS

None.

EXIT STATUS

zero on success, non-zero otherwise.

CONFIGURATION

raps2 saves the master password hash in ~/.config/raps2/password.

Additional encrypted passwords are stored in ~/.local/share/raps2/.

These directories can be changed by setting the XDG_CONFIG_HOME and XDG_DATA_HOME environment variables.

DEPENDENCIES

  • Crypt::CBC

  • Crypt::Eksblowfish

  • File::BaseDir

  • File::Path (usually included with perl core)

  • File::Slurp

  • xclip (for raps2 get)

BUGS AND LIMITATIONS

This is alpha software, the store format may change without further notice. Backwards-compatibility is not guaranteed.

AUTHOR

Copyright (C) 2011 by Daniel Friesel <derf@finalrewind.org>

LICENSE

  0. You just DO WHAT THE FUCK YOU WANT TO.