Hyprland Post Install Setup & Keybinds

Note

Hyprland is a wayland compositor that supports various layouts such as dwindle (tiling), scrolling, master, monocle, and custom layouts. It is not a full desktop environment (DE).

Why use Hyprland?

Hyprland is a beautiful dyanmic tiling manager that offers a variety of layouts and advanced compositor functionality such as VRR, tearing, and HDR. The CachyOS dots for Hyprland are setup with general defaults that should be completely usable out of the box, with applications that follow the general system theme.

Dotfiles maintained by Jinra

For Noctalia related issues please take a look at the Noctalia docs.

Post Setup Tasks

You will want to configure a few user-specific things after setup. For additional settings, please refer to the Hyprland wiki https://wiki.hypr.land/Configuring/Start/

Location ~/.config/hypr/config

• monitors.lua will setup your monitors. (see more at https://wiki.hypr.land/Configuring/Basics/Monitors/)
  • output should be your monitor id; you can run hyprctl monitors to get this id (e.g. DP-1).
  • mode should be in a format such as 1920x1080@60 (horizontal x vertical @ refresh rate).
  • scale you will most likely want 1, but may want this value higher for higher resolution monitors.
  • You will need to reboot after the first adjustment, but future adjustments should be reflected live.
• input.lua you can define your various hypr input settings here. You’ll probably want to adjust the sensitivity.
• keybinds.lua review this file to see all the keybinds for these dots. You can also check out the general overview below
• windowrules.lua if you find yourself wondering why certain windows have certain behaviors check this file; you can also add/remove rules as you see fit.
• workspaces.lua add various workspace settings here.
• environment.lua is used for setting hypr or user specific environmental variables. Not required to adjust if you’re using UWSM, and it’s more preferable to add these to the UWSM env file instead (see below).

Location ~/.config/uwsm

• env is a file used for defining global variables, you can use this for general variables that need to be assigned for your specific user account (Examples: HYPRCURSOR_THEME, XCURSOR_THEME, QT_QPA_PLATFORM, etc)

Location ~/.config/noctalia (V5 only; V4 will have files here, but you do not need to touch them as they can be configured through Noctalia settings)

• config.toml this is where base configuration lives for cachyos-hypr-noctalia lives. If you’re wondering why the defaults differ from a vanilla noctalia v5 installation, this is why. You shouldn’t have to touch anything in this file.

Location noctalia settings (Super + Z)

• You can edit Noctalia settings here. It’s recommended to go to the templates section and turn on any color templates for any apps you may use.
• Also check out the plugins store

Keybinds

Most of the key combinations require the use of the mod key which in our case is the Windows/Command key (referenced as SUPER), you can change it in keybinds.lua.

Window Management

Description	Key
Force close app/window (hold combo and click)	Super + EscapeSuperEscape
Close focused window/app	Super + QSuperQ
Toggle floating/tiled	Super + Alt + SpaceSuperAltSpace
Maximize focused window	Super + DSuperD
Fullscreen focused window	Super + FSuperF
Toggle split direction	Super + JSuperJ
Focus left	Super + Left ArrowSuperLeft
Focus right	Super + Right ArrowSuperRight
Focus up	Super + Up ArrowSuperUp
Focus down	Super + Down ArrowSuperDown
Switch window focus on workspace	Alt + TabAltTab
Move focused window right	Super + Shift + Right ArrowSuperShiftRight
Move focused window left	Super + Shift + Left ArrowSuperShiftLeft
Move focused window up	Super + Shift + Up ArrowSuperShiftUp
Move focused window down	Super + Shift + Down ArrowSuperShiftDown
Move focused window to next workspace	Super + Control + Shift + Right ArrowSuperControlShiftRight
Move focused window to previous workspace	Super + Control + Shift + Left ArrowSuperControlShiftLeft
Move window (mouse)	Super + Left Arrow then ClickSuperLeft Click
Reize window (mouse)	Super + Right Arrow then ClickSuperRight Click

Launcher

Description	Key
Open Terminal	Super + ReturnSuperReturn
Open File Manager	Super + ESuperE
Open Editor	Super + TSuperT
Open Calculator	Super + CSuperC
Open Browser	Super + WSuperW
Open System Monitor (btop)	Control + Shift + EscapeControlShiftEscape
Toggle Noctalia Settings	Super + ZSuperZ
Toggle Control Center	Super + XSuperX
Toggle App Launcher	Super + SpaceSuperSpace
Open Emoji Launcher	Super + periodSuperperiod
Lock screen	Super + LSuperL
Toggle session menu	Super + Alt + CSuperAltC

Hardware Controls

Description	Key
Raise Volume	Volume then Up ArrowVolume Up
Lower Volume	Volume then Down ArrowVolume Down
Mute Audio Output	MuteMute
Mute Microphone Input	MicMuteMicMute
Play/Pause Media	PlayPlay / PausePause
Next Media Track	NextNext
Previous Media Track	PreviousPrevious
Increase Screen Brightness	Brightness then Up ArrowBrightness Up
Decrease Screen Brightness	Brightness then Down ArrowBrightness Down

Utilities

Description	Key
Color Picker	Super + PSuperP
Screen Capture & Annotate	PrintPrint
Screen Capture Window & Annotate (v4)	Super + PrintSuperPrint
Screen Capture Monitor & Annotate (v5)	Super + PrintSuperPrint
Toggle Screen Recorder (v4 only)	Super + RSuperR
Toggle Wallpaper Menu	Super + Shift + WSuperShiftW
Open Clipboard History	Super + VSuperV
Toggle Notification History	Super + ASuperA

Workspaces

Description	Key
Switch to workspace [1-10]	Super + [0-9]Super[0-9]
Move window to workspace [1-10] (follow)	Super + Shift + [0-9]SuperShift[0-9]
Move window to workspace [1-10] (don’t follow)	Super + Alt + [0-9]SuperAlt[0-9]
Focus next workspace	Super + Control + Right ArrowSuperControlRight
Focus previous workspace	Super + Control + Left ArrowSuperControlLeft
Focus first empty workspace	Super + Control + Down ArrowSuperControlDown
Scroll next workspace (mouse)	Super + Mouse then Down ArrowSuperMouse Down
Scroll previous workspace (mouse)	Super + Mouse then Up ArrowSuperMouse Up
Move window to special workspace	Super + Shift + SSuperShiftS
Toggle special workspace (scratchpad)	Super + SSuperS

Migrating from another DE/WM

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

Note

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.

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

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.
2. If you want to use the Noctalia v5 beta (or -git), follow the below steps instead:
   1. 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
   2. Download the repo here https://github.com/Jinra/CachyOS-PKGBUILDS/archive/refs/heads/pv/noctv5.zip
   3. Extract then navigate to the cachyos-hypr-noctalia folder in terminal and run makepkg -si
3. To create a new user run sudo useradd -m <new_user> -s /bin/fish
4. Run sudo passwd <new_user> to set a password for the account
   1. If you really want to use the same account (highly discouraged), instead copy the dots over to the user folder sudo cp -r /etc/skel/. ~ (make sure to create a backup/snapshot first!)
   2. Change the ownership of the files by running sudo chown -R $USER: ~
5. 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 also pairs well with Noctalia, but is a bit more involved to setup
6. Reboot and select the Hyprland (UWSM) session from your display manager.
7. Log in and follow the Post Setup Tasks.

Migrating from v4 dots to V5

If you’re currently using cachyos-hypr-noctalia with Noctalia v4 and have updated from package version 1.0 to 1.1, follow the instructions below to migrate your dots to v5.

Hypr updates

Note

Once you migrate your keybinds, they will no longer work to call Noctalia IPC calls

1. Install meld if you don’t have it (pacman -Q meld to check if you have it).
2. Run meld /etc/skel/.config/hypr ~/.config/hypr
3. From meld you will see an overview of all the files with changes. Blue files have changes, while green files are net new.
   
4. Click into a blue file to see changes to be applied. You can use your best judgement to determine what to apply, but if you haven’t made any changes, it’s safe to overwrite the whole file. Click the arrow to apply changes and the x to remove old lines.

   ノート

   Make sure to not overwrite things you may have changed such as your monitor settings
   
   
5. You can merge all as well
   
6. When you’re finished with your changes for the file, save and exit
   
7. The new workspaces.lua file will ask where you want to save it. You can save it as ~/.config/hypr/config/workspaces.lua
   

Noctalia Updates

1. Run rm -rf ~/.config/noctalia to remove the current configurations. Alternatively, move them somewhere else if you think you may need something there.
2. cp -r /etc/skel/.config/noctalia ~/.config will copy the new configuration into your home folder.
3. chown -R $USER: ~/.config/noctalia will make you the owner of the folder and files.

Other Updates

Kitty also had a minor update, you can find it in /etc/skel/.config/kitty/kitty.conf

Removing orphans

After updating the package, old dependencies will be orphaned, you can remove those by running shelly purify -o