Skip to content

Customization

Jump to bottom
DvNET edited this page Apr 9, 2025 · 5 revisions

HyprDots is a fully customized Hyprland setup, optimized for Arch Linux users. This guide covers the customization of its core components, including configuration files, appearance tweaks, and script usage.

Hyprland (Wayland Compositor)

Hyprland is the foundation of HyprDots, a dynamic tiling window manager with powerful features. Configuration is modular, divided into multiple files:

  • env.conf → Defines environment variables
  • execs.conf → Defines startup programs and auto-launch settings
  • general.conf → Monitor settings, appearance, animations, and general behavior
  • keybinds.conf → All keybindings for Hyprland
  • rules.conf → Window rules, workspace rules, and layer rules

For in-depth customization, refer to the official Hyprland Wiki.

Hyprlock (Lock Screen)

Hyprlock is the official screen locker for Hyprland, providing a secure and customizable lock screen experience. The configuration file is located at:

$HOME/.config/hypr/hyprlock.conf

Key features:

  • Customizable background image or color
  • Configurable clock format and position
  • Multiple unlock methods support
  • Customizable input field appearance

For detailed configuration options and advanced features, consult the Hyprlock Wiki.

Hypridle (Idle Daemon)

Hypridle is an idle daemon designed specifically for the Hyprland ecosystem, managing system behavior when idle. The configuration file is located at:

$HOME/.config/hypr/hypridle.conf

Key capabilities:

  • Configurable timeout actions (lock screen, display off, sleep)
  • Multiple timeout thresholds for different actions
  • Custom script execution on idle/resume
  • DPMS (Display Power Management Signaling) control

For advanced configuration and detailed options, refer to the Hypridle Wiki.

Waybar (Status Bar)

Waybar provides a customizable status bar with multiple presets and themes included in HyprDots:

Available Presets:

  • bottom - Bar positioned at the bottom of the screen
  • float - Floating bar with rounded corners
  • side - Vertical bar on the side of the screen
  • slant - Bar with slanted module separators
  • top - Bar positioned at the top of the screen

Available Themes:

  • autumn - Orange-focused color scheme
  • azure - Blue-focused color scheme
  • breeze - Light, airy color palette
  • fluent - Modern, translucent design
  • hacker - Green-focused color scheme

To switch themes and presets without manually editing configuration files, use the waymod script:

$HOME/.local/bin/waymod <preset> <theme>

Example Usage:

waymod bottom azure

This applies the bottom preset with the azure theme.

Notifications (Dunst)

HyprDots uses Dunst for notifications, a lightweight and highly customizable notification daemon. The configuration file is located at:

$HOME/.config/dunst/dunstrc

Key customization options:

  • Notification appearance (size, position, colors)
  • Behavior settings (timeout, actions, history)
  • Sound and display rules

Refer to the Dunst GitHub for detailed customization options.

System Info (Fastfetch)

HyprDots includes Fastfetch for system information retrieval, a fast and customizable system info tool. Customize its output, modules, and appearance by referring to the Fastfetch documentation.

Video Player (MPV)

MPV is included in HyprDots with an optimized configuration for modern Intel CPUs with Iris Xe Graphics. But will work flawlessly on most modern systems.

  • Default settings use Vulkan for better performance:
gpu-api=vulkan
  • Ensure Vulkan is installed and working. If your system does not support Vulkan, modify gpu-api to auto or opengl.
  • If u face any issues with mpv, try disabling custom shaders (Take a quick look at $HOME/.config/mpv/mpv.conf).
  • Further customization can be done by referring to the MPV manual.

Editor (Neovim)

HyprDots includes a pre-configured Neovim setup with a clean configuration and essential plugins.

  • Key features include syntax highlighting, file navigation, and code completion
  • Due to the complexity, refer to the Neovim documentation for customization

The configuration is modular and located in $HOME/.config/nvim/.

Rofi (Application Launcher)

HyprDots uses Rofi for multiple functions:

  • Application launcher (Super + Space)
  • Emoji selector (Super + I)
  • Calculator (Super + V)
  • Clipboard (Super + C)
  • WiFi menu (Super + W)
  • Power menu (Super + X)
  • Window switcher (Super Shift + W)

Three themes are available, each with distinct visual styles. Further customization can be done via the Rofi documentation.

Yazi (Terminal File Manager)

HyprDots includes Yazi, a highly customizable terminal file manager with modern features:

  • Fast navigation and file operations
  • Image previews in terminal
  • Customizable keybindings and appearance
  • Plugin support

Refer to the official Yazi documentation for additional configuration options.

Wallpaper Management

HyprDots includes scripts for wallpaper management, allowing easy changing and randomization of wallpapers from different categories. The main script is located at:

$HOME/.local/bin/random-wall

Use keybindings (defined in keybinds.conf) to quickly switch between wallpaper categories:

  • Super(Windows) + B - Set random wallpaper

Further Customization

For users who want to extend HyprDots further:

  1. Check the dotfiles repository for the latest updates
  2. Explore the scripts directory for utility scripts
  3. Review the keybindings guide for all available shortcuts
  4. Join the Hyprland community for tips and shared configurations

Clone this wiki locally