yashlakhtariya/ysl-hyprdots

// Aesthetic, dynamic and minimal dots for Arch hyprland by YSL

Short video previews - latest version (v3)

Version v1

Version v2

Note : You need to manually set soft links for nwg-dock and nwg-drawer css in the config folder for light/dark themes. And some env variables, preferences are set as per personal needs so modify accordingly.

Installation

This configuration is based on the original repo from which it is forked, but contains some personal configurations and tweaks made by me like :

• Bug fixes for Aylur GTK shell, ensuring smooth quick settings.
• A custom dock (nwg) crafted with CSS, offering both light and dark theme support.
• A custom app drawer (nwg) also styled with CSS.
• Performance optimization flags for NVIDIA Optimus users.
• Custom wallpapers added for Catppuccin themes
• Compatibility fixes for older Xwayland applications.
• DIY wallpapers and thematic tweaks.
• Tearing fixes for Electron-based applications.
• An automated screen magnification algorithm (since Hyprland doesn't offer this natively).
• A preconfigured Fish shell with theming support (both native and using Starship) and auto-completions.
• Convenient preconfigured touchpad gestures using dotool daemon and hyprland CLI utility.

And more...

The installation script is made for Arch, but may work on some Arch based distros with systemd. (Tested on Garuda Linux)

Important

Install script will auto-detect nvidia card and install nvidia-dkms drivers for your kernel. So please ensure that your Nvidia card supports dkms drivers and hyprland.

Caution

The script modifies your grub config to enable Nvidia drm and theme. NOTE : Don't forget to remove VS Code login for sync, as this resets vscode configuration. After installation, login and sync with your remote data again.

After minimal Arch install (with grub and systemd), clone and execute -

pacman -Sy git
git clone --depth 1 https://github.com/yashlakhtariya/ysl-hyprdots ~/Hyprdots
cd ~/Hyprdots/Scripts
./install.sh

Tip

You can also create your own list (for ex. custom_apps.lst) with all your favorite apps and pass the file as a parameter to install it -

./install.sh custom_apps.lst

Please reboot after the install script completes and takes you to sddm login screen (or black screen) for the first time. For more details, please refer installation wiki

Themes

Modified by YSL : Catppuccin Latte, Catppuccin Mocha (rest same)

To create your own custom theme, please refer theming wiki

Tip

You can install/browse/create/maintain/share additional themes (ex. Synth-Wave) using themepatcher. For more details please refer themepatcher wiki. For more details please refer themepatcher wiki.

Packages

n v i d i a

linux-headers for main kernel (script will auto detect from /usr/lib/modules/) linux-zen-headers for zen kernel (script will auto detect from /usr/lib/modules/) linux-lts-headers for lts kernel (script will auto detect from /usr/lib/modules/) nvidia-dkms nvidia drivers (script will auto detect from lspci -k | grep -A 2 -E "(VGA|3D)") nvidia-utils nvidia utils (script will auto detect from lspci -k | grep -A 2 -E "(VGA|3D)")

u t i l s

pipewire audio and video server pipewire-alsa for audio pipewire-audio for audio pipewire-jack for audio pipewire-pulse for audio gst-plugin-pipewire for audio wireplumber audio and video server networkmanager network manager network-manager-applet nm tray bluez for bluetooth bluez-utils for bluetooth blueman bt tray

l o g i n

sddm-git display manager for login qt5-wayland for QT wayland XDP qt6-wayland for QT wayland XDP qt5-quickcontrols for sddm theme qt5-quickcontrols2 for sddm theme qt5-graphicaleffects for sddm theme

h y p r

hyprland-git main window manager (hyprland-nvidia-git if nvidia card is detected) dunst graphical notification daemon rofi-lbonn-wayland-git app launcher waybar-hyprland-git status bar swww wallpaper app swaylock-effects-git lockscreen wlogout logout screen grimblast-git screenshot tool slurp selects region for screenshot/screenshare swappy screenshot editor cliphist clipboard manager

d e p e n d e n c y

polkit-kde-agent authentication agent xdg-desktop-portal-hyprland XDG Desktop Portal pacman-contrib for system update check python-pyamdgpuinfo for amd gpu info parallel for parallel processing jq to read json imagemagick for image processing qt5-imageformats for dolphin image thumbnails ffmpegthumbs for dolphin video thumbnails kde-cli-tools for dolphin open with option brightnessctl brightness control for laptop pavucontrol audio settings gui pamixer for waybar audio

t h e m e

nwg-look theming GTK apps kvantum theming QT apps qt5ct theming QT5 apps

a p p s

firefox browser kitty terminal neofetch fetch tool dolphin kde file manager visual-studio-code-bin gui code editor vim text editor ark kde file archiver

s h e l l

zsh main shell eza colorful file lister oh-my-zsh-git for zsh plugins zsh-theme-powerlevel10k-git theme for zsh pokemon-colorscripts-git display pokemon sprites

Keybindings

Keys	Action
Super + Q	quit active/focused window
Super + Del	quit hyprland session
Super + W	toggle window on focus to float
Super + Enter	toggle window on focus to fullscreen
Super + G	toggle window group
Super + X	launch kitty terminal
Super + E	launch dolphin file explorer
Super + C	launch vscode
Super + Space	launch browser (default profile) (set manually in keybindings.conf)
Super + /	launch browser (tmp profile) (set manually in keybindings.conf)
Super + A	launch desktop applications (rofi)
Super + Tab	switch open applications (rofi)
Super + R	browse system files (rofi)
Super + F10	mute audio output (toggle)
Super + F11	decrease volume (hold)
Super + F12	increase volume (hold)
Super + V	clipboard history paste
Super + L	lock screen
Super + Backspace	logout menu
Super + K	transparency and blur ON for all windows
Super + Alt + K	transparency and blur OFF for all windows
Super + P	drag to select area or click on a window to print
Super + Alt + P	print current screen
Super + RightClick	resize the window
Super + LeftClick	change the window position
Super + MouseScroll	cycle through workspaces
Super + Shift + ←→↑↓	resize windows (hold)
Super + Shift + Ctrl + ←→↑↓	move active window within the current workspace
Super + [0-9]	switch to workspace [0-9]
Super + Shift + [0-9]	move active window to workspace [0-9]
Super + Alt + [0-9]	move active window to workspace [0-9] (silently)
Super + Alt + S	move window to special workspace
Super + S	toogle to special workspace
Super + Alt + G	disable hypr effects for gamemode
Super + Shift + D	toggle (theme <//> wall) based colors
Super + Shift + T	theme select menu
Super + Shift + W	wallpaper select menu
Super + Shift + A	rofi style select menu

For queries/feedback contact me : yashlakhtariya1010@outlook.com