Hypr/README.md
2022-01-23 22:39:49 +01:00

70 lines
2.4 KiB
Markdown

![Hypr](https://i.imgur.com/LtC153m.png)
![BuildStatus](https://github.com/vaxerski/Hypr/actions/workflows/c-cpp.yml/badge.svg)
![Issues](https://img.shields.io/github/issues/vaxerski/Hypr)
![PRs](https://img.shields.io/github/issues-pr/vaxerski/Hypr)
![Lang](https://img.shields.io/github/languages/top/vaxerski/Hypr)
![License](https://img.shields.io/github/license/vaxerski/Hypr)
![Best](https://img.shields.io/badge/Standard-C%2B%2B20-success)
![HiMom](https://img.shields.io/badge/Hi-mom!-ff69b4)
<br/><br/>
Hypr is a Linux tiling window manager for Xorg. It's written in XCB with modern C++ and aims to provide easily readable and expandable code.
Hypr needs testers! Check it out and report suggestions or bugs!
<br/>
# 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
- 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.
*Arch (AUR)*
```
yay -S hypr-git
```
## Manual building
If your distro doesn't have Hypr in its repositories, or you want to modify hypr,
see the [Wiki](https://github.com/vaxerski/Hypr/wiki/Building) to see build and installation instructions.
# Configuring
See the [Wiki Page](https://github.com/vaxerski/Hypr/wiki/Configuring-Hypr) 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](https://i.imgur.com/HLukmeA.png)
![Two](https://i.imgur.com/B0MDTu2.png)
![Three](https://i.imgur.com/yvZVde7.png)
# Known issues
- Picom's shadow and effects do not update for cheap animations while animating
- Non-cheap animations are choppy (duh!)
- Popups sometimes are created a bit off
# Contributions
Refer to [CONTRIBUTING.md](https://github.com/vaxerski/Hypr/blob/main/CONTRIBUTING.md) and the [Wiki](https://github.com/vaxerski/Hypr/wiki/Contributing-&-Debugging) for contributing instructions and guidelines.
# Stars over time
[![Stars over time](https://starchart.cc/vaxerski/Hypr.svg)](https://starchart.cc/vaxerski/Hypr)