COOLMAIL(1)

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

💌 COOLMAIL — the coolmail(1) page, bestie edition ✨

okay so you found the coolmail manual page, and honestly? iconic. it lives in the General Commands Manual section, and this is the whole thing, no skips, no cuts. 🎀

✨ NAME ✨

coolmail — a 3D animated mail notification utility 💖

(yeah that's right, your inbox alerts can have main character energy)

🦋 SYNOPSIS 🦋

coolmail [option ...]

that's it. that's the whole vibe. throw some options at it and go. 💅

🌸 DESCRIPTION 🌸

so Coolmail is a mail notification utility, except it's got 3D animated graphics because plain text was simply not the moment. 😌

Coolmail literally watches your inbox and lets you know the second you have mail. no cap. 👑

and here's the cute part — clicking on coolmail can launch your mail reading/writing utility. and while your mail utility is open, clicking on coolmail makes it check your inbox at that exact instant, without waiting around for the next regular interval. obsessed. 🫶

💅 OPTIONS 💅

  • -e command — use this command to launch your mail utility. command is a string, so put it in quotes if it's got spaces in it. ("emacs -f rmail" energy)
  • -f filename — watch filename instead of the default mail inbox file. 🍓
  • -fr n — set the number of frames generated for each animation to n. tune this to your own preference and whatever your machine's graphics performance can handle. the default is 15.
  • -h — print some help, then exit. short and sweet. 🙈
  • -int n | -update n — check your mail inbox at n-second intervals. the default is 30 seconds. ⏰
  • -mono — run in monochrome mode. (no colour, still cute, we respect it)
  • -once — ring the bell when new mail is first detected, but not when more new mail shows up. one ding, then she's done. 🔔
  • -af filename — specifies the audio file to use rather than the standard system beep. 🎵
  • -vol n — a value between 0 and 100 for the volume setting, for both the system beep and the sound file. the default is 50.
  • -v — print version and inbox path. 🏷️
also!! Coolmail accepts the standard X Toolkit options too, like -geometry, etc. so go off.

🌈 EXAMPLES 🌈

coolmail -e "emacs -f rmail" -int 20

tells coolmail to check the inbox every 20 seconds, and launch the shell command emacs -f rmail when the user clicks on coolmail. periodt. 🔥

🎀 X DEFAULTS 🎀

this program understands the core resource names and classes, plus these lil guys:

  • frameCount (class FrameCount) — specifies the number of frames to be generated per animation. ✨
  • inbox (class Inbox) — specifies the mail inbox that coolmail will watch. 👀
  • mailCommand (class MailCommand) — specifies the command that should be launched to read and write mail. 📬
  • monochrome (class Monochrome) — a Boolean value that enables monochrome mode when true. 🖤
  • soundFile (class SoundFile) — specifies the audio file to use rather than the standard system beep. 🔊
  • volume (class Volume) — value between 0 and 100 for the volume setting for both the system beep and the sound file. 🎚️

Copyright 1994

by Byron C. Darrah (darrah@kaiwan.com) 💜

🌟 AUTHORS 🌟

Byron C. Darrah (darrah@kaiwan.com) — sound support added by Randall K. Sharpe (rsharpe@ncsa.uiuc.edu) 🫶

🧚 SEE ALSO 🧚

X(1), xrdb(1)

and that's the whole page, bestie 💖 this was Coolmail version 1.3, straight outta the General Commands Manual. go forth and let your inbox scream at you in 3D. slay. 💅✨🌈

📦 where this page comes from