yapet [[-c] | [-h] | [-V] [[-i] | [-r rcfile]] [[-s] | [-S]] [-t sec]] [filename] v == DESCRIPTION
yapet provides a text user interface for storing passwords and associated information (referred to as
password records) in files encrypted on disk. A password record is comprised of a record name, host name,
user name, password, and comment. A master password is required to encrypt/decrypt the password records
in a given file. yapet does not impose a limit of password records per file.
Files created by yapet always have the suffix .pet. Also, if a file is loaded using the command line,
yapet appends the suffix .pet to the filename unless the filename includes this suffix already. By
default, yapet refuses to load files not having a file mode of 0600. This behavior can be changed by
providing the -s option when starting yapet or using a configuration file (see yapet_config(5), and
OPTIONS).
After loading a file, the record name of each password record is displayed in a list. Existing password
records can be opened by selecting them and pressing Enter. By default, existing password records are
opened in read-only mode to avoid accidental changes. Pressing Ctrl+r toggles between read-only and edit
mode.
On terminals supporting colors, the password is hidden if the password record dialog is in read-only
mode. The password can be made visible, by either going to edit mode (Ctrl+r), or by pressing Ctrl+t.
yapet relies on OpenSSL for encryption and decryption of password records. Starting with YAPET 2.0 the
cipher used is AES-256. YAPET 2.0 will read and write pre YAPET 2.0 files. Pre YAPET 2.0 files are
converted to YAPET 2.0 files when changing the master password. Once converted, the files can no longer
be read by pre YAPET 2.0 versions.
Other features of yapet are:
• Screen lock after a certain amount of inactivity when password file is loaded (see also
yapet_config(5) and OPTIONS).
• Password records opened in read-only mode (default) hide the password. Toggling into edit mode
reveals the password (see Password Record Dialog Keys).
• Import of CSV files (see csv2yapet(1)).
• Export of YAPET files to CSV files (see yapet2csv(1)).
• Integrated password generator.
MainWindowFunctionKeys
Following function keys are recognized in the main window:
h
Show an overview of the function keys.
Enter
Open the currently selected password record.
s
Save changes to currently loaded file.
r
Open a file.
e
Create a new, empty file.
l
Lock the screen immediately. Takes only effect if a file is loaded.
a
Add a new password record.
d
Delete the currently selected password record.
o
Change the sort order of the password record list.
/
Search for a password record. The search is only performed on the Name of the password record. Other
password record fields won’t be searched.
n
Search for the next occurrence of a previous search initiated by /.
c
Change the master password of the currently loaded yapet file.
i
Show various information about yapet and the loaded file, if any.
Ctrl+l
Redraw the entire screen.
g
Open the password generator.
q
Quit yapet.
CursorMovementKeys
Cursor movement, whether in clear text or password fields, is accomplished by using the following keys:
Left,Ctrl+b
Moves the cursor one character to the left.
Right, Ctrl+f
Moves the cursor one character to the right.
Home, Ctrl+a
Moves the cursor to the beginning of the input field.
End, Ctrl+e
Moves the cursor to the end of the input field.
Backspace
Delete the character left of the cursor.
Delete, Ctrl+d
Delete the character under the cursor.
Ctrl+k
Delete all characters under and right of the cursor.
Ctrl+u
Delete all characters left of the cursor.
Enter, Tab
Focus the next widget.
Shift+Tab
Focus the previous widget.
PasswordRecordDialogKeys
Following function keys are recognized in the password record dialog, besides cursor movement keys (see
Cursor Movement Keys):
Ctrl+r
Toggle the password record dialog between read-only and edit mode. In read-only mode, yapet hides the
password (only supported on color terminals).
Ctrl+t
Toggle between hiding and showing the password, without setting the password record dialog to edit
mode (only supported on color terminals). Has no effect if the password record dialog is in edit
mode.