⚡ .files

A minimal, keyboard-centric Hyprland experience.

---

About

Welcome to my personal configuration files (dotfiles). This setup is built around Hyprland on Arch Linux, focusing on aesthetics, performance, and a keyboard-driven workflow.

The system uses Pywal to generate a consistent color scheme across the entire system (Waybar, Kitty, Rofi, Hyprland borders) based on your current wallpaper.

Features

• WM: Hyprland (Wayland) - Smooth animations & tiling.
• Terminal: Kitty - GPU accelerated.
• Shell: Zsh + Starship prompt.
• Bar: Waybar - Highly customizable status bar.
• Launcher: Rofi (Wayland fork) or Wofi.
• Editor: Neovim (Lua configuration).
• Theming: Pywal - Automatic color generation from wallpapers.
• Notifications: Dunst / Mako.

---

Gallery

| | |

---

Quick Start

Full documentation, gallery, and detailed setup guide are available on the Website.

Prerequisites

• A fresh install of Arch Linux.
• git installed.

Installation

The included script will handle package installation and linking config files.

# 1. Update & Install Git
sudo pacman -Syu git

# 2. Clone the repository (Must be named 'dotfiles' for paths to work)
git clone [https://github.com/gab-dev-7/dotfiles.git](https://github.com/gab-dev-7/dotfiles.git) "$HOME/dotfiles"
cd "$HOME/dotfiles"

# 3. Run the installer
chmod +x install.sh
./install.sh

Warning: Back up your existing configurations (~/.config) before running the script!

---

Keybindings

The workflow is heavily reliant on the Super (Windows) key. Here are the essentials:

Key Combination	Action
Super + Enter	Open Terminal (Kitty)
Super + Q	Kill active window
Super + Space	Open App Launcher
Super + E	Open File Manager
Super + F	Toggle Fullscreen
Super + V	Toggle Floating
Super + j/k	Move focus
Super + 1-9	Switch Workspace

---

📂 Folder Structure

$HOME/dotfiles
├── hypr/          # Window Manager
├── kitty/         # Terminal
├── nvim/          # Editor (LazyVim)
├── waybar/        # Status Bar
├── zsh/           # Shell
├── zellij/        # Terminal Multiplexer
├── kanshi/        # Display Management
├── yazi/          # Terminal File Manager
├── wpg/           # Color Theming (Wpgtk)
├── install.sh     # Setup Script
└── README.md

---

🎨 Customization

Changing the Wallpaper & Theme

To change the wallpaper and update the system color scheme:

1. Place your image in ~/Pictures/Wallpapers/.
2. Run the wallpaper script (or use the keybinding if configured):

   wal -i ~/Pictures/Wallpapers/your_image.jpg

3. Reload Hyprland (Super + Shift + C usually) to see changes.

---

🤝 Credits

• Inspired by the Hyprland Community