Configuration

Configuring Hyprland

Hyprland is responsible for…

• keybinds
• environment variables
• display/monitors/workspaces
• window animations
• …

Refer to the Hyprland Wiki for general configuration instructions. Only details specific to the dotfiles are documented below.

• ~/.config/hypr/ is Hyprland’s config folder
  • The hyprland subfolder contains the default configs
  • The custom subfolder is for your extra configs

You can make changes in the former subfolder, but they will be overwritten if you decide to update the dotfiles.

Note

To override the default configs, you may need to use some techniques, such as unbind for keybinds.

And if you’re not able to override something, you can copy the default config file from ~/.config/hypr/hyprland/ to ~/.config/hypr/custom/, and edit ~/.config/hypr/hyprland.conf to comment out the line which source the default config file.

But if you find something wrong with Hyprland after updating using ./setup install, you need to re-check ~/.config/hypr/hyprland.conf to see if the commented-out default config file contains some neccessary changes.

Configuring Quickshell

Quickshell is responsible for shell elements such as the bar and sidebars

Simple configuration

Graphical

Hit Super+I or press the gear button on the right sidebar to open settings. Most common settings are there. If you can’t find what you want, you can try the below

Editing the config file

The config file is ~/.config/illogical-impulse/config.json

For explanation of the options and defaults, see ~/.config/quickshell/ii/modules/common/Config.qml

Note

For configs that are not limited to Quickshell, see the “Misc” section.

Date and time format

You can change the time format between 24h and 12h in the Settings > Services > Time.

Alternatively, in the config file, edit time.format. See https://doc.qt.io/qt-6/qtime.html#toString for the format.

Advanced configuration

• Edit files in ~/.config/quickshell/ii
• See Quickshell Docs
  • It is recommended that you at least go through the Introduction, Positioning, and QML Language pages

Misc

Color theming

Vscode

• Install the Material Code extension, then select a wallpaper.
• Optional tweaks
  • You can change the “material-code.syntaxTheme” option, which has a really weird default.
  • Run “Material Code: Apply styles” to inject yummy rounded corners. If vscode says the installation is corrupt, you can safely select “Don’t show again”.

This works with Microsoft’s proprietary build. If you use some schizo version we don’t guarantee it will work. Well, actually it’s just about differing file paths, so feel free to PR that for the vscode fork you use. The script that handles the color is in dots/.config/quickshell/ii/scripts/colors/code/material-code-set-color.sh

Change UI scale

To change the scale of the shell, open ~/.config/quickshell/ii/shell.qml and adjust this line

//@ pragma Env QT_SCALE_FACTOR=1

To change the scale of everything on your screen, see Monitors - Hyprland wiki

Change font size

GTK Apps

• Use gnome-tweaks if you want a graphical UI with a font picker
• Otherwise, you can use gsettings

# Syntax
gsettings set org.gnome.desktop.interface font-name 'FONT_NAME FONT_SIZE'
# Default of these dotfiles
gsettings set org.gnome.desktop.interface font-name 'Rubik 11'

Qt Apps

You can use the KDE System Settings app to customize fonts

Screen lock/timeout

Timeout

Reference: Hyprland Wiki

Edit ~/.config/hypr/hypridle.conf to your needs.

Use another lock screen program

Reference: Arch Wiki

Take swaylock as example.

Edit ~/.config/hypr/hypridle.conf and modify the value of $lock_cmd as follows:

$lock_cmd = swaylock

Restart hypridle after you make changes (pkill hypridle; hypridle & disown).

Now loginctl lock-session will call swaylock to lock the screen.

How it works

The command loginctl lock-session will send signal to the running hypridle process, and then hypridle will trigger the command from the value of $lock_cmd.

Cloudflare WARP

• This might help you bypass your ISP’s restrictions and provide a faster internet.
• You can also use the button in the right sidebar to toggle it.
• To install and configure WARP:
  1. Install the package by yourself if you haven’t already.
     If you’re on Arch(-based) distro, you can install it from AUR with yay:

     yay -S cloudflare-warp-bin

  2. Enable and start the WARP service:

     sudo systemctl enable warp-svc
     sudo systemctl start warp-svc

  3. Register your device:

     warp-cli registration new

     It will require you to accept the ToS, just press y and hit Enter.
  4. Test the connection:

     warp-cli connect
     warp-cli disconnect

     You should see Success as the output for both commands.
  5. To make sure the sidebar button works, you can click the sidebar button, and check the status:

     warp-cli status

     It should output Status update : followed by Connected or Disconnected depending on the current connection status.
     You can also check the connection status externally by visiting 1.1.1.1 Connection Information page.
  6. (Optional) If you wish to configure the WARP operating mode (for example, have it establish a tunnel via WARP and use DNS-over-TLS for DNS queries), you can run:

     warp-cli mode warp+dot

     See warp-cli mode --help for more information.