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
News
-
Another New Linux Laptop has Arrived
Slimbook has released a monster of a Linux gaming laptop.
-
Mozilla VPN Now Available for Linux
The promised subscription-based VPN service from Mozilla is now available for the Linux platform.
-
Wayland and New App Menu Coming to KDE
The 2021 roadmap for the KDE desktop environment includes some exciting features and improvements.
-
Deepin 20.1 has Arrived
Debian-based Deepin 20.1 has been released with some interesting new features.
-
CloudLinux Commits Over 1 Million Dollars to CentOS Replacement
An open source, drop-in replacement for CentOS is on its way.
-
Linux Mint 20.1 Beta has Been Released
The first beta of Linux Mint, Ulyssa, is now available for downloading.
-
Manjaro Linux 20.2 has Been Unleashed
The latest iteration of Manjaro Linux has been released with a few interesting new features.
-
Patreon Project Looks to Bring Linux to Apple Silicon
Developer Hector Martin has created a patreon page to fund his work on developing a port of Linux for Apple Silicon Macs.
-
A New Chrome OS-Like Ubuntu Remix is Now Available
Ubuntu Web looks to be your Chrome OS alternative.
-
System76 Refreshes the Galago Pro Laptop
Linux hardware maker has revamped one of their most popular laptops.