Hyprland/README.md

132 lines
3.8 KiB
Markdown
Raw Normal View History

2022-04-01 19:19:33 +00:00
<p align="center">
2022-04-18 20:08:57 +00:00
![Banner]
<br/><br/>
![Badge Workflow]
[![Badge Discord]][Discord]
![Badge Issues]
![Badge Pull Requests]
![Badge Language]
![Badge License]
![Badge Lines]
![Badge Hi]
2022-04-01 19:19:33 +00:00
</p>
2022-03-20 17:02:20 +00:00
<br/><br/>
2022-04-18 20:08:57 +00:00
People asked me to make a discord server, so [join here!][Discord]
2022-04-07 19:16:00 +00:00
<br/><br/>
2022-04-18 20:08:57 +00:00
2022-03-20 17:02:20 +00:00
Hyprland is a Dynamic Tiling Wayland Compositor in early development stages.
2022-04-18 20:08:57 +00:00
For Hyprland without the land part, see [Hypr], the Xorg window manager.
2022-03-16 19:50:55 +00:00
2022-04-13 16:44:52 +00:00
Hyprland is in early dev, expect some bugs. However, once you get it working, it's pretty stable. :P
Hyprland needs testers! Try it out and report bugs or suggestions!
2022-03-20 17:02:20 +00:00
# Key features
- Parabolic window animations
2022-03-20 17:02:20 +00:00
- Config reloaded instantly upon saving
- Easily expandable and readable codebase
2022-04-05 14:47:03 +00:00
- Rounded corners
2022-04-09 14:51:08 +00:00
- Window blur
- Workspaces Protocol support
2022-04-17 09:51:55 +00:00
- Damage tracking (experimental)
2022-04-05 18:49:15 +00:00
- Fade in/out
2022-03-20 17:02:20 +00:00
- Support for docks/whatever
2022-03-24 17:22:01 +00:00
- Window rules
2022-03-20 17:02:20 +00:00
- Monitor rules
2022-03-21 18:18:33 +00:00
- Socket-based IPC
- Tiling/floating/fullscreen windows
2022-03-20 17:02:20 +00:00
- Moving/resizing windows
# Major to-dos
2022-04-12 19:27:49 +00:00
- Input Methods (wlr_input_method_v2)
- Animations (some new, like workspace)
2022-03-20 19:26:06 +00:00
- Fix electron rendering issues
- Optimization
- Fix weird scroll on XWayland (if possible)
2022-03-20 19:26:06 +00:00
- Become sane
2022-03-20 17:02:20 +00:00
- STABILITY
2022-03-20 19:26:06 +00:00
- More config options for tweakers
- Improve hyprctl
2022-03-20 17:02:20 +00:00
# Installation
2022-04-12 20:36:40 +00:00
I do not maintain any packages, but some kind people have made them for me. If I missed any, please let me know.
2022-04-14 16:18:37 +00:00
**Warning:** since I am not the maintainer, I cannot guarantee that those packages will always work and be up to date. Use at your own disclosure. If they don't, try building manually.
2022-04-12 20:36:40 +00:00
_Arch (AUR, -git)_
```
yay -S hyprland-git
```
## Manual building
If your distro doesn't have Hyprland in its repositories, or you want to modify Hyprland,
2022-03-20 17:02:20 +00:00
2022-04-18 20:08:57 +00:00
please refer to the [Wiki Page][Install] for the installation instructions.
2022-04-12 20:36:40 +00:00
<br/>
2022-03-20 17:02:20 +00:00
# Configuring
2022-04-18 20:08:57 +00:00
Head onto the [Wiki Page][Configure] to see more.
2022-03-20 17:02:20 +00:00
Hyprland without a config is a bad idea!
<br/>
2022-04-02 19:16:53 +00:00
# Contributions
2022-04-18 20:08:57 +00:00
Very welcome! see [Contributing.md][Contribute] for instuctions and guidelines!
2022-04-02 19:16:53 +00:00
<br/>
2022-03-20 17:02:20 +00:00
# Gallery
2022-04-18 20:08:57 +00:00
![Preview A]
![Preview B]
2022-03-20 17:02:20 +00:00
<br/>
# Stars over time
2022-04-18 20:08:57 +00:00
[![Stars Preview]][Stars]
2022-03-27 10:10:47 +00:00
# Special thanks
wlroots - for their amazing library
2022-03-27 10:10:47 +00:00
tinywl - for showing how 2 do stuff
2022-03-27 10:11:01 +00:00
2022-03-27 10:10:47 +00:00
sway - for showing how 2 do stuff the overkill way
2022-03-27 10:11:01 +00:00
2022-03-27 10:10:47 +00:00
vivarium - for showing how 2 do stuff the simple way
2022-03-27 10:11:01 +00:00
2022-03-27 10:10:47 +00:00
dwl - for showing how 2 do stuff the hacky way
2022-03-27 10:11:01 +00:00
wayfire - for showing how 2 do some graphics stuff
2022-04-18 20:08:57 +00:00
<!----------------------------------------------------------------------------->
[Contribute]: https://github.com/vaxerski/Hyprland/blob/main/CONTRIBUTING.md
[Configure]: https://github.com/vaxerski/Hyprland/wiki/Configuring-Hyprland
[Install]: https://github.com/vaxerski/Hyprland/wiki/Installation
[Discord]: https://discord.gg/hQ9XvMUjjr
[Stars]: https://starchart.cc/vaxerski/Hyprland
[Hypr]: https://github.com/vaxerski/Hypr
<!----------------------------------{ 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
[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]: https://img.shields.io/badge/Hi-mom!-ff69b4