Hyprland/README.md

160 lines
4.2 KiB
Markdown
Raw Normal View History

2022-04-18 23:00:16 +02:00
<div align = center>
2022-04-18 22:08:57 +02:00
![Banner]
2022-04-18 23:00:16 +02:00
<br>
2022-04-19 13:38:08 +02:00
![Badge Workflow]
[![Badge License]][License]
![Badge Lines]
![Badge Language]
[![Badge Pull Requests]][Pull Requests]
[![Badge Issues]][Issues]
![Badge Hi Mom]<br>
2022-04-19 11:17:45 +02:00
[![Badge Discord]][Discord]
2022-04-19 13:38:08 +02:00
2022-04-18 23:00:16 +02:00
<br>
2022-04-19 11:17:45 +02:00
Hyprland is a dynamic tiling Wayland compositor based on wlroots that doesn't sacrifice on its looks.
2022-04-18 22:08:57 +02:00
2022-04-19 11:17:45 +02:00
For Hyprland without the `land` part, see [Hypr], the Xorg window manager.
2022-04-19 13:38:08 +02:00
2022-04-18 23:00:16 +02:00
<br>
<br>
2022-04-18 22:08:57 +02:00
2022-04-18 23:02:59 +02:00
---
2022-04-18 23:34:52 +02:00
**[<kbd><br>Install<br></kbd>][Install]**
2022-04-21 18:43:58 +02:00
**[<kbd><br>Quick Start<br></kbd>][Quick Start]**
2022-04-18 23:06:58 +02:00
**[<kbd><br>Configure<br></kbd>][Configure]**
**[<kbd><br>Contribute<br></kbd>][Contribute]**
2022-03-16 20:50:55 +01:00
2022-04-18 23:21:58 +02:00
---
2022-04-18 23:42:57 +02:00
<br>
2022-04-18 23:42:04 +02:00
2022-04-19 11:17:45 +02:00
</div>
# Notice
2022-04-19 13:38:08 +02:00
2022-04-19 11:17:45 +02:00
This project is still in its early development, expect bugs.
2022-04-18 23:53:53 +02:00
2022-04-19 11:26:34 +02:00
Once you get it working though, it's pretty stable.<br/>
2022-04-18 23:42:04 +02:00
2022-04-29 21:43:04 +02:00
**Important:** Hyprland's full damage tracking is buggy. Pairing that with the fact that blur is heavy, expect high GPU usage. (up to really a lot!) Appropriate fixes and improvements are amongst the most important now on the bucket list, but they might take some time to arrive. ***You have been warned!***
2022-04-18 23:42:04 +02:00
### Help Wanted
2022-04-19 11:17:45 +02:00
Hyprland needs testers! <br/>
Try it out and report bugs / suggestions!
2022-03-20 18:02:20 +01:00
2022-04-18 23:21:58 +02:00
# Features
2022-04-19 13:38:08 +02:00
2022-04-18 23:21:58 +02:00
- Easily expandable and readable codebase
- Config reloaded instantly upon saving
2022-04-23 21:47:16 +02:00
- Bezier-curve window animations
- Custom bezier curves
2022-04-19 11:17:45 +02:00
- Workspaces protocol support
2022-04-24 16:44:39 +02:00
- Dual Kawase blur
- Window fade in / out
2022-04-19 11:17:45 +02:00
- Tiling/floating/fullscreen windows
- Window/monitor rules
- Socket-based IPC
- Rounded corners
- Damage tracking(*Experimental*)
- Moving/resizing
- Docks support
2022-03-20 18:02:20 +01:00
2022-04-18 23:36:58 +02:00
<br>
<br>
2022-04-02 21:16:53 +02:00
2022-04-18 22:24:23 +02:00
<div align = center>
2022-04-18 23:36:58 +02:00
# Gallery
2022-04-18 23:30:24 +02:00
2022-04-18 23:32:51 +02:00
<br>
2022-04-18 22:08:57 +02:00
![Preview A]
2022-03-20 18:02:20 +01:00
2022-04-18 22:24:23 +02:00
<br>
2022-04-18 23:32:51 +02:00
![Preview B]
2022-04-18 22:24:23 +02:00
2022-04-18 23:32:51 +02:00
<br>
2022-04-18 22:24:23 +02:00
<br>
2022-04-18 23:36:58 +02:00
# Stars Over Time
2022-04-18 22:24:23 +02:00
<br>
2022-04-18 23:32:51 +02:00
[![Stars Preview]][Stars]
2022-04-18 22:24:23 +02:00
2022-04-18 23:32:51 +02:00
<br>
2022-04-18 22:24:23 +02:00
<br>
</div>
2022-04-18 23:36:58 +02:00
# Special Thanks
2022-04-18 23:30:24 +02:00
<br>
2022-04-19 11:17:45 +02:00
**[wlroots]** - *For their amazing library*
2022-03-27 12:11:01 +02:00
2022-04-19 11:17:45 +02:00
**[tinywl]** - *For showing how 2 do stuff*
2022-03-27 12:11:01 +02:00
2022-04-19 11:17:45 +02:00
**[Sway]** - *For showing how 2 do stuff the overkill way*
2022-04-18 23:30:24 +02:00
2022-04-19 11:17:45 +02:00
**[Vivarium]** - *For showing how 2 do stuff the simple way*
2022-04-18 23:30:24 +02:00
2022-04-19 11:17:45 +02:00
**[dwl]** - *For showing how 2 do stuff the hacky way*
2022-04-18 23:30:24 +02:00
2022-04-19 11:17:45 +02:00
**[Wayfire]** - *For showing how 2 do some graphics stuff*
2022-04-18 22:08:57 +02:00
<!----------------------------------------------------------------------------->
[Configure]: https://github.com/vaxerski/Hyprland/wiki/Configuring-Hyprland
[Discord]: https://discord.gg/hQ9XvMUjjr
[Stars]: https://starchart.cc/vaxerski/Hyprland
[Hypr]: https://github.com/vaxerski/Hypr
2022-04-18 23:08:55 +02:00
[Pull Requests]: https://github.com/vaxerski/Hyprland/pulls
[Issues]: https://github.com/vaxerski/Hyprland/issues
2022-04-18 23:36:58 +02:00
[Todo]: https://github.com/vaxerski/Hyprland/projects?type=beta
2022-04-18 23:08:55 +02:00
2022-04-18 23:34:18 +02:00
[Contribute]: docs/Contribute.md
2022-04-21 18:43:58 +02:00
[Install]: https://github.com/vaxerski/Hyprland/wiki/Installation
[Quick Start]: https://github.com/vaxerski/Hyprland/wiki/Quick-start
2022-04-18 23:08:55 +02:00
[License]: LICENSE
2022-04-18 22:08:57 +02:00
2022-04-18 23:30:24 +02:00
<!----------------------------------{ Thanks }--------------------------------->
[Vivarium]: https://github.com/inclement/vivarium
[WlRoots]: https://gitlab.freedesktop.org/wlroots/wlroots
[Wayfire]: https://github.com/WayfireWM/wayfire
[TinyWl]: https://gitlab.freedesktop.org/wlroots/wlroots/-/blob/master/tinywl/tinywl.c
[Sway]: https://github.com/swaywm/sway
[DWL]: https://github.com/djpohly/dwl
2022-04-18 22:08:57 +02:00
<!----------------------------------{ Images }--------------------------------->
[Stars Preview]: https://starchart.cc/vaxerski/Hyprland.svg
[Preview A]: https://i.imgur.com/ZA4Fa8R.png
[Preview B]: https://i.imgur.com/BpXxM8H.png
[Banner]: https://raw.githubusercontent.com/vaxerski/Hyprland/main/assets/hyprland.png
<!----------------------------------{ Badges }--------------------------------->
[Badge Workflow]: https://github.com/vaxerski/Hyprland/actions/workflows/ci.yaml/badge.svg
2022-04-18 23:00:16 +02:00
2022-04-19 11:17:45 +02:00
[Badge Discord]: https://img.shields.io/badge/Join%20the-Discord%20server-6666ff
[Badge Issues]: https://img.shields.io/github/issues/vaxerski/Hyprland
[Badge Pull Requests]: https://img.shields.io/github/issues-pr/vaxerski/Hyprland
[Badge Language]: https://img.shields.io/github/languages/top/vaxerski/Hyprland
[Badge License]: https://img.shields.io/github/license/vaxerski/Hyprland
[Badge Lines]: https://img.shields.io/tokei/lines/github/vaxerski/Hyprland
[Badge Hi Mom]: https://img.shields.io/badge/Hi-mom!-ff69b4