Skip to main content

​
Prerequisites

Before installing these dotfiles, ensure your system meets the following requirements:

Operating System

Arch Linux or Arch-based distributions (tested on EndeavourOS)

Package Manager

Pacman + Paru (AUR helper)

Version Control

Git installed and configured

Display Server

Ready to switch to Wayland/Hyprland
These dotfiles are experimental and actively developed. Always review configurations before installation.

​
Installing Paru

If you don’t have Paru installed yet: 
sudo pacman -S --needed base-devel
git clone https://aur.archlinux.org/paru.git
cd paru
makepkg -si

​
Installation Process

1

Clone the Repository

Clone the dotfiles repository with all submodules:
git clone --recurse-submodules https://github.com/ParaDevOne/dotfiles ~/dotfiles
The --recurse-submodules flag is important as it includes Dotbot, the installation framework.
2

Navigate to Directory

Change into the dotfiles directory:
cd ~/dotfiles
3

Run Installation Script

Execute the installation script:
./install
The script will:
  • Check for missing packages from packages.txt
  • Install any missing packages using Paru
  • Create necessary directories
  • Symlink configuration files to their proper locations

​
What Gets Installed

The installation process installs and configures the following components:

​
Core Components

  • hyprland - Dynamic tiling Wayland compositor
  • hypridle - Idle daemon for Hyprland
  • hyprlock - Screen locker for Hyprland
  • hyprshot - Screenshot utility
  • xdg-desktop-portal-hyprland - Desktop portal implementation
  • waybar - Highly customizable status bar
  • rofi - Application launcher
  • wlogout - Logout menu
  • swaync - Notification daemon
  • mako - Notification daemon
  • kitty - GPU-accelerated terminal emulator
  • zsh - Z shell
  • zsh-antidote - Plugin manager for Zsh
  • neovim - Hyperextensible Vim-based text editor
  • lazygit - Terminal UI for git commands
  • yazi - Blazing fast terminal file manager
  • brightnessctl - Screen brightness control
  • pavucontrol - PulseAudio volume control
  • polkit-gnome - Authentication agent
  • btop - Resource monitor
  • bat - Cat clone with syntax highlighting
  • eza - Modern ls replacement
  • fastfetch - System information tool
  • jq - JSON processor
  • wl-clipboard - Wayland clipboard utilities
  • grim - Screenshot utility for Wayland
  • slurp - Select a region in Wayland
  • satty - Screenshot annotation tool
  • imv - Image viewer for Wayland
  • awww-bin - Wallpaper manager
  • brave-bin - Brave browser
  • xdg-user-dirs - User directories management
  • noto-fonts - Google Noto fonts family
  • noto-fonts-cjk - CJK (Chinese, Japanese, Korean) fonts
  • noto-fonts-emoji - Emoji fonts
  • noto-fonts-extra - Additional Noto fonts
  • ttf-jetbrains-mono-nerd - JetBrains Mono Nerd Font
  • ttf-dejavu - DejaVu fonts
  • ttf-bitstream-vera - Bitstream Vera fonts
  • ttf-liberation - Liberation fonts
  • ttf-opensans - Open Sans font
  • inter-font - Inter font family
  • bibata-cursor-theme-bin - Bibata cursor theme
  • papirus-icon-theme - Papirus icon theme
  • qt6-wayland - Qt6 Wayland support

​
Configuration Structure

The installation creates symlinks for the following configurations: 
# Home directory
~/.zshenv

# Applications (WM-agnostic)
~/.config/Code/User/settings.json
~/.config/nvim
~/.config/kitty
~/.config/fastfetch

# Hyprland ecosystem
~/.config/hypr
~/.config/waybar
~/.config/mako
~/.config/wlogout
~/.config/rofi

# System configuration
~/.config/environment.d
~/.config/paru
~/.config/zsh
All configurations are symlinked, not copied. This means changes to files in ~/dotfiles will automatically reflect in your system.

​
Post-Installation Steps

1

Logout of Current Session

Save your work and logout of your current desktop environment.
2

Select Hyprland Session

At your display manager login screen, select “Hyprland” as your session type.
3

Login

Enter your credentials and login to start Hyprland.
4

Set Wallpaper

The default wallpaper is configured in the autostart. To change it:
awww img ~/path/to/your/wallpaper.jpg

​
Verification

After logging in, verify your installation: 
# Check if Hyprland is running
echo $XDG_CURRENT_DESKTOP
# Should output: Hyprland
If you encounter permission errors, ensure the installation script has execute permissions:
chmod +x ~/dotfiles/install

​
Troubleshooting

Press Ctrl + Alt + F2 to switch to a TTY and check logs:
journalctl --user -xe | grep hyprland
Run the installation again to install any missing packages:
cd ~/dotfiles && ./install
Check if waybar is running:
pgrep waybar
If not, start it manually:
waybar &

​
Next Steps

Now that you have Hyprland installed, check out the Quick Start guide to learn essential keybindings and get productive quickly.

Build docs developers (and LLMs) love

Get started for freeTalk to us