Hyprdots

A set of functional, sharp-edged, and minimalistic dotfiles for Hyprland.

This configuration is built around a dark, high-contrast color scheme with bright accents, and a strict "no rounded corners" policy for a clean, uniform look.

Color Palette

The color scheme is defined in eww/eww.scss:

• Backgrounds: Dark grays (#0a0a0a, #121212)
• Foreground: Light gray (#e0e0e0)
• Accent (Blue): #00d1ff
• Accent (Green): #50fa7b
• Accent (Red): #ff3838
• Borders: Medium gray (#4a4a4a)

Dependencies

Before running the installation script, please ensure the following packages are installed on your system.

• Core Components:
  • hyprland
  • hypridle
  • hyprlock
  • hyprsunset (blue light filter)
  • hyprpaper (wallpaper)
• Session Manager:
  • uwsm (Universal Wayland Session Manager)
• UI & Widgets:
  • walker (Application Launcher)
  • eww (Elkowars Wacky Widgets)
  • swaync (Sway Notification Center)
  • swayosd (SwayOSD)
• Utilities:
  • upower
  • bluez (provides bluetoothctl)
  • iproute2 (provides ip)
  • procps-ng (provides free)
  • jq
  • socat
  • playerctl
• Audio:
  • pulseaudio-utils (for pactl, may be provided by pipewire-pulse on PipeWire systems)
• Fonts:
  • A Nerd Font is required for icons to display correctly (e.g., JetBrainsMono Nerd Font).

Supported Distributions

The install script automatically detects your package manager and can install missing dependencies:

Distribution	Package Manager
Arch Linux	pacman
Gentoo	portage (emerge)
Debian/Ubuntu	apt
Fedora	dnf
openSUSE	zypper

Installation & Management

This project uses a helper script to manage the configurations by creating symbolic links. This means any changes you make in this git repository will be reflected live on your system.

How to Install

1. Clone the repository to a permanent location: Because this method uses symbolic links, the cloned directory must not be deleted or moved after installation. A good place is ~/git/hyprdots.

   git clone <repository-url> ~/git/hyprdots
   cd ~/git/hyprdots

2. Run the script with the --install flag: The script will ask for confirmation, check dependencies, back up any existing configurations, and then create the necessary symbolic links.

   chmod +x install.sh
   ./install.sh --install

After the installation is complete, log out of your session and log back in to see the changes.

How to Uninstall

To remove the symbolic links and restore your previous configuration from the backup, run:

./install.sh --uninstall

Keybindings

The main modifier key is the Super key (Windows key).

Applications

Keybinding	Action
SUPER + Q	Open Terminal
SUPER + E	Open File Manager
SUPER + W	Open Web Browser
SUPER + R	Open Application Menu
PrintScreen	Take Screenshot

Window Management

Keybinding	Action
SUPER + C	Close Active Window
SUPER + F	Toggle Fullscreen
SUPER + V	Toggle Floating Window
SUPER + P	Toggle Pseudo
SUPER + J	Toggle Split
SUPER + left/right/up/down	Focus Window
SUPER + mouse:272	Move Window (drag)
SUPER + mouse:273	Resize Window (drag)

Workspaces

Keybinding	Action
SUPER + 1-0	Switch to Workspace 1-10
SUPER + SHIFT + 1-0	Move Window to Workspace
SUPER + S	Toggle Scratchpad
SUPER + SHIFT + S	Move to Scratchpad
SUPER + mouse_down	Next Workspace
SUPER + mouse_up	Previous Workspace

Hyprsunset (Blue Light Filter)

Hyprsunset automatically adjusts screen color temperature based on time of day.

Default profiles:

• 06:00 → 6500K (neutral)
• 20:00 → 4500K (warmer)
• 23:00 → 3500K (very warm)

Keybinding	Action
SUPER + T	Reset to 6500K
SUPER + SHIFT + T	Toggle filter on/off
SUPER + SHIFT + ↑	Increase temperature
SUPER + SHIFT + ↓	Decrease temperature

Multimedia Keys

Keybinding	Action
XF86AudioRaiseVolume	Volume Up
XF86AudioLowerVolume	Volume Down
XF86AudioMute	Mute Output
XF86AudioMicMute	Mute Microphone
XF86MonBrightnessUp	Brightness Up
XF86MonBrightnessDown	Brightness Down
XF86AudioNext	Next Track
XF86AudioPrev	Previous Track
XF86AudioPause	Play/Pause
XF86AudioPlay	Play/Pause

Session

Keybinding	Action
SUPER + SHIFT + M	Exit Session