Arch Linux / CachyOS config with Hyprland

This repository contains my personal dotfiles for configuring Linux. The setup uses Hyprland as the primary desktop environment (Wayland compositor) and Quickshell for building custom desktop components.

Preview

2026-05-12_02-15-29.mp4

Overview

Kitty terminal

App launcher

Clipboard manager

Lock screen

Neovim

Installation

1. Install yay

pacman -Syu --needed git base-devel
git clone https://aur.archlinux.org/yay.git ~/yay
cd ~/yay
makepkg -si
rm -rf ~/yay

3. Install all packages

yes | yay -S --answerclean All --answerdiff None \
  # Hyprland & Shell components
  hypridle hyprpolkitagent quickshell xdg-desktop-portal-hyprland \
  # Fonts
  noto-fonts noto-fonts-cjk noto-fonts-emoji otf-geist otf-geist-mono-nerd \
  # Terminal & CLI tools
  kitty btop fastfetch fzf zsh lazygit lsd ripgrep unzip github-cli \
  # Media & notifications
  ffmpeg brightnessctl playerctl libnotify grim slurp cliphist wl-clipboard \
  # Theming
  adw-gtk-theme capitaine-cursors matugen \
  # File manager
  thunar thunar-volman gvfs tumbler
  # Vietnamese input method (optional)
  fcitx5-lotus-bin fcitx5-config-qt

4. Install oh-my-zsh

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Remember to choose zsh as your default shell

Then, install zsh plugins

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

5. Optional: Install some stuffs

• UV (Python package manager)

curl -LsSf https://astral.sh/uv/install.sh | sh

• NVM (Node Version Manager)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

6. Set up github

Open the browser and login to your github account, then run the following command to set up the SSH key for your github account.

gh auth login

7. Uninstall unnecessary packages (optional)

sudo pacman -Runs dunst dolphin htop nano vim wofi

Usage

1. To apply my config, you can run the following command:

   1.1. For Linux

   git clone git@github.com:tiesen243/dotfiles.git ~/dotfiles

   Then, create the symbolic links to the config files

   rm ~/.zshrc
   rm -rf ~/.config/{Thunar,btop,fastfetch,git,gtk-3.0,gtk-4.0,hypr,kitty,lazygit,lsd,matugen,nvim,quickshell}
   
   ln -s ~/dotfiles/{Thunar,btop,fastfetch,git,gtk-3.0,gtk-4.0,hypr,kitty,lazygit,lsd,matugen,nvim,quickshell} ~/.config
   ln -s ~/dotfiles/zsh/themes/yuki.zsh-theme ~/.oh-my-zsh/custom/themes
   ln -s ~/dotfiles/zsh/config.zsh ~/.zshrc
   ln -s ~/dotfiles/zsh/.zprofile ~/.zprofile # for fcitx config (optional)

   Final, make all scripts in the dotfiles/scripts directory executable

   sudo chmod +x ~/dotfiles/scripts/*

   1.1. For Windows

   git clone git clone git@github.com:tiesen243/dotfiles.git $HOME\dotfiles

   Then, create the symbolic links to the config files (make sure to run Terminal as administrator)

   Remove-Item -Force -Recurse $HOME\Documents\WindowsPowerShell
   Remove-Item -Force -Recurse $HOME\AppData\Local\nvim
   
   New-Item -ItemType SymbolicLink -Path $HOME\Documents\WindowsPowerShell -Target $HOME\dotfiles\powershell
   New-Item -ItemType SymbolicLink -Path $HOME\AppData\Local\nvim -Target $HOME\dotfiles\nvim

2. Change Wallpaper

Add your preferred wallpapers to ~/dotfiles/assets/wallpapers/. You can then toggle the wallpaper selector by open the Start Menu using Super+A and click the Wallpaper Selector icon (located at the bottom-right corner of the quick action buttons). After changing the wallpaper, it automatically generates color schemes based on the wallpaper and applies it to the system by using Matugen.

3. Add your avatar to /usr/share/sddm/faces/$USER.face.icon to show in the lock screen

4. Restart your system and enjoy it!

Conclusion

This is my personal config for my arch linux system. You can use it as a reference or clone it to your system. If you have any question, feel free to ask me.

My blog: here

License

This project is licensed under the MIT License - see the LICENSE file for details