LSMBOX(1)

📦 version 2.1.3, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💌 lsmbox — the manual, but make it cute

okay bestie, welcome to lsmbox(1) from the General Commands Manual section. she's a little unix girl who counts your mail and I'm obsessed with her. let's go 💅

✨ NAME ✨

lsmbox — list number of total, old unread, and new messages for the specified mailbox(es)

🎀 SYNOPSIS 🎀

lsmbox [OPTION]...  [MAILBOX]...

🦋 DESCRIPTION 🦋

lsmbox lists the number of messages in a mailbox. Not just any number, bestie — she gives you the total, the unread but old, and the new messages. For one mailbox, or several mailbox files, she does not care, she is flexible like that. 💖

Mailboxes that don't exist or are empty? Silently ignored. Not a peep. She's not gonna nag you about it.

If the program has been compiled with curses support, you can execute a predefined command on a mailbox by choosing that mailbox using the cursor keys and pressing enter. And if it's been compiled with ncurses, you can also execute the command by clicking on the mailbox with the mouse-pointer. mouse girlies rise up 🖱️✨

By default, lsmbox will look in $MAIL (if defined) or /var/spool/mail/USERNAME for the inbox, and in $HOME/Mail/ for other mailboxes. This can be overridden by changing the default paths in $HOME/.lsmboxrc. See lsmboxrc(5) for further details. And if $HOME is not defined on your system? She'll look in the current directory for mailboxes. improvising, adapting, slaying 💅

If no mailbox is given as an argument, the program will default to listing information about the mailboxes listed in $HOME/.lsmboxrc. But — and this is the part where she gets dramatic — if no default mailboxes have been specified in that file, or if that file does not exist, the program will abort with an error. 😭 like she simply cannot work under these conditions.

A filename of ! denotes your inbox. yes bestie, just a lil exclamation mark 🫶

A leading (=) or (+) in a filename will be expanded into the path to your mail-directory.

And one more thing, no cap: if the name of a mailbox given at the command-line contains a path-separator (/), it is assumed that the default mailbox path shall be ignored for that entry — unless it has a leading (=) or (+). iykyk

🌸 OPTIONS 🌸

  • -c, --continuous — Update statistics continuously rather than just listing them once. Exit with q (waits for the next mailcheck to finish) or <ctrl> + c (aborts immediately). > Note: this option is only available if the program has been compiled with curses support.
  • -i, --check-interval — Interval in seconds between each update of the statistics. This option overrides the environment variable $MAILCHECK. Using a low interval will give you faster notification of newly arrived e-mail, but will put increased load on your system. she's fast but she's high-maintenance, pick your fighter > Note: this option is only available if the program has been compiled with curses support.
  • -n, --new-only — Only display mailboxes with new messages (and old unread, if the mark_old option has been unset). filtered, focused, iconic
  • -o, --no-old — Do not display the number of old messages each mailbox contains.
  • -p, --padding — Width to use for the mailbox column; leave empty to use the smallest possible. aesthetic spacing control ✨
  • -s, --no-summary — Do not display a summary of the statistics for all mailboxes.
  • -S, --short-names — Only display the name of the mailbox rather than the full path.
  • -t, --no-total — Do not display total number of messages each mailbox contains.
  • --help — Display help for the command.
  • --version — Display version and author information. the lore drop 📜

🌈 ENVIRONMENT 🌈

  • MAILCHECK — Interval in seconds between each update of the statistics.

💖 EXAMPLES 💖

To get information about your inbox:

lsmbox !

To get information about the mailboxes debian-devel, linux-kernel, and spam:

lsmbox debian-devel linux-kernel spam

To get information about the mailbox test which resides in your home directory:

lsmbox ~/test

To use lsmbox to keep track of updates in all mailboxes listed in $HOME/.lsmboxrc:

lsmbox -c

🎀 FILES 🎀

  • $HOME/.lsmboxrc — Personal preferences for lsmbox.

👑 SEE ALSO 👑

lsmboxrc(5), mbox(5)

go read your other manuals bestie, they're all part of the same friend group

🕰️ HISTORY 🕰️

The way she's been documenting her own glow-up since 2002… main character energy fr fr

  • Apr 16 2006: Updated for v2.1.0 of lsmbox.
  • Apr 16 2004: Updated for v2.0.0 of lsmbox.
  • Mar 13 2004: Updated for v1.9.0 of lsmbox.
  • Mar 15 2003: Updated for v1.7.0 of lsmbox.
  • Jan 16 2003: Minor fixes.
  • Jan 06 2003: Minor fixes.
  • Dec 09 2002: Minor fixes.
  • Nov 06 2002: Updated for v1.5.0 of lsmbox.
  • Oct 30 2002: Updated for v1.4.2 of lsmbox.
  • Oct 30 2002: Fixed a typo.
  • Oct 30 2002: Updated for v1.4.0 of lsmbox.
  • Oct 29 2002: Updated for v1.3.1 of lsmbox.
  • Oct 29 2002: Updated for v1.3.0 of lsmbox.
  • Oct 28 2002: Fixed a typo.
  • Oct 26 2002: Updated for v1.1.0 of lsmbox.
  • Oct 26 2002: Updated for v1.0.1 of lsmbox.
  • Oct 21 2002: Initial release. the origin story ⭐

💜 AUTHOR 💜

lsmbox and its manual-pages are written by David Weinehall <tao@acc.umu.se>

🙈 REPORTING BUGS 🙈

Report bugs to <tao@acc.umu.se>. be nice about it, she's trying her best

Copyright © 2002-2006 David Weinehall

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

NO WARRANTY, bestie. none. zero. she said what she said. 💀

and that's the whole page, mwah 💋 — brought to you by David Weinehall, dated Apr 16, 2006. go check your mail, love you, bye! 🫶✨

📦 where this page comes from