Calcurse in Termux – Terminal Calendar and Task Manager

Calcurse is a simple calendar and task manager that runs in the Termux terminal. It lets you create events, manage tasks, check your schedule, and view upcoming activities. You can use simple commands to manage your daily plans from the terminal and keep your important tasks organized in one place.

Here’s what you can do with Calcurse in Termux:

  • Add and manage calendar events.
  • Create tasks and appointments.
  • Search calendar items.
  • View upcoming events.
  • Query items for a specific date or date range.
  • Import iCal calendar files.
  • Export calendar data.
  • Filter and search calendar items.

Install Calcurse in Termux

You only need to run one command to install it and start using the calendar and task manager.

First, update the Termux packages.

pkg update && pkg upgrade -y

Install Calcurse.

pkg install calcurse -y

Check the installed version.

calcurse -v

Use Calcurse in Termux

After installing Calcurse, you can use the following commands to open the calendar, manage tasks, check events, and work with your schedule.

Run Calcurse.

calcurse

Calcurse will open its terminal interface where you can manage your calendar and tasks.

Keyboard Shortcuts

Calcurse has simple keyboard shortcuts for managing your calendar, appointments, and Todo list. You can use the keyboard to move between panels, add or edit items, change dates, and manage your tasks. Here are some useful Calcurse keyboard shortcuts.

General & Global Controls
  • ? — View the built-in help screen.
  • Tab — Switch between Calendar, Appointments, and Todo panels.
  • Q — Save and quit Calcurse.
  • q — Close the current menu or help window.
  • Ctrl + L — Redraw the screen.
Panel Navigation
  • k / Up Arrow — Move up one line or day.
  • j / Down Arrow — Move down one line or day.
  • h / Left Arrow — Move left one day or week.
  • l / Right Arrow — Move right one day or week.
Calendar Panel
  • g — Go to a specific date.
  • 0 — Go to the current day.
  • W — Move back one week.
  • w — Move forward one week.
  • M — Move back one month.
  • m — Move forward one month.
  • Y — Move back one year.
  • y — Move forward one year.
Appointments & Todo
  • a — Add a new appointment, event, or Todo item.
  • d — Delete the selected item.
  • e — Edit the selected item.
  • v — View detailed information or notes.
  • n — Add or edit a text note.
  • p — Change Todo priority from 1 to 9.
  • + — Increase appointment duration.
  • - — Decrease appointment duration.
Configuration & Data
  • C — Open the configuration menu.
  • I — Import data from an .ics file.
  • E — Export data in iCal format.

You can also use Calcurse from the command line.

Show the help menu.

calcurse -h

Show the version.

calcurse -v

Show the current status of Calcurse instances.

calcurse --status

Query calendar items.

calcurse -Q

Query items for a specific date range.

calcurse -Q --from 2026-09-19 --to 2026-09-25

Limit the query to a specific number of days.

calcurse -Q --days 7

Show today’s appointments and events.

calcurse -a

Search for calendar items.

calcurse -S "meeting"

Limit the number of query results.

calcurse -l 10

Grep items from the Calcurse data files.

calcurse -G

Run the garbage collector.

calcurse -g

Import an iCal calendar file.

calcurse -i calendar.ics

Export calendar data to iCal format.

calcurse -x

Export calendar data to pcal format.

calcurse -xp

Run Calcurse without saving configuration or data files.

calcurse --read-only

Run the notification daemon in the background.

calcurse --daemon

Use a custom data directory.

calcurse -D ~/calcurse-data

Use a custom configuration directory.

calcurse -C ~/calcurse-config

Use a specific calendar data file.

calcurse -c ~/calendar

You can also use the built-in help inside Calcurse. Open Calcurse and press:

?

This displays more information about the available commands and keyboard shortcuts.

End Note

Calcurse is a simple terminal-based calendar and task manager for Termux. You can use it to create appointments, manage Todo items, check dates, and organize your daily tasks without leaving the terminal. It keeps your calendar and daily tasks easy to manage in one place.

SHARE THIS POST: