Skip to content

Commit 0233dfe

Browse files
os: update hyprland install and configure options
1 parent 1999df8 commit 0233dfe

File tree

2 files changed

+33
-20
lines changed

2 files changed

+33
-20
lines changed

docs/os/linux/hyprland/configure.md

Lines changed: 20 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,32 @@
22

33
Hyprland comes with a simple config in `~/.config/hypr/hyprland.conf`.
44

5-
Garuda Linux has a richer configuration, and an even more advanced config called G-Hyprland which includes some elements of nwg-shell.
5+
!!! TIP "Organise config into distinct file names"
6+
Consider defining autostart, layouts, bindings, look-n-feel
7+
8+
- placement: monitors, workspace rules, window rules, layouts, boarders, blur
9+
- launch: app aliases, auto-start apps, key bindings
10+
- input: keyboard, mouse and touchpad
11+
- status: app indicators and notifications (unless using a separate tool like waybar)
612

713

814
## Monitors
915

10-
Single monitor easy.
16+
The default monitor settings should be suitable for most single monitor systems.
17+
18+
19+
20+
### Multi-monitor
21+
22+
It is important to configure multiple monitors, especially when they have different display resolutions. Hyprland will use the same scale for each display by default.
23+
24+
25+
!!! NOTE "List the names of each attached monitor"
26+
```shell
27+
hyprctrl monitors
28+
```
1129

12-
Multi-monitor
1330

14-
```shell
15-
hyprctrl monitors
16-
```
1731

1832
> NOTE: workspaces can be assigned to a specific monitor using [workspace rules](#workspace-rules).
1933

docs/os/linux/hyprland/index.md

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@ Hyprland is a high performance Wayland compositor and tiling window manager. Hy
44

55
Hyprland is not a full desktop environment, unlike KDE or Gnome. There are distributions that provide a complete Hyprland based desktop environment.
66

7-
- Omachy: simple and opinionated distribution from Arch Linux & Hprland, completely keyboard driven and providing a crafted experience.
8-
- Garuda Linux: hyprlant variant provides a professional and easy to manage operating system, G-Hyprland provides optional extra Hyprland customisation.
9-
- NWG Live
7+
- Garuda Linux: hyprland variant provides a professional and simple to manage operating system, G-Hyprland provides optional extra Hyprland customisation.
8+
- HyDE: a complete desktop environment for Hyprland, to be added on top of a minimal Arch Linux install.
9+
- NWG Live: provides a convenient way to try out Hyprland with little risk, also has lots of nice themes
1010

1111
Hyprland can be installed on Arch Linux and Nix distributions. Community scripts are available for Debian and RedHat based distributions.
1212

@@ -16,17 +16,7 @@ Hyprland can be installed on Arch Linux and Nix distributions. Community script
1616
## Install Options
1717

1818
!!! WARNING "Hyprland is a quickly evolving project and issues may occur"
19-
20-
=== "Omarchy"
21-
22-
[Omarchy](https://omarchy.org/) is a Linux distribution that provides a keyboard driven and unified menu experience, building on Arch Linux and Hyprland (Wayland compositor and tiling window manager).
23-
24-
Omachy is driven through its menu and configuration files are opened in Neovim (LazyVim config).
25-
26-
Google Mail and other web apps are opened as headless browsers, for a highly focused experience.
27-
28-
A base install option allows for a highly customised opeating system, whilst still retaining the simplicity of Omachy.
29-
19+
Using a BtrFs file system is highly valuable approach for Hyprland, as snapshots can be taken before package updates that allow a system to rollback to the pre-upgrade state if there are issues.
3020

3121
=== "Garuda Linux"
3222

@@ -37,6 +27,13 @@ Hyprland can be installed on Arch Linux and Nix distributions. Community script
3727
Garuda uses the BtrFs file system which allows snapshots and rollbacks to recover the operating system and desktop should hyprland or arch linux pakcages break.
3828

3929

30+
=== "HyDE"
31+
32+
[Hyde-Project/HyDE](https://github.com/HyDE-Project/HyDE) is a series of scripts that install a more complete desktop environment based on Hyprland.
33+
34+
Practicalli recommends installing Arch Linux using a BtrFs partition, so snapshots and rollbacks can manage breaking chainges in Hyprland effectively. This is beyond the scope of the HyDE project itself.
35+
36+
4037
=== "NWG Live ISO"
4138

4239
[NWG-ISO](https://github.com/nwg-piotr/nwg-iso) is a simple way to try out hyprland and the [NWG Shell tools](https://nwg-piotr.github.io/nwg-shell/), providing an experience close to a Desktop Environment like Gnome or KDE.
@@ -55,6 +52,7 @@ Hyprland can be installed on Arch Linux and Nix distributions. Community script
5552

5653
[Arch Linux ISO command line untilities](https://wiki.archlinux.org/title/USB_flash_installation_medium){target=_blank .md-button}
5754

55+
5856
=== "Debian Linux"
5957

6058
[Practicalli Journal - notes on Hyprland with Debian Linux](https://practical.li/journal/linux-wayland-compositor--hyprland/#hyprland-on-debian){target=_blank .md-button}
@@ -65,6 +63,7 @@ Hyprland can be installed on Arch Linux and Nix distributions. Community script
6563

6664
The hyprland packages are on version 0.41 at time of writing, the current release is 0.45 and has significant changes
6765

66+
6867
=== "Arch Linux"
6968

7069
Install a minimal Arch Linux OS from the ISO and setup Arch with Hyprland using the `archinstall`

0 commit comments

Comments
 (0)