hbuddenberg

hbuddenberg / hyprcaffeine

Public

☕ Idle inhibition utility for Hyprland — caffeine for your Wayland compositor

18
0
89% credibility
Found May 20, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

HyprCaffeine is a utility for Linux users running the Hyprland desktop environment. It gives you complete control over when your computer stays awake or goes to sleep. You can set timers to keep your system from sleeping for specific durations, enable infinite mode for uninterrupted sessions, prevent your screen from dimming, and even block your laptop lid from triggering sleep mode. The tool integrates directly into your desktop with a status indicator in your top bar, desktop notifications when you toggle states, and keyboard shortcuts for instant control. It also features an automatic mode that can detect when you're using fullscreen applications or specific programs and keep your system awake accordingly.

How It Works

1
🔍 You discover HyprCaffeine

While customizing your Hyprland desktop, you find a tool that keeps your computer from falling asleep exactly when you need it to stay awake.

2
📦 You install the tool

You run a simple installer that automatically sets up everything you need, including keyboard shortcuts and a status indicator in your top bar.

3
☕ You activate caffeine mode

With one click or keyboard shortcut, your computer stops thinking about sleeping. A cozy coffee cup icon appears in your status bar.

4
You choose how long you need
⏰
Timer mode

Set it for 15 minutes, 30 minutes, an hour, or two hours — perfect for watching a movie or a focused work session.

♾️
Infinite mode

Keep everything awake until you manually turn it off — great for presentations or late-night coding.

5
🖥️ You keep your display and lid under control

You can also prevent your screen from dimming or stop your laptop from sleeping when you close the lid — all independent toggles that work together.

6
⌨️ You use keyboard shortcuts for quick control

Super+Ctrl+I toggles caffeine instantly, Super+Ctrl+D keeps your display on, and Super+Ctrl+Shift+D blocks the lid — all without opening any menus.

✨ Your computer stays awake exactly when you need it

Whether you're giving a presentation, watching media, or deep in a creative flow, your system stays awake on your terms — and returns to normal automatically when you're done.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 18 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 hyprcaffeine?

HyprCaffeine is a sleep inhibition utility for Hyprland -- the popular Wayland compositor. Think of it as the "caffeine" feature you find on laptops, but for your entire desktop session. It prevents your system from suspending, dimming the display, or reacting to lid-close events through three independent toggles: idle blocking, display keep-awake, and lid inhibition. The tool runs as a bash-based CLI with systemd-inhibit under the hood, offering commands like `hyprcaffeine on 30m` for timed sessions or `hyprcaffeine on infinite` for persistent wake. A Rust-based TUI dashboard is also in development for v2.0.

Why is it gaining traction?

This fills a genuine gap in the Hyprland ecosystem. Most sleep inhibition tools are compositor-agnostic and require manual configuration, whereas HyprCaffeine integrates directly with Hyprland's keybinding system, Waybar for visual status, and the Walker launcher for a polished menu interface. The auto-activation watcher is particularly clever -- it can detect fullscreen applications or specific programs like Steam and Discord, then automatically enable inhibition when needed. Color-coded waybar output lets you see at a glance which features are active without opening a terminal.

Who should use this?

Hyprland users who frequently watch media, give presentations, run long-running tasks, or use applications that conflict with system idle settings. Developers working with wayland compositor customization will appreciate the clean CLI interface and automatic waybar integration. Power users who want independent control over sleep, display, and lid behavior -- rather than an all-or-nothing approach -- will find this more flexible than alternatives.

Verdict

If you're running Hyprland, HyprCaffeine is the most polished idle inhibition tool available. The shell-based architecture makes it lightweight and easy to audit, while the AUR package and installer handle setup painlessly. At 18 stars and v0.7.4, the project shows active development but limited community traction (credibility score: 0.9%). The documentation is solid and the feature set is complete for its scope, though the watcher daemon requires socat as an additional dependency. Worth trying if you want clean, integrated caffeine control on Wayland.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.