mencal(1)
π mencal(1) β the menstruation calendar, bestie edition π
okay so. mencal is literally a period tracker that lives in your terminal. it's section 1 of the manual (user commands, iykyk), and it's giving organized chaos in the best way. let's get into it π©Έβ¨
β¨ SYNOPSIS β¨
mencal [options] [file1 file2 ... -c CONF1 -c CONF2 ...]
that's it. that's the whole vibe. options in, calendar out. π
πΈ DESCRIPTION πΈ
okay so there's three little friend groups of options here: how it looks, how it's configured, and how it tells you stuff. let's go one by one, no skips.
π Display options
these are the ones that control what your calendar actually looks like on screen. main character energy fr.
-m,--mondayβ draws monday as the first weekday. (sunday is the default, in case you were wondering π)-1β current month only. this is the default, it's the little black dress of flags π-3β previous, current and next month. a lil trio. a lil bestie trio π«Ά-y [YYYY]β the whole entire year calendar. if you don't give it aYYYY, the default is the current year. (theYYYYis optional, like a plus-one you might or might not bring)-q,--quietβ no top information will be printed. it's the "no talking, just vibes" flag π€«-n,--nocolorβ noncolored output. yes she CAN be monochrome. minimalism is a choice β¨-i,--icolor COLORβ intersection color. default is red. the available colors are:red,green,blue,yellow,violet,cyan,shiny,bold. pick your fighter π
ngl "intersection color" is exactly what it sounds like β the color used where the days intersect. use it, love it, respect it.
π§ mencal configuration
-c,--configβ this is the big one. the format is:
s=[YYYY]MMDD,l=LL,d=DD,n=NAME,f=FILE,c=COLOR
the second argument is a comma separated list of options. and like β no spaces are allowed in this list, fr fr, the parser is not playing around π«. if no name is specified, 'Unknown' is used. and you can set various -c options or filenames. stack 'em, bestie.
here's every single one of those little config keys, broken down:
s,start=[YYYY]MMDDβ start day of period. default is the current day β°l,length=LLβ length of period in days. default is28πd,duration=Dβ duration of menstruation in days. default is4π©Έn,name=NAMEβ name of subject. (that's you, or whoever you're tracking, ilysm)f,file=FILEβ filename to save configuration to (see the FILES section below π). heads up: only menstruation related variables will be saved β it's picky like that πc,color=COLORβ color used for menstruation days. the available colors are:red,green,blue,yellow,violet,cyan,shiny,bold. default color is red. and btw, with the'-n'switch, color settings are ignored entirely. she said no color and she MEANT it.
π Info options
-h,--helpβ print help. your bestie when you're lost π«Ά-V,--versionβ print version information. the receipts π
π¦ FILES π¦
$HOME/.mencalrcβ the default configuration file, and it gets automatically loaded. it just shows up. iconic behavior.
π AUTHOR π
(C) 2002 C. McCohy e-mail: <mccohy@kyberdigi.cz> Word-Wide-Web: http://www.kyberdigi.cz/projects/mencal/english
and a little lore for you: this manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page. (but it may be used by others β sharing is caring π)
π HISTORY π
- 22 March 2002 β Originally written by Amaya Rodrigo
<amaya@debian.org>. - 24 Apr 2002 β New manpage contributed by Pablo S. Torralba
<psanchez@skyrealms.org>.
Amaya Rodrigo <amaya@debian.org> is now responsible for developing and maintaining this manual page. Comments and suggestions are greatly welcome β she literally said so, so slide into that inbox if you have thoughts π¬
okay that's the whole thing!! and just so you have the receipts, this page is mencal β Menstruation calendar β mencal(1), from the mencal manual, section 1. go forth and track those cycles, bestie πΈπ©Έβ¨ periodt π
π¦ where this page comes from
- debian bookworm: mencal 3.0-6 Β· GPL-2.0-or-later
- debian trixie: mencal 3.0-6 Β· GPL-2.0-or-later
- ubuntu jammy: mencal 3.0-6 Β· GPL-2.0-or-later
- ubuntu noble: mencal 3.0-6 Β· GPL-2.0-or-later
- ubuntu resolute: mencal 3.0-6build1 Β· GPL-2.0-or-later
- ubuntu stonking: mencal 3.0-6build1 Β· GPL-2.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms