# 🐧 Arch Hyprland Configuration

```
  _   _ _   _ _ _ _    ____  _   _ _____ ____  _______ ____  _____
 | | | | \ | | | | |  / ___|| | | | ____|  _ \| ____|  _ \| ____|
 | |_| |  \| | | | |  \___ \| |_| |  _| | |_) |  _| | |_) |  _|
 |  _  | |\  | | | |   ___) |  _  | |___|  _ <| |___|  _ <| |___
 |_| |_|_| \_|_|_|_|  |____/|_| |_|_____|_| \_\_____|_| \_\_____|
```

Welcome to my Arch Linux Hyprland configuration repository! This setup provides a modern, efficient, and highly customizable desktop environment using the Hyprland window manager.

## 📁 Files Included

- `hyprland.conf` - Main Hyprland configuration with keybindings, workspace settings, and window management
- `xdg-portal-hyprland` - XDG portal configuration for proper application integration
- `hong-kong-night.jpg` - Beautiful background image

## 🚀 Features

- **Modern Window Management**: Smooth tiling and floating window behavior
- **Custom Keybindings**: Intuitive shortcuts for productivity
- **Dynamic Workspaces**: Flexible workspace management
- **High Performance**: Optimized for speed and efficiency
- **Easy Customization**: Well-documented configuration for easy modification
- **Theme Integration**: Pywal color scheme support
- **Multimedia Support**: Audio and display controls
- **Hardware-Specific Features**: ASUS ROG laptop support

## 🛠️ Setup Instructions

1. Clone this repository to your home directory:
   ```bash
   git clone https://git.biohazardvfx.com/Nicholai/arch-hyprland.git ~/.config/hypr
   ```

2. Symlink the configuration files to `~/.config/hypr/`:
   ```bash
   ln -sf ~/.config/hypr/* ~/.config/hypr/
   ```

3. Restart Hyprland to apply changes:
   ```bash
   hyprctl reload
   ```

## ⚙️ Configuration Details

### Display Setup
- Primary monitor: eDP-1 (laptop screen)
- External monitor: HDMI-A-1 (3840x2160@60Hz)
- Wallpaper management with pywal theme support

### Autostart Applications
- XDG Portal integration
- D-Bus environment setup
- Polkit authentication agent
- Waybar status bar
- Blueman Bluetooth applet
- Clipboard history with cliphist
- Wal color scheme initialization

### Input Configuration
- US keyboard layout
- Mouse following enabled
- Touchpad with natural scrolling
- Sensitivity control

### Window Management
- **Layout**: Dwindle layout with pseudotiling enabled
- **Gaps**: 5px inner gaps, 10px outer gaps
- **Borders**: 1px active borders with Pywal colors
- **Opacity**: Active windows at 100%, inactive at 86%
- **Animations**: Smooth transitions with custom bezier curves
- **Decorations**: Rounded corners with blur effect

### Keybindings Summary

#### Basic Navigation
- `Super + Q` - Open terminal (kitty)
- `Super + E` - Open file browser (thunar)
- `Super + W` - Wallpaper menu
- `Super + R` - Reload Waybar
- `Super + L` - Lock screen
- `Super + M` - Logout menu (wlogout)
- `Super + SPACE` - Application launcher (wofi)

#### Window Management
- `Super + V` - Toggle floating mode
- `Super + P` - Toggle pseudotiling
- `Super + J` - Toggle split layout
- `Super + S` - Take screenshot with grim/swappy
- `Super + Shift + X` - Close active window
- `Super + Shift + M` - Exit Hyprland

#### Workspace Management
- `Super + [1-9]` - Switch to workspace
- `Super + [1-9]` - Move window to workspace
- `Super + Mouse Wheel` - Switch workspaces

#### Multimedia Controls
- `FN + F1` - Mute speaker
- `FN + F2` - Keyboard brightness down
- `FN + F3` - Keyboard brightness up
- `FN + F7` - Screen brightness down
- `FN + F8` - Screen brightness up
- `FN + F12` - Microphone mute
- `FN + F4` - Keyboard RGB profile switch
- `FN + F11` - Volume down
- `FN + F10` - Volume up

#### Application Shortcuts
- `Super + B` - Firefox browser
- `Super + T` - Virtual machine manager
- `Super + N` - Foundry Nuke
- `Super + G` - Minecraft launcher
- `Super + V` - Vesktop Discord client
- `Super + P` - Parsec streaming
- `Super + Y` - Start transcription with Nerd Dictation

#### System Utilities
- `Super + Shift + H` - Clipboard history with wofi
- `Super + Shift + W` - Wallpaper synchronization script

## 🎨 Customization

This configuration is designed to be easily customizable while maintaining performance and stability. The setup includes:
- Pywal color scheme integration
- Hardware-specific keybindings for ASUS ROG laptops
- Custom animations and visual effects
- Extensive window rules for opacity control
- Theme-aware applications

## 📝 Notes

- This configuration assumes you're running Arch Linux with Hyprland
- Make sure to install required dependencies before using
- Contributions and suggestions are welcome!

---

*Made with ❤️ and Hyprland*