tessen(5)

💅 tessen(5) — the config file glow-up

okay bestie, so this is the tessen(5) manual page — aka the file formats manual for the config file of tessen(1). literally the whole personality test for your setup lives here. let's get into it 🎀

---

✨ NAME ✨

configuration file for tessen(1) — yes that's it, that's the name, she's lowkey mysterious like that 💅

---

🌸 DESCRIPTION 🌸

so tessen is gonna go hunting for a config file in these locations, in this order:

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

bestie you can also just point straight at your fave spot using the -c option like the tessen(1) page says. main character energy: choosing your own path 💖

the format? it's giving bash variable assignments, no cap:

key="val"

and the double quotes? always specify them, fr fr. like don't skip them, they're part of the fit 🙈

oh and there's a default config file living at

https://git.sr.ht/~ayushnix/tessen/blob/master/config

go grab it if you want a starting point ✨

---

🔥 OPTIONS 🔥

these are the options the config file for tessen(1) actually understands, and yes we're going through all of them because nobody gets left behind 🫶

• pass_backend — the default pass backend to use, either pass(1) or gopass(1). pick your fighter ⭐
• dmenu_backend — the default dmenu backend to use, either fuzzel(1), tofi(1), bemenu(1), wofi(1), rofi(1), or dmenu. so many choices and honestly? slay 🌈
• action — the action that should be performed by tessen. and here's the tea: if you prefer to use both autotyping and copying, it is recommended to leave this option commented or unspecified. iconique advice, take it 👑
• fuzzel_config_file — the path to the configuration file of fuzzel(1). the location of the file specified here is passed to fuzzel using its -config= option 🦋
• tofi_config_file — the path to the configuration file of tofi(1). the location of the file specified here is passed to tofi using its -c option 💜
• yofi_config_file — the path to the configuration file of yofi. the location of the file specified here is passed to fuzzel using its -config-file option. (yes, it says fuzzel — copying it exactly, don't come for me 💀)
• rofi_config_file — the path to the configuration file of rofi(1). the location of the file specified here is passed to rofi using its -config option 🍓
• wofi_config_file
• wofi_style_file
• wofi_color_file — these three are the path to the configuration files of wofi(1). the locations of the files specified using these variables are passed to wofi using its -c, -s, -C options, respectively. and heads up: -k is unsupported and is explicitly set to /dev/null to prevent leaking sensitive information 🔒 (that part matters, okay? safety first 🫶)
• userkey — the name of the key which will be used to decide the username. a simple regex can also be specified, such as

(user|login)

this will match both user and login keys and the first occurence will be used as the username. if unspecified, the default value is user ✨

• urlkey — the name of the key which will be used to decide the URL. a simple regex can also be specified, such as

(url|website)

this will match both url and website keys and the first occurence will be used as the URL. if unspecified, the default value is url 🔗

• autotype_key — the name of the key which will be used to decide the autotype key. a simple regex can also be specified, such as

(type|auto)

this will match both type and auto keys and the first occurence will be used as the custom autotype operation key value pair. if unspecified, the default value is autotype ⌨️

• delay — the delay, in milliseconds, introduced between successive autotype operations. if unspecified, the default value is 100 milliseconds ⏳ (yes, one hundred, don't @ me)
• web_browser — the default web browser that should be used for opening URLs. and the important bit: if this is specified, xdg-open(1) will not be used even if it's installed 🧚

---

👀 SEE ALSO 👀

tessen(5), pass(1), gopass(1) pass-otp(1), fuzzel(1), tofi(1), bemenu(1), wofi(1), rofi(1), wl-clipboard(1), wtype(1), notify-send(1) — go read them, iykyk 💖

---

💜 AUTHORS 💜

developed and maintained by Ayush Agarwal <ayush at ayushnix dot com>. honestly a legend for this one 👑

the latest source can be found at https://git.sr.ht/~ayushnix/tessen and bugs or suggestions can be reported on https://todo.sr.ht/~ayushnix/tessen. for contributing to tessen, please read the CONTRIBUTING.md file in the tessen source code and send patches by email to ~ayushnix/tessen@lists.sr.ht. alternatively, pull requests can be raised on https://codeberg.org/ayushnix/tessen/pulls or https://github.com/ayushnix/tessen/pulls 🌸

---

k that's the whole thing bestie, no cap. this page is the 2023-07-29 edition of tessen(5) — dated and versioned and everything, so you know it's fresh ⭐🦋💅