Hyprland/README.md

165 lines
4.4 KiB
Markdown
Raw Normal View History

2022-04-18 21:00:16 +00:00
<div align = center>
2022-04-18 20:08:57 +00:00
2022-07-18 12:19:21 +00:00
<img src="https://raw.githubusercontent.com/vaxerski/Hyprland/main/assets/header.svg" width="750" height="300" alt="banner">
2022-04-18 20:08:57 +00:00
2022-04-18 21:00:16 +00:00
<br>
2022-04-19 11:38:08 +00:00
![Badge Workflow]
[![Badge License]][License]
![Badge Language]
[![Badge Pull Requests]][Pull Requests]
[![Badge Issues]][Issues]
![Badge Hi Mom]<br>
2022-04-19 09:17:45 +00:00
[![Badge Discord]][Discord]
2022-04-19 11:38:08 +00:00
2022-04-18 21:00:16 +00:00
<br>
2022-04-19 09:17:45 +00:00
Hyprland is a dynamic tiling Wayland compositor based on wlroots that doesn't sacrifice on its looks.
2022-04-18 20:08:57 +00:00
2023-03-14 21:56:31 +00:00
It supports multiple layouts, fancy effects, has a very flexible IPC model allowing for a lot of customization, a powerful plugin system and more.
2022-04-18 21:00:16 +00:00
<br>
<br>
2022-04-18 20:08:57 +00:00
2022-04-18 21:02:59 +00:00
---
2022-04-18 21:34:52 +00:00
**[<kbd><br>Install<br></kbd>][Install]**
2022-04-21 16:43:58 +00:00
**[<kbd><br>Quick Start<br></kbd>][Quick Start]**
2022-04-18 21:06:58 +00:00
**[<kbd><br>Configure<br></kbd>][Configure]**
**[<kbd><br>Contribute<br></kbd>][Contribute]**
2022-03-16 19:50:55 +00:00
2022-04-18 21:21:58 +00:00
---
2022-04-18 21:42:57 +00:00
<br>
2022-04-18 21:42:04 +00:00
2022-04-19 09:17:45 +00:00
</div>
# Notice
2022-04-19 11:38:08 +00:00
2022-06-01 20:00:46 +00:00
Hyprland is still in pretty early development compared to some other Wayland compositors.
2022-04-18 21:42:04 +00:00
2022-06-01 20:00:46 +00:00
Although Hyprland is pretty stable, it may have some bugs.
2022-04-29 19:43:04 +00:00
2022-04-18 21:21:58 +00:00
# Features
2022-04-19 11:38:08 +00:00
2022-04-18 21:21:58 +00:00
- Easily expandable and readable codebase
2023-02-27 15:26:44 +00:00
- Plugin support
2022-04-18 21:21:58 +00:00
- Config reloaded instantly upon saving
2022-05-12 09:37:14 +00:00
- Custom bezier curve based animations
2022-04-24 14:44:39 +00:00
- Dual Kawase blur
2022-06-25 18:36:48 +00:00
- Drop shadows
2022-11-30 22:49:47 +00:00
- Rounded corners
2022-11-26 20:56:18 +00:00
- Gradient borders
2022-05-31 12:15:28 +00:00
- Fully dynamic workspaces
2022-06-09 19:59:30 +00:00
- Closely follows `wlroots-git`
2022-07-26 15:34:53 +00:00
- Global keybinds passed to your apps of choice
2022-11-30 22:49:47 +00:00
- A lot of customization
2022-06-01 20:00:46 +00:00
- Bundled wlroots
2022-06-09 19:59:30 +00:00
- Window/layer fade in/out
- Tiling/pseudotiling/floating/fullscreen windows
- Switching workspaces between window modes on the fly
2022-11-30 22:49:47 +00:00
- Special workspaces (scratchpads)
2022-06-09 19:59:30 +00:00
- Window/monitor rules
2022-04-19 09:17:45 +00:00
- Socket-based IPC
2022-06-08 21:03:54 +00:00
- Event system for bash scripts
2022-06-09 19:59:30 +00:00
- Full damage tracking
2022-04-19 09:17:45 +00:00
- Docks support
2022-06-09 19:59:30 +00:00
- Drawing tablet support
2022-08-05 16:52:55 +00:00
- Native IME + Input panels support
2022-07-26 15:34:53 +00:00
- and much more...
2022-03-20 17:02:20 +00:00
2022-04-18 21:36:58 +00:00
<br>
<br>
2022-04-02 19:16:53 +00:00
2022-04-18 20:24:23 +00:00
<div align = center>
2022-04-18 21:36:58 +00:00
# Gallery
2022-04-18 21:30:24 +00:00
2022-04-18 21:32:51 +00:00
<br>
2022-04-18 20:08:57 +00:00
![Preview A]
2022-03-20 17:02:20 +00:00
2022-04-18 20:24:23 +00:00
<br>
2022-04-18 21:32:51 +00:00
![Preview B]
2022-04-18 20:24:23 +00:00
2022-05-15 16:31:30 +00:00
<br>
![Preview C]
2022-04-18 21:32:51 +00:00
<br>
2022-04-18 20:24:23 +00:00
<br>
2022-04-18 21:36:58 +00:00
# Stars Over Time
2022-04-18 20:24:23 +00:00
<br>
2022-04-18 21:32:51 +00:00
[![Stars Preview]][Stars]
2022-04-18 20:24:23 +00:00
2022-04-18 21:32:51 +00:00
<br>
2022-04-18 20:24:23 +00:00
<br>
</div>
2022-04-18 21:36:58 +00:00
# Special Thanks
2022-04-18 21:30:24 +00:00
<br>
2022-04-19 09:17:45 +00:00
**[wlroots]** - *For their amazing library*
2022-03-27 10:11:01 +00:00
2022-04-19 09:17:45 +00:00
**[tinywl]** - *For showing how 2 do stuff*
2022-03-27 10:11:01 +00:00
2022-04-19 09:17:45 +00:00
**[Sway]** - *For showing how 2 do stuff the overkill way*
2022-04-18 21:30:24 +00:00
2022-04-19 09:17:45 +00:00
**[Vivarium]** - *For showing how 2 do stuff the simple way*
2022-04-18 21:30:24 +00:00
2022-04-19 09:17:45 +00:00
**[dwl]** - *For showing how 2 do stuff the hacky way*
2022-04-18 21:30:24 +00:00
2022-04-19 09:17:45 +00:00
**[Wayfire]** - *For showing how 2 do some graphics stuff*
2022-04-18 20:08:57 +00:00
<!----------------------------------------------------------------------------->
2022-08-19 19:50:57 +00:00
[Configure]: https://wiki.hyprland.org/Configuring/Configuring-Hyprland/
2022-04-18 20:08:57 +00:00
[Discord]: https://discord.gg/hQ9XvMUjjr
2022-07-13 18:23:43 +00:00
[Stars]: https://starchart.cc/hyprwm/Hyprland
[Hypr]: https://github.com/hyprwm/Hypr
2022-04-18 20:08:57 +00:00
2022-07-13 18:23:43 +00:00
[Pull Requests]: https://github.com/hyprwm/Hyprland/pulls
[Issues]: https://github.com/hyprwm/Hyprland/issues
[Todo]: https://github.com/hyprwm/Hyprland/projects?type=beta
2022-04-18 21:08:55 +00:00
2022-08-19 19:50:57 +00:00
[Contribute]: https://wiki.hyprland.org/Contributing-and-Debugging/
[Install]: https://wiki.hyprland.org/Getting-Started/Installation/
2023-02-14 20:28:33 +00:00
[Quick Start]: https://wiki.hyprland.org/Getting-Started/Master-Tutorial/
2022-04-18 21:08:55 +00:00
[License]: LICENSE
2022-04-18 20:08:57 +00:00
2022-04-18 21:30:24 +00: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 20:08:57 +00:00
<!----------------------------------{ Images }--------------------------------->
[Stars Preview]: https://starchart.cc/vaxerski/Hyprland.svg
2023-05-15 14:30:17 +00:00
[Preview A]: https://cdn.discordapp.com/attachments/1091569872535814185/1107675866101723277/screenshot-summer.png
[Preview B]: https://i.ibb.co/SX7GbYR/winter-rice.png
[Preview C]: https://i.ibb.co/B3GJg28/20221126-20h53m26s-grim.png
2022-04-18 20:08:57 +00:00
<!----------------------------------{ Badges }--------------------------------->
2022-07-13 18:23:43 +00:00
[Badge Workflow]: https://github.com/hyprwm/Hyprland/actions/workflows/ci.yaml/badge.svg
2022-04-18 21:00:16 +00:00
2022-04-19 09:17:45 +00:00
[Badge Discord]: https://img.shields.io/badge/Join%20the-Discord%20server-6666ff
2022-07-13 18:23:43 +00:00
[Badge Issues]: https://img.shields.io/github/issues/hyprwm/Hyprland
[Badge Pull Requests]: https://img.shields.io/github/issues-pr/hyprwm/Hyprland
[Badge Language]: https://img.shields.io/github/languages/top/hyprwm/Hyprland
[Badge License]: https://img.shields.io/github/license/hyprwm/Hyprland
[Badge Lines]: https://img.shields.io/tokei/lines/github/hyprwm/Hyprland
2022-04-19 09:17:45 +00:00
[Badge Hi Mom]: https://img.shields.io/badge/Hi-mom!-ff69b4