waycal

A tiny calendar popup for Waybar.

Click a calendar icon in your bar, a month view drops down, arrow keys navigate, Escape closes. That's it. The popup to the right is the real thing — try the arrow keys.

About

waycal is ~250 lines of Rust wrapping GTK4 and wlr-layer-shell. The popup anchors itself directly to the top edge of the screen through the layer-shell protocol, so there is no Hyprland window rule, no hardcoded coordinates, and no compositor-specific config to edit. It works on Hyprland, Sway, river, Wayfire, LabWC, and anything else that implements layer-shell.

The Waybar icon click toggles it: running the binary while another instance is open kills the existing one, so a second click closes the popup. Keyboard focus is granted on-demand, meaning waycal never steals input from your other apps — you can keep typing in a terminal while the calendar is open.

No theme integration, no config file, no plugin API. One binary, one job.

Install

Arch / Omarchy yay -S waycal click to copy
Any distro w/ Rust cargo install waycal click to copy
Prebuilt binary curl … | tar -xz click to copy

Controls

← →
previous / next month
↑ ↓
previous / next year
jump back to today
s
toggle sharp / rounded style (remembered)
close

Links