Organizing Yourself with Calcurse

19 January, 2021

This post was originally published at an appears here via a CC BY-SA 4.0 license.

Do you need complex, feature-packed graphical or web applications to get and stay organized? I don’t think so. The right command line tool can do the job and do it well.

Of course, uttering the words command and line together can strike fear into the hearts of some Linux users. The command line, to them, is terra incognita.

Organizing yourself at the command line is easy with Calcurse. Calcurse brings a graphical look and feel to a text-based interface. You get the simplicity and focus of the command line married to ease of use and navigation.

Let’s take a closer look at Calcurse.

Getting the Software

If compiling code is your thing (it’s not mine, to be honest), you can grab the source code from the Calcurse website. Otherwise, get the binary installer for your Linux distribution. You might even be able to get Calcurse from your Linux distribution’s package manager. It never hurts to check.

Compile or install Calcurse (neither takes all that long), and you’re ready to go.

Using Calcurse

Crack open a terminal window and type calcurse.

Calcurse, when you start it up

Calcurse’s interface consists of three panels:

Move between the panels by pressing the Tab key on your keyboard. To add a new item to a panel, press a. Calcurse walks you through what you need to do to add the item.

One interesting quirk is that the Appointment and Calendar panels work together. You add an appointment by tabbing to the Calendar panel. There, you choose the date for your appointment. Once you do that, you tab back to the Appointments panel. I know …

Press a to set a start time, a duration (in minutes), and a description of the appointment. The start time and duration are optional. Calcurse displays appointments on the day they’re due.

Entering an appointment in Calcurse

Here’s what a day’s appointments look like:

An appointment list in Calcurse

The to-do list works on its own. Tab to the TODO panel and (again) press a. Type a description of the task, then set a priority (1 is the highest and 9 is the lowest). Calcurse lists your uncompleted tasks in the ToDo panel.

If your task has a long description, Calcurse truncates it. You can view long descriptions by navigating to the task using the up or down arrow keys on your keyboard, then pressing v.

Viewing a task in Calcurse

Calcurse saves its information in text files in a hidden folder called .calcurse in your home directory — for example, /home/scott/.calcurse. If Calcurse stops working, it’s easy to find your information.

Other Useful Features

Other features of Calcurse include the ability to set recurring appointments. To do that, find the appointment you want to repeat and press r in the Appointments panel. You’ll be asked to set the frequency (for example, daily or weekly) and how long you want the appointment to repeat.

You can also import calendars in ICAL format or export your data in either ICAL or PCAL format. With ICAL, you can share your data with other calendar applications. With PCAL, you can generate a Postscript version of your calendar.

There are also a number of command line arguments you can pass to Calcurse. You can read about them in the documentation.

While simple, Calcurse does a solid job of helping you keep organized. You’ll need to be a bit more mindful of your tasks and appointments, but you’ll be able to focus better on what you need to do and where you need to be.

Scott Nesbitt