LEI-CONFIG(1)

📦
version 2.1.0 · 5 versions
, in arch rolling, nixos 26.05, nixpkgs unstable

💅 LEI-CONFIG(1) 💅

okay so this is a page from the public-inbox user manual, and it's literally all about lei-config — the little git-config wrapper that handles your lei configuration file. bestie, let's get into it 🎀

✨ NAME ✨

lei-config — a git-config wrapper for the lei configuration file. that's it, that's the vibe 🦋

✨ SYNOPSIS ✨

lei config <name> [[<value>] [<value-pattern>]]

lei config -l | --list

lei config -e | --edit

✨ DESCRIPTION ✨

so basically it calls git-config(1) but with "$XDG_CONFIG_HOME/lei/config" as the configuration file. all "OPTIONS" get passed straight through, no notes — except the ones that would override the configuration file, and those are not permitted, periodt. 🙅‍♀️

every single "imap" and "nntp" option can be specified per-host, or (if you're on git 2.26+) with wildcards, like so:

[imap "imap://*.onion"]
        proxy = socks5h://127.0.0.1:9050

[nntp "nntp://example.com"]
        proxy = socks5h://127.0.0.1:1080

iconic wildcard behavior honestly 🧚

🌸 VARIABLES 🌸

  • external.* — managed by lei-add-external(1) and lei-forget-external(1). you don't touch these by hand, they run themselves 💅
  • imap.proxy, nntp.proxy — the "socks5h://" proxy address. older versions of SOCKS may be supported, but only if there's user demand.
  • imap.starttls, nntp.starttls — enable or disable STARTTLS on non-imaps:// and non-nntps:// hosts. by default, STARTTLS is enabled if available — unless you're connecting to a Tor .onion or localhost. 🧅
  • imap.compress, nntp.compress — enable protocol-level compression. lowkey warning: this may be incompatible or broken with some servers 😭
note: Net::NNTP compression support is pending: <https://rt.cpan.org/Ticket/Display.html?id=129967>
  • imap.debug, nntp.debug — enable debugging output of the underlying IMAP and NNTP libraries, currently Mail::IMAPClient and Net::NNTP, respectively. and if imap.proxy or nntp.proxy points to a SOCKS proxy, debugging output for IO::Socket::Socks gets enabled too. ✨
ngl, you might need to disable imap.compress just so the output is readable. do with that what you will 💀
  • imap.timeout, nntp.timeout — the read timeout for responses.

Default: 600 seconds (IMAP); 120 seconds (NNTP) ⏰

  • imap.fetchBatchSize — how many full messages get fetched at once. larger values reduce network round trips, but at the cost of higher memory use — especially when you're retrieving large messages. 🫶

small responses for IMAP flags are fetched at 10000 times this value.

Default: 1

  • color.SLOT — "quoted", "hdrdefault", "status", "attachment" color slots are supported for the -f text and -f reply output formats of lei-lcat(1) and lei-q(1).

any per-project .git/config, and global ~/.gitconfig files will also be parsed for diff coloring. the git diff color slots ("color.diff.SLOT") supported are "new", "old", "meta", "frag", "func", and "context". 🌈

✨ OPTIONS ✨

most git-config(1) command-line switches are accepted by lei config as-is. the ones you'll actually be reaching for are:

  • -e, --edit — open an editor to edit the lei config file. go off, edit your lil heart out ✍️
  • -l, --list — list all variables set in the config file, along with their values. the receipts, basically 📋

✨ CONTACT ✨

feedback welcome via plain-text mail to <mailto:meta@public-inbox.org> 💌

the mail archives are hosted at <https://public-inbox.org/meta/> and <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/> — yes that second one is a whole onion address, we love a Tor moment 🧅✨

copyright all contributors <mailto:meta@public-inbox.org> 🫶

license: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt> 📜

aaaand that's the whole page, bestie 💖 this version came straight out of public-inbox.git, dated 1993-10-02 — yeah, that date is a whole mood, and it's literally the footer of the original. slay, bye 👑

📦 where this page comes from