Skip to main content
otter-cal prints a month grid and a bounded agenda list to stdout. That is what the status bar clock shows when you left-click it. Today’s date uses your theme accent color. You can also pipe the output into any bar or launcher that displays text, or run it in a terminal.

​
Usage

​
Agenda file format

Each line has a date in YYYY-MM-DD format, a space, and the event description. One event per line:
Pass the file path with --agenda, or set agenda_path in the config file.

​
Bar integration

The Otter Shell status bar clock runs a command on left-click. The default is otter-cal, which opens the calendar popover inline. Override it with clock_calendar_command in your bar configuration:
Replace the value with any command whose stdout the bar should display. A wrapper script that passes a custom --agenda path works fine.

​
Configuration

otter-cal reads ~/.config/otter-shell/otter-cal.conf:
  • agenda_path: absolute path to your agenda file. Empty runs without agenda data.