bwm.1

'\" t
.\" Automatically generated by Pandoc 3.1.6
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "Bitwarden-menu" "1" "2023-08-26" "Bitwarden-menu v0.4.2" "User Manual"
.hy
.SH NAME
.PP
bitwarden-menu - Fully featured Dmenu/Rofi/Bemenu frontend for autotype
and managing of Bitwarden/Vaultwarden vaults.
.SH SYNOPSIS
.PP
\f[B]bitwarden-menu\f[R] [\f[B]\[en]vault\f[R] URL]
[\f[B]\[en]login\f[R] email] [\f[B]\[en]lock\f[R]]
[\f[B]\[en]autotype\f[R] pattern] [**\[en]clipboard]
.SH DESCRIPTION
.PP
\f[B]Bitwarden-menu\f[R] is a fast and minimal application to facilitate
password entry and manage most aspects of Bitwarden/Vaultwarden vaults.
.SH OPTIONS
.PP
\f[B]-v\f[R], \f[B]\[en]vault\f[R] Vault URL
.PP
\f[B]-l\f[R], \f[B]\[en]login\f[R] Login email address
.PP
\f[B]-k\f[R], \f[B]\[en]lock\f[R] Lock vault
.PP
\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 vault.
.PP
\f[B]-C\f[R], \f[B]\[en]clipboard\f[R] Select to clipboard
.SH EXAMPLES
.IP
.nf
\f[C]
bwm
bwm -v https://vault.mydomain.net -l user\[at]domain.com -a \[aq]{TOTP}{ENTER}\[aq]
\f[R]
.fi
.SH CONFIGURATION
.PP
If you start bitwarden-menu for the first time without a config file, it
will prompt you for vault, login and 2FA type (if applicable) and save
them in a default config file.
.PP
OR Copy config.ini.example to \[ti]/.config/bwm/config.ini and use it as
a reference for additional options.
.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[V][dmenu]\f[R]
T}@T{
\f[V]dmenu_command\f[R]
T}@T{
\f[V]dmenu\f[R]
T}
T{
T}@T{
\f[V]pinentry\f[R]
T}@T{
None
T}
T{
\f[V][dmenu_passphrase]\f[R]
T}@T{
\f[V]obscure\f[R]
T}@T{
\f[V]False\f[R]
T}
T{
T}@T{
\f[V]obscure_color\f[R]
T}@T{
\f[V]#222222\f[R]
T}
T{
\f[V][vault]\f[R]
T}@T{
\f[V]server_n\f[R]
T}@T{
None
T}
T{
T}@T{
\f[V]login_n\f[R]
T}@T{
None
T}
T{
T}@T{
\f[V]twofactor_n\f[R]
T}@T{
None
T}
T{
T}@T{
\f[V]password_n\f[R]
T}@T{
None
T}
T{
T}@T{
\f[V]password_cmd_n\f[R]
T}@T{
None
T}
T{
T}@T{
\f[V]autotype_default_n\f[R]
T}@T{
None
T}
T{
T}@T{
\f[V]session_timeout_min\f[R]
T}@T{
\f[V]360\f[R]
T}
T{
T}@T{
\f[V]editor\f[R]
T}@T{
\f[V]vim\f[R]
T}
T{
T}@T{
\f[V]terminal\f[R]
T}@T{
\f[V]xterm\f[R]
T}
T{
T}@T{
\f[V]gui_editor\f[R]
T}@T{
None
T}
T{
T}@T{
\f[V]type_library\f[R]
T}@T{
\f[V]pynput\f[R]
T}
T{
T}@T{
\f[V]hide_folders\f[R]
T}@T{
None
T}
T{
T}@T{
\f[V]autotype_default\f[R]
T}@T{
\f[V]{USERNAME}{TAB}{PASSWORD}{ENTER}\f[R]
T}
T{
\f[V][password_chars]\f[R]
T}@T{
\f[V]lower\f[R]
T}@T{
\f[V]abcdefghijklmnopqrstuvwxyz\f[R]
T}
T{
T}@T{
\f[V]upper\f[R]
T}@T{
\f[V]ABCDEFGHIJKLMNOPQRSTUVWXYZ\f[R]
T}
T{
T}@T{
\f[V]digits\f[R]
T}@T{
\f[V]0123456789\f[R]
T}
T{
T}@T{
\f[V]punctuation\f[R]
T}@T{
\f[V]!\[dq]#$%%&\[aq]()*+,-./:;<=>?\[at][\[rs]]\[ha]_\[ga]{│}\[ti]\f[R]
T}
T{
T}@T{
\f[V]Custom Name(s)\f[R]
T}@T{
\f[V]Any string\f[R]
T}
T{
\f[V][password_char_presets]\f[R]
T}@T{
\f[V]Letters+Digits+Punctuation\f[R]
T}@T{
\f[V]upper lower digits punctuation\f[R]
T}
T{
T}@T{
\f[V]Letters+Digits\f[R]
T}@T{
\f[V]upper lower digits\f[R]
T}
T{
T}@T{
\f[V]Letters\f[R]
T}@T{
\f[V]upper lower\f[R]
T}
T{
T}@T{
\f[V]Digits\f[R]
T}@T{
\f[V]digits\f[R]
T}
T{
T}@T{
\f[V]Custom Name(s)\f[R]
T}@T{
\f[V]Any combo of [password_chars] entries\f[R]
T}
.TE
.SH FILES
.PP
\[ti]/.config/bwm/config.ini
.SH AUTHOR
.PP
Scott Hansen - <tech@firecat53.net>
.SH COPYRIGHT
.PP
MIT
.SH SEE ALSO
.PP
More information available at
https://github.com/firecat53/bitwarden-menu