keepmenu.1

'\" t
.\" Automatically generated by Pandoc 3.1.11.1
.\"
.TH "Keepmenu" "1" "05 July 2024" "Keepmenu 1.4.2" "User Manual"
.SH NAME
keepmenu \- Fully featured Dmenu/Rofi frontend for autotype and managing
of Keepass databases.
.SH SYNOPSIS
\f[B]keepmenu\f[R] [\f[B]\[en]autotype\f[R] pattern]
[\f[B]\[en]config\f[R] file] [\f[B]\[en]clipboard\f[R]]
[\f[B]\[en]database\f[R] file] [\f[B]\[en]keyfile\f[R] file]
[\f[B]\[en]totp\f[R]]
.SH DESCRIPTION
\f[B]Keepmenu\f[R] is a fast and minimal application to facilitate
password entry and manage most aspects of Keepass .kdbx databases.
It is inspired in part by Passhole, but is more dmenu and less command
line focused.
.SH OPTIONS
\f[B]\-a\f[R], \f[B]\[en]autotype\f[R] Autotype sequence from
https://keepass.info/help/base/autotype.html#autoseq .
Overrides global default from config.ini for current database.
.PP
\f[B]\-c\f[R], \f[B]\[en]config\f[R] Path to config file
.PP
\f[B]\-C\f[R], \f[B]\[en]clipboard\f[R] Select to clipboard
.PP
\f[B]\-d\f[R], \f[B]\[en]database\f[R] Path to Keepass database
.PP
\f[B]\-k\f[R], \f[B]\[en]keyfile\f[R] Path to keyfile
.PP
\f[B]\-t\f[R], \f[B]\[en]totp\f[R] TOTP mode
.SH EXAMPLES
.IP
.EX
keepmenu
keepmenu \-t
keepmenu \-c /etc/keepmenu/config.ini
keepmenu \-d \[ti]/docs/totp_passwords.kdbx \-a \[aq]{TOTP}{ENTER}\[aq]
keepmenu \-d \[ti]/passwords.kdbx \-k \[ti]/passwords.keyfile \-a \[aq]{S:security question}{ENTER}\[aq]
.EE
.SH CONFIGURATION
If you start keepmenu for the first time without a config file, it will
prompt you for database and keyfile locations and save them in a default
config file.
.PP
OR Copy config.ini.example to \[ti]/.config/keepmenu/config.ini and use
it as a reference for additional options.
.PP
Alternatively you can specify the file path to your config.ini using the
\-c/\[en]config flag.
.SS config.ini options and defaults
.PP
.TS
tab(@);
lw(19.3n) lw(21.4n) lw(29.3n).
T{
Section
T}@T{
Key
T}@T{
Default
T}
_
T{
\f[CR][dmenu]\f[R]
T}@T{
\f[CR]dmenu_command\f[R]
T}@T{
\f[CR]dmenu\f[R]
T}
T{
T}@T{
\f[CR]pinentry\f[R]
T}@T{
None
T}
T{
T}@T{
\f[CR]title_path\f[R]
T}@T{
\f[CR]True\f[R]
T}
T{
\f[CR][dmenu_passphrase]\f[R]
T}@T{
\f[CR]obscure\f[R]
T}@T{
\f[CR]False\f[R]
T}
T{
T}@T{
\f[CR]obscure_color\f[R]
T}@T{
\f[CR]#222222\f[R]
T}
T{
\f[CR][database]\f[R]
T}@T{
\f[CR]database_n\f[R]
T}@T{
None
T}
T{
T}@T{
\f[CR]keyfile_n\f[R]
T}@T{
None
T}
T{
T}@T{
\f[CR]password_n\f[R]
T}@T{
None
T}
T{
T}@T{
\f[CR]password_cmd_n\f[R]
T}@T{
None
T}
T{
T}@T{
\f[CR]autotype_default_n\f[R]
T}@T{
None
T}
T{
T}@T{
\f[CR]pw_cache_period_min\f[R]
T}@T{
\f[CR]360\f[R]
T}
T{
T}@T{
\f[CR]editor\f[R]
T}@T{
\f[CR]vim\f[R]
T}
T{
T}@T{
\f[CR]terminal\f[R]
T}@T{
\f[CR]xterm\f[R]
T}
T{
T}@T{
\f[CR]gui_editor\f[R]
T}@T{
None
T}
T{
T}@T{
\f[CR]type_library\f[R]
T}@T{
\f[CR]pynput\f[R]
T}
T{
T}@T{
\f[CR]hide_groups\f[R]
T}@T{
None
T}
T{
T}@T{
\f[CR]autotype_default\f[R]
T}@T{
\f[CR]{USERNAME}{TAB}{PASSWORD}{ENTER}\f[R]
T}
T{
T}@T{
\f[CR]type_url\f[R]
T}@T{
\f[CR]False\f[R]
T}
T{
\f[CR][password_chars]\f[R]
T}@T{
\f[CR]lower\f[R]
T}@T{
\f[CR]abcdefghijklmnopqrstuvwxyz\f[R]
T}
T{
T}@T{
\f[CR]upper\f[R]
T}@T{
\f[CR]ABCDEFGHIJKLMNOPQRSTUVWXYZ\f[R]
T}
T{
T}@T{
\f[CR]digits\f[R]
T}@T{
\f[CR]0123456789\f[R]
T}
T{
T}@T{
\f[CR]punctuation\f[R]
T}@T{
\f[CR]!\[dq]#$%%&\[aq]()*+,\-./:;<=>?\[at][\[rs]]\[ha]_\[ga]{│}\[ti]\f[R]
T}
T{
T}@T{
\f[CR]Custom Name(s)\f[R]
T}@T{
\f[CR]Any string\f[R]
T}
T{
\f[CR][password_char_presets]\f[R]
T}@T{
\f[CR]Letters+Digits+Punctuation\f[R]
T}@T{
\f[CR]upper lower digits punctuation\f[R]
T}
T{
T}@T{
\f[CR]Letters+Digits\f[R]
T}@T{
\f[CR]upper lower digits\f[R]
T}
T{
T}@T{
\f[CR]Letters\f[R]
T}@T{
\f[CR]upper lower\f[R]
T}
T{
T}@T{
\f[CR]Digits\f[R]
T}@T{
\f[CR]digits\f[R]
T}
T{
T}@T{
\f[CR]Custom Name(s)\f[R]
T}@T{
\f[CR]Any combo of [password_chars] entries\f[R]
T}
.TE
.SH FILES
\[ti]/.config/keepmenu/config.ini
.SH AUTHOR
Scott Hansen \- \c
.MT tech@firecat53.net
.ME \c
.SH COPYRIGHT
GNU General Public License 3
.SH SEE ALSO
Full documentation available at https://github.com/firecat53/keepmenu