ForrestKnight

ForrestKnight / waycal

Public

A tiny Waybar calendar popup for wlr-layer-shell compositors

47
4
100% credibility
Found Apr 17, 2026 at 47 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

waycal provides a compact, keyboard-navigable calendar popup that anchors below the Waybar status bar on compatible Linux Wayland desktops.

How It Works

1
🔍 Discover waycal

While customizing your Linux desktop bar, you find waycal, a simple popup calendar that drops down when you need it.

2
📥 Get it set up

You easily add waycal to your computer so it's ready to use with your desktop bar.

3
🛠️ Add calendar button

You place a small calendar icon right in your desktop bar where it's easy to spot.

4
🗓️ Click to open

Tap the icon and watch a neat monthly calendar pop up just below the bar, with today highlighted.

5
⌨️ Navigate easily

Use arrow keys to flip months or years, Enter to jump to today, or s to switch styles—feels smooth and fun.

6
❌ Close anytime

Hit Escape or click the icon again to make it disappear instantly.

✅ Quick calendar access

Now you have a handy, keyboard-friendly calendar always one click away in your bar, just how you wanted.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 47 to 47 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is waycal?

waycal delivers a compact calendar popup for Waybar on Wayland compositors like Hyprland or Sway that support wlr-layer-shell. Click the bar icon for a month view that anchors below it, with keyboard controls: arrows shift months or years, Enter jumps to today, Esc closes, and 's' toggles sharp or rounded styles. Built in Rust with GTK4, it beats Waybar's static clock tooltip by offering a focusable, interactive window without compositor tweaks.

Why is it gaining traction?

Its github tiny vibe shines: self-contained dark theme, persisted style prefs, toggle-click close, and no config files needed. Waybar integration is a one-liner custom module using `pkill -x waycal || waycal`. Devs dig the cargo install simplicity and Nerd Font icon support, making it a quick win over bloated calendar apps.

Who should use this?

Waybar tinkerers on layer-shell compositors (Hyprland, Sway, river users). Desktop customizers on Arch or Omarchy seeking keyboard-driven calendar glances. Rust fans building minimal Wayland tools who want Waybar calendar popups without full desktop suites.

Verdict

Worth a spin for Wayland ricers – polished docs, AUR/prebuilt binaries, and zero fluff make it production-ready for light use. But 47 stars and 1.0% credibility score flag low maturity; prototype it first if stability matters.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.