zen-mode-hyprland v0.1.1

Zen mode for Hyprland

zen-mode-hyprland

is a small crystal cli tool that modificates hyprland config; it does turn off: wallpapers(swww), borders, gaps, animations, borders, blur, shadows, waybar

removing visual distractions while working and returning them when needed

!for now very unstable with large and complicated configs and does not support modular configs.!

Installation

for now if you want to use it, clone the repo, compile src/cli.cr; (thx to shell.nix you dont have to install crystal and its dependencies) (also somehow manage to install nix-shell if youre not on nixos)

nix-shell --command "crystal build src/cli.cr --release -o zen-mode-hyprland"

Example

showcase.gif

Usage

./cli [-h | --help] [-i | --initiate] [-o | --off]

    -h, --help                       Print out this text
    -i, --initiate                   Initiate hyprland zen mode
    -o, --off                        Restore default hyprland config

Development

TODO: Write development instructions here

Contributing

  1. Fork it (https://github.com/zedddie/zen-mode-hyprland/fork) -->
  2. Create your feature branch (git checkout -b my-new-feature) -->
  3. Commit your changes (git commit -am 'Add some feature') -->
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

Repository

zen-mode-hyprland

Owner
Statistic
  • 0
  • 0
  • 0
  • 0
  • 0
  • 2 months ago
  • December 9, 2025
License

MIT License

Links
Synced at

Tue, 03 Feb 2026 00:02:39 GMT

Languages