1YAPET(1) YAPET YAPET(1)
2
6 yapet - text based password manager
7
9 yapet [[-c] | [-h] | [-V] [[-i] | [-r rcfile]] [[-s] | [-S]] [-t sec]]
10 [filename] v == DESCRIPTION
11 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 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 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 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 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 Other features of yapet are:
43 • Screen lock after a certain amount of inactivity when password file
45 is loaded (see also yapet_config(5) and OPTIONS).
46 • 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 • Import of CSV files (see csv2yapet(1)).
52 • Export of YAPET files to CSV files (see yapet2csv(1)).
54 • Integrated password generator.
56 Main Window Function Keys
58 Following function keys are recognized in the main window:
59 h
61 Show an overview of the function keys.
62 Enter
64 Open the currently selected password record.
65 s
67 Save changes to currently loaded file.
68 r
70 Open a file.
71 e
73 Create a new, empty file.
74 l
76 Lock the screen immediately. Takes only effect if a file is loaded.
77 a
79 Add a new password record.
80 d
82 Delete the currently selected password record.
83 o
85 Change the sort order of the password record list.
86 /
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 n
93 Search for the next occurrence of a previous search initiated by /.
94 c
96 Change the master password of the currently loaded yapet file.
97 i
99 Show various information about yapet and the loaded file, if any.
100 Ctrl+l
102 Redraw the entire screen.
103 g
105 Open the password generator.
106 q
108 Quit yapet.
109 Cursor Movement Keys
111 Cursor movement, whether in clear text or password fields, is
112 accomplished by using the following keys:
113 Left,Ctrl+b
115 Moves the cursor one character to the left.
116 Right, Ctrl+f
118 Moves the cursor one character to the right.
119 Home, Ctrl+a
121 Moves the cursor to the beginning of the input field.
122 End, Ctrl+e
124 Moves the cursor to the end of the input field.
125 Backspace
127 Delete the character left of the cursor.
128 Delete, Ctrl+d
130 Delete the character under the cursor.
131 Ctrl+k
133 Delete all characters under and right of the cursor.
134 Ctrl+u
136 Delete all characters left of the cursor.
137 Enter, Tab
139 Focus the next widget.
140 Shift+Tab
142 Focus the previous widget.
143 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 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 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
160 The following options are supported:
161 -c
163 Show copyright information.
164 -h
166 Print help text.
167 -i
169 Do not read the configuration file.
170 -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 -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 -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 -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 Default: 10 min.
202 -V
204 Show version of yapet.
205 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
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
220 LC_MESSAGES
221 Displaying messages in the specified language. Currently only
222 German is supported besides English.
223
225 Please report bugs to https://github.com/RafaelOstertag/yapet/issues.
226
228 Rafael Ostertag rafi@guengel.ch.
229
231 yapet_config(5), yapet_colors(5), yapet2csv(1), csv2yapet(1)
232YAPET 2.6 2022-03-12 YAPET(1)