2025-09-26 01:53:50 -06:00
2025-09-08 16:15:21 -06:00
2025-09-26 04:57:06 -06:00
2025-09-08 16:15:21 -06:00

🐧 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:

    git clone https://git.biohazardvfx.com/Nicholai/arch-hyprland.git ~/.config/hypr
    
  2. Symlink the configuration files to ~/.config/hypr/:

    ln -sf ~/.config/hypr/* ~/.config/hypr/
    
  3. Restart Hyprland to apply changes:

    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

Description
nicholai's hyprland config
Readme 645 KiB
Languages
Shell 100%