WOFI-PASS(1)

💖 WOFI-PASS 💖

okay bestie, so you know pass, right? the classic little password-store situation? and you know wofi, the launcher that's lowkey iconic? well this is the manual page for wofi-pass — from the General Commands Manual section, manual page wofi-pass(1) — and it's literally just pass support for wofi. that's the whole vibe. no cap. 🎀

---

✨ NAME ✨

wofi-pass — pass support for wofi 🦋

---

🌸 SYNOPSIS 🌸

wofi-pass [OPTIONS...]

---

💅 OPTIONS 💅

• -a, --autotype — Autotype whatever entry is chosen. like, it picks it and types it for you. main character behaviour fr fr 🔥
• -c, --copy [cmd] — Copy to clipboard. If you don't hand it a cmd, it defaults to wl-copy. 🫶
• -f, --fileisuser — Use the name of the password file as the username. yes, the filename. as the user. that's the whole flag, slay.
• -h, --help — Show the help message. classic. everybody's favourite. 👑
• -i, --insensitive — Search for password in a case-insensitive way. so GITHUB and github are the same search, no drama. 🌈
• -s, --squash — Don't show field choice if password file only contains password. if there's literally nothing else to choose from, it doesn't make you choose. respectful. ✨
• -t, --type [cmd] — Type the selection instead of copying to clipboard. Defaults to wtype if no cmd is given. (copying? never heard of her.) 💅
• -k, --nohotkeys — Disable the hotkeys support for wofi-pass. The hotkeys feature is by default enabled. wofi supports the required custom keys feature from version v1.4. If you are using an older wofi version or a wofi alternative that does not have custom keys support at all, the hotkey feature can be disabled to avoid errors.

---

🧚 CONFIGURATION FILE 🧚

One way to customize the wofi-pass behavior is to change the configuration file. wofi-pass does not require a configuration file, but searches the following paths for a valid configuration file at every startup:

• ${WOFI_PASS_CONFIG}
• ${XDG_CONFIG_HOME}/wofi-pass/config
• /etc/wofi-pass.conf

wofi-pass only reads the first configuration file it finds. The order of searching is the same as in the list above. (so like, top of the list wins, she's not reading all three, she's not doing that much.) 🙈

If the environment variable ${XDG_CONFIG_HOME} is not set, it is replaced by the default value ${HOME}/.config.

---

🌟 CONFIGURATION VARIABLES 🌟

The following variables can be redefined in configuration file. 👇

💜 COMMON

• PASSWORD_STORE_DIR — Path to the pass storage files. Default: ${HOME}/.password-store

💜 COMMANDS

• CMD_COPY — Command to redirect the output to the clipboard. Default: wl-copy
• CMD_TYPE — Command to type the output. Default: wcopy -

💜 PASS FIELDS

• PASS_FIELD_USERNAME — pass field to be used as username for autotype. Default: username

💜 HOTKEYS

okay so each of these is a hotkey definition for direct selection of something, and the key codes live in wofi-keys(7) — go read that if you need the codes, bestie. 💖

• HOTKEY_USERNAME — Hotkey definition for direct selection of the username field. See wofi-keys(7) for the key codes. Default hotkey is Alt-u.
• HOTKEY_PASSWORD — Hotkey definition for direct selection of the password field. See wofi-keys(7) for the key codes. Default hotkey is Alt-p.
• HOTKEY_AUTOTYPE — Hotkey definition for direct selection of the autotype field. See wofi-keys(7) for the key codes. Default hotkey is Alt-a.
• HOTKEY_OTP — Hotkey definition for direct selection of the OTP field. See wofi-keys(7) for the key codes. Default hotkey is Alt-o.

---

🍓 PASSWORD FILES 🍓

wofi-pass assumes password files are formatted like the following:

Th3Gr3at3stPassw0rd
username: JohnDoe
email: john@example.com
otpauth://totp/example?secret=ABCDCBABCDCBABCD
pin: 1234

Note that the password is ALWAYS on the first line. like, always always. don't fight it. 😭

---

🔥 AUTOTYPE 🔥

The function autotype activates a formatted output of a pass entry.

The autotype function can be activated in 3 different ways:

1. by setting the option -a the selected entry will be output formatted
2. selecting the field autotype or press HOTKEY_AUTOTYPE hotkey will output the entry formatted
3. adding the field autotype_always to the pass entry, this entry will always be output formatted.

🌸 AUTOTYPE FORMAT 🌸

The format of the autotype is by default is as follows:

username :tab pass

and is defined by WOFI_PASS_AUTOTYPE. The autotype format string consists of a combination of keywords and pass fields separated by a space. The keywords are the follows:

• :tab — Type the Tab-key if type mode active else output \t.
• :space — Type the Space-key if type mode active else output " ".
• :enter — Type the Enter-key if type mode active else output \n.
• :delay — Delay the output for a specified time. The time is defined by WOFI_PASS_DELAY in seconds, where the default value is 2 seconds. Is only executed when type mode is active.
• :otp — Output the One Time Password
• :password — Output the password
• :username — Output the username field, defined by PASS_FIELD_USERNAME
• :path — Output the filename of selected :pass entry

All other entries are interpreted as pass fields and output the contents of the respective field.

---

and that's the whole page, bestie!! 🫶 this was WOFI-PASS(1) from January 2026, and yes we're all obsessed with her. go forth and store your passwords like the icon you are 💖✨🎀