PAY_RESPECTS(5)

💅 Configuration File 💅

okay so bestie, welcome to pay-respects(5) — this is the page that tells you where your config file lives and literally every knob you can turn in it. it's the user configuration file for pay-respects, and yes it's giving main character energy ✨

---

📍 Where your config lives

Your user config file is chillin' at:

• $HOME/.config/pay-respects/config.toml (*nix)
• %APPDATA%/pay-respects/config.toml (Windows)

now, the system-wide configuration directories? those get searched too, and lowkey the cool part is that any field in them can be overwritten individually by your user config file 🫶. they live here:

• $XDG_CONFIG_DIRS (*nix)
  • if that's not set, it falls back to /etc/xdg
• $PROGRAMDATA (Windows)
  • if that's not set, it falls back to C:\ProgramData

same directory structure in all of them, like:

/etc/xdg/pay-respects/config.toml

periodt. 💅

---

✨ Options ✨

every available option is listed in the example file below — ngl this is the whole buffet, so let's walk it together 🍓

first up, your privilege command. this is the command used for privileged access:

# Preferred command for privileged acesses
privilege = "sudo"

then there's timeout — the max time in milliseconds for getting previous output:

# Maximum time in milliseconds for getting previous output
timeout = 3000

next is merge_commands, which applies existing rules to a set of commands. and listen — every set uses the rule corresponding to the first entry 👑

# Apply existing rules to a set of commands. Every set will use the rule
# corresponding to the first entry
merge_commands = [
    ["ls", "exa"], # both using rules corresponding to `ls`
    ["grep", "rg"], # both using rules corresponding to `grep`
]

then we got blocking_commands — commands that won't return any message when run, which is most of the interactive commands:

# Commands that won't return any message when run,
# which is most of the interactive commands
blocking_commands = ["vim", "nano"]

eval_method is how suggestions are evaluated after being confirmed. options can be:

• Internal: commands are evaluated inside pay-respects
• Shell: current working shell is responsible for execution

# How suggestions are evaluated after being confirmed
# Options can be:
# - Internal: Commands are evaluated inside `pay-respects`
# - Shell: Current working shell is responsible for execution
eval_method = "Internal"

search_type is the algorithm used for fuzzy searching, and your options are:

• TrigramDamerauLevenshtein: more computationally expensive 💀
• DamerauLevenshtein: fast ⚡

# Algorithm used for fuzzy searching
# Options:
# - TrigramDamerauLevenshtein: More computationally expensive
# - DamerauLevenshtein: Fast
search_type = "TrigramDamerauLevenshtein"

then search_threshold — the minimum characters required to start searching, which avoids false positives when input strings are too short:

# Minimum characters required to start seaching
# Avoids false positive when input strings are too short
search_threshold = 3

under the [trigram] table there's minimum_score — the minimum score for the result to be valid, in the range [0,1]:

# Minimum score for the result to be valid: [0,1]
[trigram]
minimum_score = 0.5

and now the [dl_distance] table, which configures the linguistic distance (Damerau-Levenshtein). the docs break it down like this:

• Percentage: how many characters can be different in the suggestion, rounded to the nearest integer.
• Threshold: how many characters are required for the reference string to start searching to avoid false positives when the reference string is too short.
• Max: maximum distance allowed between the reference and the suggestion.
• Min: minimum strating distance required. search only starts if the distance obtained after the percentage calculation is above or equal to this value.

# Configuring the linguistic distance (Damerau-Levenshtein)
# - Percentage: How many characters can be different in the suggestion, rounded
#   to the nearest integer.
# - Threshold: How many characters are required for the reference string to
#   start searching to avoid false positives when the reference string is too
#   short.
# - Max: Maximum distance allowed between the reference and the suggestion.
# - Min: Minimum strating distance required. Seach only starts if the distance
#   obtained after the percentage calculation is above or equal to this value.
[dl_distance]
percentage = 27.1828182845904523536028747135266250
max = 5
min = 1

okay and finally the [package_manager] table 🎀 — package_manager is your preferred package manager, and install_method is the preferred installation method, which can be limited by the package manager. available options for install_method are:

• System
• Shell (nix and guix only)

[package_manager]
# Preferred package manager
package_manager = "pacman"

# Preferred installation method, can be limited by the package manager
# Available options are:
# - System
# - Shell (nix and guix only)
install_method = "System"

bestie reminder: those comment lines are part of the example file, typo energy and all — i'm not touching them, they're iconic and they're literally what's written 💀

---

👑 AUTHORS

iff.

---

and that's the whole page!! this was pay-respects version 0.8.8, dated April 2026, filed under PAY_RESPECTS(5) — go forth and configure, you absolute icon 🌈⭐💜