Calendaring from the command line
On Schedule

We take a spin through several personal calendar apps that you can manage from the command line.
If you have done any administration on a Linux system, you may have used Cron [1] or Anacron [2] for scheduling system commands. What about scheduling personal information from the command line, however? Although you could just about manage to schedule events using Cron or Anacron, free software has several more versatile applications for personal calendaring, most notably Cal or NCal [3], Calendar [4], Remind [5], and When [6].
Most of these applications are in the grand Unix tradition, focusing on a limited set of functions and are configurable in a text editor. Often, the main differences between them is the format for entering events and the syntax for a particular function, although these applications appear to borrow heavily from one another. All of these alternatives are standard in the repositories of most distributions, although only Cal is generally installed by default. Simple and quick, you may find them a welcome change after wrestling with KDE's Akonadi personal information manager or the unresponsiveness in the Google Calendar interface.
Cal and NCal
Cal and NCal provide the command-line equivalent of the date and time applet on a desktop panel that displays calendars but lacks any ability to add personal events. The main difference between Cal and NCal is that Cal organizes each month by columns, and NCal organizes by rows (Figure 1).
By itself, either command displays a calendar for the current month. However, you can display the calendar for an entire year by specifying the year as a four-digit number immediately after the basic command.
Using -A [NUMBER]
or -B[NUMBER]
, you can set the number of months to display before and after the current month. Similarly -3
displays the previous, current, and next month. By default, each week starts on Monday, but you can change the start of the week to Sunday with -S
, or back to Monday with -M
.
Calendar
Calendar looks for files called ~/calendar.[EXTENSION]
. The default calendar it looks for is calendar
, but you can use the -f [FILE]
option to specify another file, such as calendar.birthday
if you are organizing events by files.
Within a calendar file, Calendar looks for lines with the following format:
[DATE] [TAB] [EVENT DESCRIPTION]
The date is expressed in two digits for the day, month, and year, separated by a space, with a day or month assumed to come first. If the calendar file starts with a Language=[LANGUAGE]
field, then the calendar
command looks specifically for date formats that fit that locale's default format. Otherwise, almost any date format can be used, although in the case of confusion, a format is assumed to be MM DD
rather than DD MM
(Figure 2).

By default, Calendar reprints all lines for the current and next day. On Fridays, it takes into account the weekend by printing entries from Friday to Monday.
Appointments can also be defined in others ways. For example, an asterisk (*) indicates that an event takes place every month, and a day of the week means that the event occurs whenever that day occurs.
The default display of Calendar can also be modified with options, such as -A [NUMBER]
to change the number of future days that displays and -B [NUMBER]
to change the number of previous days.
Calendar is a serviceable choice, but the expectations of the date format may be a nuisance to those who prefer to start dates with a year.
Remind
Of all the applications mentioned here, Remind has by far the most options and variations. Because it does not include a preference file, many of these options have to be added to the command line.
Remind uses an event file of any name. The format for an event entry is:
REM [DAY] [DATE] +[ADVANCED WARNING] MSG [MESSAGE]
In this format, REM
signals that the line should be included when Remind prints out events, whereas the advanced warning is an optional entry for the number of days before the event that reminders should start.
Dates in an entry are varied. A two-digit year means a year between 1990 and 2075, whereas a month or a day of the week is case insensitive and can be either the full name or the first three letters as an abbreviation. A range of weekdays can be specified, or, if only a date is given, the event is mentioned every month on that date. About halfway down, Remind's man pages give 16 examples that can help you learn how dates are read.
The simplest form of command is:
remind -n [FILENAME]
The option -n
prints events in calendar format (Figure 3). Alternatives include specifying the number of months in the calendar with -c =[NUMBERS]
and displaying all events with -t
.

If anything, Remind offers more options than many users want. However, remember Remind if you are having trouble finding the exact behavior you need in a calendar application. Odds are, if any of the applications mentioned here have the options you need, Remind will have them.
Buy this article as PDF
(incl. VAT)
Buy Linux Magazine
Direct Download
Read full article as PDF:
Price $2.95
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Subscribe to our ADMIN Newsletters
Find SysAdmin Jobs
News
-
Kubuntu Focus Announces XE Gen 2 Linux Laptop
Another Kubuntu-based laptop has arrived to be your next ultra-portable powerhouse with a Linux heart.
-
MNT Seeks Financial Backing for New Seven-Inch Linux Laptop
MNT Pocket Reform is a tiny laptop that is modular, upgradable, recyclable, reusable, and ships with Debian Linux.
-
Ubuntu Flatpak Remix Adds Flatpak Support Preinstalled
If you're looking for a version of Ubuntu that includes Flatpak support out of the box, there's one clear option.
-
Gnome 44 Release Candidate Now Available
The Gnome 44 release candidate has officially arrived and adds a few changes into the mix.
-
Flathub Vying to Become the Standard Linux App Store
If the Flathub team has any say in the matter, their product will become the default tool for installing Linux apps in 2023.
-
Debian 12 to Ship with KDE Plasma 5.27
The Debian development team has shifted to the latest version of KDE for their testing branch.
-
Planet Computers Launches ARM-based Linux Desktop PCs
The firm that originally released a line of mobile keyboards has taken a different direction and has developed a new line of out-of-the-box mini Linux desktop computers.
-
Ubuntu No Longer Shipping with Flatpak
In a move that probably won’t come as a shock to many, Ubuntu and all of its official spins will no longer ship with Flatpak installed.
-
openSUSE Leap 15.5 Beta Now Available
The final version of the Leap 15 series of openSUSE is available for beta testing and offers only new software versions.
-
Linux Kernel 6.2 Released with New Hardware Support
Find out what's new in the most recent release from Linus Torvalds and the Linux kernel team.