1YAPET(1)                             YAPET                            YAPET(1)
2
3
4

NAME

6       yapet - text based password manager
7

SYNOPSIS

9       yapet [[-c] | [-h] | [-V] [[-i] | [-r rcfile]] [[-s] | [-S]] [-t sec]]
10       [filename] v == DESCRIPTION
11
12       yapet provides a text user interface for storing passwords and
13       associated information (referred to as password records) in files
14       encrypted on disk. A password record is comprised of a record name,
15       host name, user name, password, and comment. A master password is
16       required to encrypt/decrypt the password records in a given file. yapet
17       does not impose a limit of password records per file.
18
19       Files created by yapet always have the suffix .pet. Also, if a file is
20       loaded using the command line, yapet appends the suffix .pet to the
21       filename unless the filename includes this suffix already. By default,
22       yapet refuses to load files not having a file mode of 0600. This
23       behavior can be changed by providing the -s option when starting yapet
24       or using a configuration file (see yapet_config(5), and OPTIONS).
25
26       After loading a file, the record name of each password record is
27       displayed in a list. Existing password records can be opened by
28       selecting them and pressing Enter. By default, existing password
29       records are opened in read-only mode to avoid accidental changes.
30       Pressing Ctrl+r toggles between read-only and edit mode.
31
32       On terminals supporting colors, the password is hidden if the password
33       record dialog is in read-only mode. The password can be made visible,
34       by either going to edit mode (Ctrl+r), or by pressing Ctrl+t.
35
36       yapet relies on OpenSSL for encryption and decryption of password
37       records. Starting with YAPET 2.0 the cipher used is AES-256. YAPET 2.0
38       will read and write pre YAPET 2.0 files. Pre YAPET 2.0 files are
39       converted to YAPET 2.0 files when changing the master password. Once
40       converted, the files can no longer be read by pre YAPET 2.0 versions.
41
42       Other features of yapet are:
43
44       •   Screen lock after a certain amount of inactivity when password file
45           is loaded (see also yapet_config(5) and OPTIONS).
46
47       •   Password records opened in read-only mode (default) hide the
48           password. Toggling into edit mode reveals the password (see
49           Password Record Dialog Keys).
50
51       •   Import of CSV files (see csv2yapet(1)).
52
53       •   Export of YAPET files to CSV files (see yapet2csv(1)).
54
55       •   Integrated password generator.
56
57   Main Window Function Keys
58       Following function keys are recognized in the main window:
59
60       h
61           Show an overview of the function keys.
62
63       Enter
64           Open the currently selected password record.
65
66       s
67           Save changes to currently loaded file.
68
69       r
70           Open a file.
71
72       e
73           Create a new, empty file.
74
75       l
76           Lock the screen immediately. Takes only effect if a file is loaded.
77
78       a
79           Add a new password record.
80
81       d
82           Delete the currently selected password record.
83
84       o
85           Change the sort order of the password record list.
86
87       /
88           Search for a password record. The search is only performed on the
89           Name of the password record. Other password record fields won’t be
90           searched.
91
92       n
93           Search for the next occurrence of a previous search initiated by /.
94
95       c
96           Change the master password of the currently loaded yapet file.
97
98       i
99           Show various information about yapet and the loaded file, if any.
100
101       Ctrl+l
102           Redraw the entire screen.
103
104       g
105           Open the password generator.
106
107       q
108           Quit yapet.
109
110   Cursor Movement Keys
111       Cursor movement, whether in clear text or password fields, is
112       accomplished by using the following keys:
113
114       Left,Ctrl+b
115           Moves the cursor one character to the left.
116
117       Right, Ctrl+f
118           Moves the cursor one character to the right.
119
120       Home, Ctrl+a
121           Moves the cursor to the beginning of the input field.
122
123       End, Ctrl+e
124           Moves the cursor to the end of the input field.
125
126       Backspace
127           Delete the character left of the cursor.
128
129       Delete, Ctrl+d
130           Delete the character under the cursor.
131
132       Ctrl+k
133           Delete all characters under and right of the cursor.
134
135       Ctrl+u
136           Delete all characters left of the cursor.
137
138       Enter, Tab
139           Focus the next widget.
140
141       Shift+Tab
142           Focus the previous widget.
143
144   Password Record Dialog Keys
145       Following function keys are recognized in the password record dialog,
146       besides cursor movement keys (see Cursor Movement Keys):
147
148       Ctrl+r
149           Toggle the password record dialog between read-only and edit mode.
150           In read-only mode, yapet hides the password (only supported on
151           color terminals).
152
153       Ctrl+t
154           Toggle between hiding and showing the password, without setting the
155           password record dialog to edit mode (only supported on color
156           terminals). Has no effect if the password record dialog is in edit
157           mode.
158

OPTIONS

160       The following options are supported:
161
162       -c
163           Show copyright information.
164
165       -h
166           Print help text.
167
168       -i
169           Do not read the configuration file.
170
171       -r rcfile
172           Read the configuration file specified by rcfile. If this option is
173           not given, the default configuration file read is $HOME/.yapet
174           unless -i is specified.
175
176       -s
177           Disable the check for the owner and file mode when loading files.
178           Without this option, yapet checks password files for having the
179           same owner as the user running yapet and verifies that the file
180           mode is strictly 0600. If one of these conditions are not met,
181           yapet refuses to load the file.
182           Providing this options disables those checks and yapet will load
183           files with owners other than the process owner of yapet and file
184           modes different from 0600. New files saved while this option is
185           active will have the file mode set according to umask(2).
186
187       -S
188           Enable the check for the owner and file mode when loading files.
189           This option makes yapet to load password files having the owner set
190           to the process owner of yapet and the file mode strictly set to
191           0600 only. If one of these conditions are not met, yapet refuses to
192           load the file.
193           New files saved while this option is active will have the file mode
194           set to 0600. This is the default mode.
195
196       -t sec
197           Set the timeout until the screen is locked to sec seconds. The
198           minimum time allowed is 10 seconds. If a smaller value is provided,
199           the timeout will be set to 10 seconds.
200
201           Default: 10 min.
202
203       -V
204           Show version of yapet.
205
206       filename
207           The file to open upon invocation of yapet. If the file does not
208           exist, yapet asks whether it should be created. Files created by
209           yapet always have the suffix .pet.
210

FILES

212       $HOME/.yapet
213           The per-user configuration file. If existing, options are read from
214           this file but can be overridden by the command line options.
215           Processing of this file can be disabled by invoking yapet with the
216           -i option. Refer to the yapet_config(5) for an explanation of the
217           per-user configuration file.
218

ENVIRONMENT

220       LC_MESSAGES
221           Displaying messages in the specified language. Currently only
222           German is supported besides English.
223

BUGS

225       Please report bugs to https://github.com/RafaelOstertag/yapet/issues.
226

AUTHORS

228       Rafael Ostertag rafi@guengel.ch.
229

SEE ALSO

231       yapet_config(5), yapet_colors(5), yapet2csv(1), csv2yapet(1)
232
233
234
235YAPET 2.6                         2022-03-12                          YAPET(1)
Impressum