README.md

October 10, 2025 ยท View on GitHub

๐ŸซŸ Hyprdots

starsย ย  REPO SIZEย ย  Last Commitย ย  LICENSEย ย 

main
launcher powermenu
wallpaper rofi git log
obs nvim
player
btop
nvim
github
yazi

My old rice

Change branch of this repo to old-dotfiles

git checkout old-dotfiles

Wallpapers (Google Drive)

Wallpapers


๐Ÿš€ Quick Installation Guide

๐Ÿ“ฆ Programs Included

  • Window Manager: Hyprland (Tiling)
  • Status Bar: Waybar
  • Notification Manager: Dunst
  • Browser: Zen
  • Color Picker: hyprpicker
  • Wallpaper Utility: hyprpaper
  • Screenshot Utility: grim + slurp
  • App Launcher: Rofi
  • Terminal Emulator: kitty
  • Shell: Zsh
  • Media Controls: playerctl
  • Power Management: acpi
  • Brightness Control: brightnessctl
  • Audio Management: pamixer, PulseAudio
  • Network Management: NetworkManager (nmcli), iwd (iNet Wireless Daemon)

โ„น๏ธ For more detailed guidance, check out this


๐Ÿ› ๏ธ Installation Steps

  1. Clone the repository to your home directory like ~ or /home/username :

    git clone https://github.com/ad1822/hyprdots ~/hyprdots
    
  2. Navigate to the cloned directory:

    cd ~/hyprdots
    
  3. Run the setup script:

    bash ./setup.sh
    
  4. GTK Theme Setup:


โš ๏ธ Important Notice (Read Before Running Setup)

Warning:

This setup script will move your existing config files (e.g., for Waybar, Kitty, Hyprland, etc.) to a backup folder at ~/.config_backup. Then, it will copy the new configs from this repo into your ~/.config directory.

What this means:

  • Your current setup will be replaced.
  • If you have customizations you care about, back them up manually or review the script before running.
  • Fonts and themes will be installed system-wide in your ~/.local/share/fonts directory.


My Workflow

  • My setup remaps Caps Lock โ†’ Super (โŒ˜) for faster window management and command access.
  • You can change this behavior in your Hyprland input configuration if you prefer the default key layout.
  • You can also enable animation in hyprland, My configuration have animation, but I have been not fan of animation

Keybindings

ShortcutAction
โŒ˜ + TOpen terminal
โŒ˜ + BLaunch browser
โŒ˜ + WClose active window
โŒ˜ + VToggle floating mode
โŒ˜ + FEnable fullscreen (mode 1)
โŒ˜ + GDisable fullscreen (mode 0)
โŒ˜ + NLaunch floating Neovim Anywhere window
โŒ˜ + OLaunch Obsidian
โŒ˜ + EOpen file manager in terminal
โŒ˜ + POpen Rofi power menu (Rofi)
โŒ˜ + SpaceLaunch Rofi app launcher (Rofi)
โŒ˜ + Shift + ROpen wallpaper selector and reload Hyprpaper
โŒ˜ + Shift + STake area screenshot using Grim & Slurp (copy to clipboard)
PrintTake area screenshot and save with Grimblast
Alt + Shift + SRun custom screenshot script
Alt + Shift + WRestart Waybar
Ctrl + Shift + TabOpen task manager in terminal
โŒ˜ + CLaunch color picker
โŒ˜ + IChange wallpaper and reload Hyprpaper
โŒ˜ + MLaunch Rofi clipboard manager (Rofi)
โŒ˜ + Shift + LLock screen using Hyprlock
โŒ˜ + ALaunch Rofi Wi-Fi selector (Rofi)
Alt + TabCycle to next window
Alt + Shift + TabCycle to previous window
โŒ˜ + TabBring active window to top
โŒ˜ + H / J / K / LMove focus (left / down / up / right)

Workspace Management

ShortcutAction
โŒ˜ + 1โ€“6Switch to workspace 1โ€“6
โŒ˜ + 0 / 9 / 8 / 7Alternate workspace mapping (custom preference)
โŒ˜ + Shift + [1โ€“0]Move active window to workspace 1โ€“10

Tmux Workflow

Prefix key: Ctrl + A To enable these shortcuts, clone my dotsh repository containing all the custom scripts:

git clone https://github.com/ad1822/dotsh.git ~/work/main/dotsh

After cloning, update the paths in your Tmux configuration if your directory structure differs.

ShortcutDescription
Prefix + iLaunch fzf-based cheatsheat (~/work/main/dotsh/fzf/ch)
Prefix + tOpen fzf Tmux session switcher (~/work/main/dotsh/fzf/tmux-session)
Prefix + dEdit dotfiles via fzf-based selector (~/work/main/dotsh/fzf/edit-dotfiles)
Prefix + mOpen mpterm โ€” a minimal music player terminal r