Hypr/README.md
2022-05-16 17:44:52 +02:00

3.3 KiB



Hypr is a dynamic Linux tiling window manager for Xorg. It's written in XCB with modern C++ and aims to provide easily readable and expandable code.

For Hypr with land, see Hyprland, the Wayland Compositor.


Hypr is _only_ a window manager. It is not a compositor and does not implement a compositor's functionality. You can run it without one (e.g. Picom) though, since it runs on Xorg, which doesn't require a compositor.

Key Features

  • True parabolic animations
  • Rounded corners and borders
  • Config reloaded instantly upon saving
  • A built-in status bar with modules
  • Easily expandable and readable codebase
  • Pseudotiling
  • Multiple tiling modes (dwindling and master)
  • Window rules
  • Intelligent transients
  • Support for EWMH-compatible bars (e.g. Polybar)
  • Keybinds config
  • Tiling windows
  • Floating windows
  • Workspaces
  • Moving / Fullscreening windows
  • Mostly EWMH and ICCCM compliant

Installation

I do not maintain any packages, but some kind people have made them for me. If I missed any, please let me know.

IMPORTANT: Hypr requires xmodmap to correctly apply keybinds. Make sure you have it installed.

For stable releases, use the Releases tab here on github, and follow the instructions to install it in the Wiki

Arch (AUR)

yay -S hypr-git

Void Linux

https://github.com/Flammable-Duck/hypr-template

Manual building

If your distro doesn't have Hypr in its repositories, or you want to modify hypr,

see the Wiki to see build and installation instructions.

Configuring

See the Wiki Page for a detailed overview on the config, or refer to the example config in examples/hypr.conf.

You have to use a config, place it in ~/.config/hypr/hypr.conf

Screenshot Gallery

One Two Three

Known issues

  • Picom's shadow and effects do not update for cheap animations while animating
  • Non-cheap animations are choppy (duh!)

Contributions

Refer to CONTRIBUTING.md and the Wiki for contributing instructions and guidelines.

Stars over time

Stars over time