Skip to main content
Version: 1.6
██████╗  ██████╗ █████╗ ██╗     
██╔══██╗██╔════╝██╔══██╗██║     
██║  ██║██║     ███████║██║     
██║  ██║██║     ██╔══██║██║     
██████╔╝╚██████╗██║  ██║███████╗
╚═════╝  ╚═════╝╚═╝  ╚═╝╚══════╝

Keyboard & Navigation

The calendar window is fully keyboard-driven. Press ? at any time to bring up the in-app shortcut overlay.

Views

Five views are available. Switch between them from the sidebar, or with the keys below.

ViewDescription
MonthA full month grid (the default view)
WeekA seven-day time grid
DayA single-day time grid
AgendaA scrolling list of upcoming days
TasksYour VTODO task lists — shown when Show tasks is enabled and an account provides them

Your last-used view is remembered across sessions. You can also open a specific view from the CLI, e.g. dcal show --view week.

Moving around

  • t jumps back to today.
  • h/l (or /) move one day at a time.
  • [/] (or PgUp/PgDn) move by one period — a day, week, or month depending on the current view.
  • {/} jump a full year back or forward.
  • g opens the Go to date dialog for larger jumps.

Go to date

Press g to open a compact go-to dialog for jumping across long distances in one step. You can either:

  • Type a date and press Enter. Several formats are understood, including 2026-07-13 (ISO), 2026/07/13, 2026.07.13, 2026-07 (first of the month), and 2026 (start of the year). Many written forms such as Jul 13 2026 also work. As you type a recognized date, the picker previews it.
  • Use the mini picker. The single chevrons step by month and the double chevrons step by year; click a day to jump straight to it.

Selecting and opening events

In day, week, and agenda views, j/k (or /) walk through events chronologically, crossing into the next or previous day that has events. In month view the same keys move by week.

  • Tab/Shift+Tab jump to the next or previous day that has events.
  • Enter opens the selected event, or creates a new one if nothing is selected.
  • Esc clears the current event selection.
  • c creates an event on the selected day.

Press / or Ctrl+F to open spotlight-style search. Type at least two characters to search across every connected calendar; selecting a result jumps to and opens that event.

Shortcut reference

KeysAction
tGo to today
h / Previous day
l / Next day
j / Next event (next week in month view)
k / Previous event (previous week in month view)
[ / PgUpPrevious day, week, or month
] / PgDnNext day, week, or month
{Previous year
}Next year
gGo to date
TabNext day with events
Shift+TabPrevious day with events
EnterOpen or create event
EscClear event selection

Views

KeysAction
d / Ctrl+1Day view
w / Ctrl+2Week view
m / Ctrl+3Month view
a / Ctrl+4Agenda view
Ctrl+5Tasks view

Press s to focus the sidebar; press s or Esc to leave it.

KeysAction
j / kMove through sidebar items
h / lCollapse or expand a section
Enter / SpaceToggle calendar, switch view, or sync account
rRename calendar
DelRemove calendar or account

General

KeysAction
cCreate event
/ / Ctrl+FSearch
Ctrl+,Settings
?Toggle the shortcut overlay
note

Under right-to-left locales the calendar mirrors automatically, and the horizontal navigation keys (h/l, /) follow the mirrored direction.

Next Steps

  • Usage - CLI commands for the window, sync, and reminders
  • IPC - Drive dcal from keybinds and scripts