Skip to main content
otter-cal powers the calendar popover on Otter Shell’s status bar clock. It prints a month grid and a bounded agenda list to stdout. Left-click the clock widget and that output shows up as a popover. Today’s date uses your theme accent color. Pipe it 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.