██████╗ ██████╗ █████╗ ██╗ ██╔══██╗██╔════╝██╔══██╗██║ ██║ ██║██║ ███████║██║ ██║ ██║██║ ██╔══██║██║ ██████╔╝╚██████╗██║ ██║███████╗ ╚═════╝ ╚═════╝╚═╝ ╚═╝╚══════╝
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.
| View | Description |
|---|---|
| Month | A full month grid (the default view) |
| Week | A seven-day time grid |
| Day | A single-day time grid |
| Agenda | A scrolling list of upcoming days |
| Tasks | Your 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), and2026(start of the year). Many written forms such asJul 13 2026also 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.
Search
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
Navigation
| Keys | Action |
|---|---|
| t | Go to today |
| h / ← | Previous day |
| l / → | Next day |
| j / ↓ | Next event (next week in month view) |
| k / ↑ | Previous event (previous week in month view) |
| [ / PgUp | Previous day, week, or month |
| ] / PgDn | Next day, week, or month |
| { | Previous year |
| } | Next year |
| g | Go to date |
| Tab | Next day with events |
| Shift+Tab | Previous day with events |
| Enter | Open or create event |
| Esc | Clear event selection |
Views
| Keys | Action |
|---|---|
| d / Ctrl+1 | Day view |
| w / Ctrl+2 | Week view |
| m / Ctrl+3 | Month view |
| a / Ctrl+4 | Agenda view |
| Ctrl+5 | Tasks view |
Sidebar
Press s to focus the sidebar; press s or Esc to leave it.
| Keys | Action |
|---|---|
| j / k | Move through sidebar items |
| h / l | Collapse or expand a section |
| Enter / Space | Toggle calendar, switch view, or sync account |
| r | Rename calendar |
| Del | Remove calendar or account |
General
| Keys | Action |
|---|---|
| c | Create event |
| / / Ctrl+F | Search |
| Ctrl+, | Settings |
| ? | Toggle the shortcut overlay |
Under right-to-left locales the calendar mirrors automatically, and the horizontal navigation keys (h/l, ←/→) follow the mirrored direction.