Dotfiles

My personal dotfiles configuration,this is still under development so breaking changes can be expected, also you are open to contribute or give me any suggestions on how can i further improve this.

---

Highlights

• Dynamic Material You Theming: Colors generated on the fly with Matugen from the current wallpaper (~/Pictures/Wallpapers) and automatically synchronized across Hyprland borders, Waybar, and Quickshell widgets.
• Unified Spotlight Launcher: Smooth macOS-style floating launcher powered by Quickshell:
  • App and desktop file search with fast fuzzy matching
  • Dual-pane Clipboard History inspector with image and text previews (: or Super + V)
  • Dual-pane Wallpaper Picker with high-resolution image preview and instant theming (@)
  • Environment controls and system actions (>)
  • Live mathematical calculation with Qalc
  • Direct shell command execution
• Automated Installer & Package Management:
  • Automatically detects and installs required packages via yay, paru, or pacman
  • Automated timestamped backups before applying changes
  • One-command rollback (./install.sh --restore) and --dry-run inspection

---

Installation

1. Clone the repository

git clone https://github.com/0xraiven/dotfiles.git ~/git/dotfiles
cd ~/git/dotfiles

2. Install dotfiles and packages

Run the installer:

./install.sh --install

The installer will:

1. Detect any missing system dependencies and install them using yay, paru, or pacman.
2. Create a timestamped backup of existing configs under ~/.dotfiles-backups/.
3. Deploy configurations into ~/.config/ (hypr, waybar, fish, kitty, quickshell, matugen) and ~/.local/share/dotfiles-assets.
4. Ensure ~/Pictures/Wallpapers exists and apply the Matugen palette matching the active wallpaper.

Installer Flags

Flag	Description
-i, --install	Install dotfiles and packages into $HOME (default)
-u, --uninstall	Remove installed repo configurations from $HOME
-r, --restore [ID]	Restore the latest backup or specify a backup timestamp
-l, --list-backups	List all available timestamped backups
-n, --dry-run	Preview actions without modifying any files
-b, --backup-root DIR	Override backup destination directory
--no-backup	Skip automatic backup creation
--skip-packages	Skip detecting and installing system packages
-h, --help	Show command usage and options

---

Keybinds

Applications & Launcher

Keybinding	Action
Super (tap)	Open Spotlight Launcher
Super + V	Open Spotlight in Clipboard History mode
Super + T	Open Terminal (kitty)
Super + W	Open Web Browser (zen-browser)
Super + E	Open File Manager (nautilus)
Super + C	Open Code Editor (code)
Super + A	Open Antigravity IDE
Super + Q	Close active window
Super + Shift + Q	Exit Hyprland session
Super + Shift + R	Reload Hyprland configuration
Super + F	Toggle Fullscreen
Super + Space	Toggle Floating mode
Super + Tab	Cycle next window

Window Navigation & Management

Keybinding	Action
Super + ← / → / ↑ / ↓	Focus window in direction
Super + Shift + ← / → / ↑ / ↓	Move focused window in direction
Super + Ctrl + ← / → / ↑ / ↓	Resize focused window
Super + LMB (drag)	Move floating window
Super + RMB (drag)	Resize window
Super + 1 – 9	Switch to workspace 1 – 9
Super + Shift + 1 – 9	Move window to workspace 1 – 9
Super + 0	Switch to workspace 10
Super + Shift + 0	Move window to workspace 10
Super + [ / Super + ]	Switch to previous / next workspace
Super + S	Toggle Special workspace (Scratchpad)
Super + Shift + S	Move window to Special workspace (Scratchpad)

System & Hardware Utilities

Keybinding	Action
Print	Screenshot selected region (copies to clipboard and saves to ~/Pictures/Screenshots)
Shift + Print	Fullscreen screenshot (copies to clipboard and saves to ~/Pictures/Screenshots)
Super + L	Lock session (loginctl lock-session)
XF86AudioRaiseVolume	Volume Up (+5%)
XF86AudioLowerVolume	Volume Down (-5%)
XF86AudioMute	Toggle Audio Mute
XF86MonBrightnessUp	Screen Brightness Up (+5%)
XF86MonBrightnessDown	Screen Brightness Down (-5%)

---

Spotlight Launcher Modes

When opening Spotlight (Super), prefix your query or use the dedicated shortcuts:

Prefix / Mode	Action
(None)	Search desktop applications, files, or execute shell commands
: (or Super+V)	Clipboard History: Dual-pane list and preview inspector. Press Return to restore.
@	Wallpaper Picker: Dual-pane wallpaper browser with live image preview. Press Return to apply wallpaper and regenerate theme.
>	System Controls: Quick actions (Next/Random Wallpaper, Screenshots, Waybar restart, Power profiles, Suspend, Reboot, Shutdown).
[math]	Calculator: Type expressions (e.g. 128 * 4 + 16) for instant Qalc calculation.

---

Wallpapers

Wallpapers are stored in ~/Pictures/Wallpapers. Drop any .jpg, .png, or .webp images into that folder, and they will immediately appear in the Spotlight Wallpaper Picker (@), cycle via Next/Random commands, and update your desktop theme colors.