DEFAULT BEHAVIOR

If a pass backend is not specified, tessen tries to find either one of pass(1) or gopass(1) in the order mentioned here.

tessen assumes that the data organization format is the same as mentioned on the home page of password store, when using pass(1) and gopass(1)

https://www.passwordstore.org/#organization

The first line should always have the password, and nothing else. All other lines may have key-value pairs like 'key1: value1' or an otpauth:// format URI. If non-unique keys are found, the first non-unique key will be considered and others will be ignored. If a key called 'password' is present, it will also be ignored. The 'autotype', 'url', 'username', and 'password' keys are considered case-insensitive. Note that tessen does NOT support parsing YAML files when using gopass(1).

If a dmenu backend is not specified, tessen tries to find either one of fuzzel(1), tofi(1), bemenu(1), yofi, wofi(1), rofi(1) or dmenu in the order mentioned here. If rofi is used, it is expected that the wayland native fork of rofi (https://github.com/lbonn/rofi) is being used. The original rofi (https://github.com/davatorium/rofi) implementation made for X.Org is NOT supported.

If an action is not specified, tessen shows an additional menu with the option to either autotype or copy data.

If data is copied, it will be removed from the clipboard after PASSWORD_STORE_CLIP_TIME when using pass(1) and after cliptimeout when using gopass(1). If PASSWORD_STORE_CLIP_TIME is not set, a default value of 15 seconds is assumed.

A delay of 100 milliseconds will be used between successive autotype operations. This can be changed using the 'delay' option in the tessen(5) configuration file.

tessen will look for a configuration file in the following locations

• $XDG_CONFIG_HOME/tessen/config
• $HOME/.config/tessen/config
• $XDG_CONFIG_DIRS/tessen/config
• /etc/xdg/tessen/config

A custom location can be specified using the -c flag.

Command line flags have the highest preference and supersede equivalent options set in the config file.

DEPENDENCIES

tessen depends on

• bash(1)
• at least one wayland native dmenu backend - fuzzel(1), tofi(1), bemenu(1), wofi(1), rofi(1), dmenu
• at least one pass backend - either pass(1) or gopass(1)
• wtype(1) (if you want to autotype data)
• wl-clipboard(1) (if you want to copy and paste data)
• scdoc(1) (optional, to build this man page)
• libnotify (optional, to use notify-send(1) for showing notifications about copied data and the timeout for clearing the clipboard)
• pass-otp(1) (optional, to generate HOTP/TOTP when using pass(1))
• xdg-utils (optional, if you want to use xdg-open(1) to open URLs)

ADDITIONAL FEATURES

If a key called 'user' is present inside a password file, its value will be the default username instead of the basename of the selected file. This key can be modified using the 'userkey' variable in the tessen(5) configuration file.

If a key called 'url' is present, an option to open the value of the 'url' key in the default web browser will be shown instead of auto type. This becomes the default behavior if -a autotype option is provided during the execution of tessen. The 'url' key can be modified using the 'urlkey' variable in the tessen(5) config file.

The otpauth:// format is supported and used if pass-otp(1) is installed when using pass(1). gopass(1) supports this feature natively.

A value for the 'autotype' key can be specified in password files for custom autotype behavior which overrides the default behavior of autotyping the username and the password. For example,

$ pass example/john
mypassword
key1: value1
key2: value2
key3: value3
key4: value4
otpauth://totp/ACME%20Co:john@example.com?secret=HXDMVJECJJWSRB3HWIZR4IF...
autotype: key1 :tab key2 :space key3 :enter key4 :delay :tab :otp pass

When specified as a value of the 'autotype' key,

• :tab can be used to type the Tab key
• :space can be used to type the Space key
• :enter can be used to type the Enter key
• :delay can be used to delay the type operation by 1 second
• :otp can be used to generate and type the OTP, if otpauth:// is present
• user, or the value of user in the config file, can be used to type the username
• pass or password can be used to type the password
• path, basename, or filename can be used to type the name of the selected file
• any other key, such as 'key1', can be specified to print its value

The 'autotype' key can be changed using the 'autotype_key' variable in the tessen(5) configuration file.

If the dmenu program of your choice supports custom keybindings with exit codes greater than or equal to 10, tessen can execute custom operations on a selected file in the first menu. At the very least, fuzzel(1), bemenu(1), and rofi(1) support this feature. The following exit codes have been mapped to the actions mentioned besides them

These exit codes can be mapped to custom keybindings by configuring the dmenu program of your choice.