Keepmenu(1)

💖 keepmenu(1) — User Manual 💖

okay so bestie, this is the keepmenu(1) User Manual, and we’re gonna make it make sense. it’s giving terminal-girlie excellence, lowkey iconic, and honestly very “password manager but make it cute.” 🫶

✨ NAME ✨

keepmenu — a fully featured Dmenu/Rofi frontend for autotype and for managing Keepass databases. it’s giving “password entry and database management, but make it fast and pretty.” 💅

🌸 SYNOPSIS 🌸

keepmenu [–autotype pattern] [–config file] [–clipboard] [–database
file] [–keyfile file] [–no-prompt] [–totp]

🦋 DESCRIPTION 🦋

okay so Keepmenu is a fast and minimal application that makes password entry and managing most aspects of Keepass .kdbx databases way easier. it’s inspired in part by Passhole, but it’s more dmenu-coded and less command-line-focused. no cap. ✨

🎀 OPTIONS 🎀

here’s the whole flag family, bestie — every single one, no skips:

• -a, –autotype — Autotype sequence from https://keepass.info/help/base/autotype.html#autoseq. Overrides the global default from config.ini for the current database.
• -c, –config — Path to config file
• -C, –clipboard — Select to clipboard
• -d, –database — Path to Keepass database
• -k, –keyfile — Path to keyfile
• -n, –no-prompt — Do not prompt for database password
• -s, –show — Search term(s)
• -t, –totp — TOTP mode

🌈 EXAMPLES 🌈

these are the little command-line moments, copied exactly because yes:

keepmenu
keepmenu -t
keepmenu -c /etc/keepmenu/config.ini
keepmenu -d ~/docs/totp_passwords.kdbx -a '{TOTP}{ENTER}'
keepmenu -d ~/passwords.kdbx -k ~/passwords.keyfile -a '{S:security question}{ENTER}'
keepmenu -s "production/ssh db" -d ~/passwords.kdbx

💜 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. periodt. 💖

OR copy config.ini.example to ~/.config/keepmenu/config.ini and use it as a reference for additional options.

Alternatively you can specify the file path to your config.ini using the -c/–config flag.

💾 config.ini options and defaults 💾

The whole config.ini table is Section / Key / Default, and every single row is below — no skips, bestie:

• [dmenu]
  • dmenu_command — default dmenu
  • pinentry — default None
  • title_path — default True
• [dmenu_passphrase]
  • obscure — default False
  • obscure_color — default #222222
• [database]
  • database_n — default None
  • keyfile_n — default None
  • password_n — default None
  • password_cmd_n — default None
  • autotype_default_n — default None
  • pw_cache_period_min — default 360
  • editor — default vim
  • terminal — default xterm
  • gui_editor — default None
  • type_library — default pynput
  • hide_groups — default None
  • autotype_default — default {USERNAME}{TAB}{PASSWORD}{ENTER}
  • type_url — default False
• [password_chars]
  • lower — default abcdefghijklmnopqrstuvwxyz
  • upper — default ABCDEFGHIJKLMNOPQRSTUVWXYZ
  • digits — default 0123456789
  • punctuation — default:

!"#$%%&'()*+,-./:;<=>?@[\]^_`{│}~

• Custom Name(s) — default Any string

• [password_char_presets]
  • Letters+Digits+Punctuation — default upper lower digits punctuation
  • Letters+Digits — default upper lower digits
  • Letters — default upper lower
  • Digits — default digits
  • Custom Name(s) — default Any combo of [password_chars] entries

🍓 FILES 🍓

• ~/.config/keepmenu/config.ini

👑 AUTHOR 👑

Scott Hansen — tech@firecat53.net

🌟 COPYRIGHT 🌟

GNU General Public License 3

🧚 SEE ALSO 🧚

Full documentation available at https://github.com/firecat53/keepmenu

---

xoxo, your favorite Unix girlie 💅 — this slay little page is from Keepmenu 1.4.2, dated 05 July 2024. bye bestie, go slay those passwords! 🫶