Skip to content

Commit b0307dd

Browse files
authored
Hyprland: Updating guide (#552)
* updated docs * adding hypr to switch instructions
1 parent 79f7287 commit b0307dd

2 files changed

Lines changed: 8 additions & 7 deletions

File tree

src/content/docs/configuration/desktop_environments/hyprland.mdx

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -143,21 +143,21 @@ Most of the key combinations require the use of the mod key which in our case is
143143

144144
## Migrating from another DE/WM
145145

146-
If you already have another DE/WM installed, you can migrate to this dots with the instruction below.
146+
If you already have another DE/WM installed, you can migrate to this dots with the instructions below.
147147

148148
:::note
149-
While it's possible to use the same user account with Hyprland, it's highly recommended to create a new user account (instructions included). Additionally, even with a new user account, there may be daemon conflicts with your previous DE/WM.
149+
While it's possible to use the same user account with Hyprland, it's highly recommended to create a new user account (instructions included). Additionally, even with a new user account, there may be daemon conflicts with your previous DE/WM, so it's more ideal to use a single environment.
150150
:::
151151

152152
Make sure to replace the variables in angle brackets (\<\>) below including the angle brackets themselves.
153153

154-
1. Run `sudo pacman -S cachyos-hypr-noctalia`. If you run into a package conflict with another `-settings` package (such as `cachyos-kde-settings`), you can delete the conflicting package.
155-
1. If you want to use the Noctalia v5 beta (or -git), follow the below steps instead:
156-
* Install noctalia v5 beta with `sudo pacman -Syu noctalia`. If you want the -git version, run `paru -Syu noctalia-git` or `shelly -AI noctalia-git`
157-
1. To create a new user run `sudo useradd -m <new_user> -s /bin/fish`.
154+
1. Run `sudo pacman -S cachyos-hypr-noctalia`. If you run into a package conflict with another `-settings` package (such as `cachyos-kde-settings`), you can delete the conflicting package as these packages do not affect current users.
155+
1. To create a new user run `sudo useradd -m <new_user> -s /bin/fish`. You can also use another shell if you prefer (i.e. /bin/zsh).
158156
1. Run `sudo passwd <new_user>` to set a password for the account.
159157
* If you _really_ want to use the same account (highly discouraged), instead copy the dots over to the user folder `cp -r /etc/skel/. ~` (make sure to create a backup/snapshot first!)
160-
1. Optionally enable sddm as your display manager if it's not already. To do this run `systemctl disable display-manager` and `systemctl enable sddm`. [Noctalia greeter](https://github.com/noctalia-dev/noctalia-greeter) also pairs well with Noctalia, but is a bit more involved to setup.
158+
1. Optionally install `noctalia-greeter` or `sddm` as your display manager. `noctalia-greeter` integrates better with Noctalia, but setup is slightly more complicated.
159+
* To enable sddm as your display manager, install it with `sudo pacman -Syu sddm`, then run `systemctl disable display-manager` and `systemctl enable sddm`.
160+
* To install [Noctalia Greeter](https://github.com/noctalia-dev/noctalia-greeter), run `sudo pacman -Syu noctalia-greeter`, and follow the "Setting up greetd" section of the linked doc. Afterwards, run `systemctl disable display-manager` and `systemctl enable greetd`.
161161
1. Reboot and select the Hyprland (UWSM) session from your display manager.
162162
* If the shell fails to load, try rebooting once more.
163163
1. Log in and follow the [Post Setup Tasks](/configuration/desktop_environments/hyprland/#post-setup-tasks).

src/content/docs/configuration/desktop_environments/switch_desktop.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,7 @@ Here is a list of all the repositories of different DEs and WMs maintained by Ca
101101
- [KDE Plasma](https://github.com/CachyOS/cachyos-kde-settings)
102102
- [GNOME](https://github.com/CachyOS/cachyos-gnome-settings)
103103
- [Niri](https://github.com/cachyos/cachyos-niri-noctalia)
104+
- [Hyprland](https://github.com/CachyOS/cachyos-hypr-noctalia)
104105
- [MangoWM](https://github.com/CachyOS/cachyos-mangowc-dms)
105106
- [i3](https://github.com/CachyOS/cachyos-i3wm-settings)
106107
- [Qtile](https://github.com/CachyOS/cachyos-qtile-settings)

0 commit comments

Comments
 (0)