caiges/hyprdots

// Aesthetic, dynamic and minimal dots for Arch hyprland

_{// design by t2}

  
 Install 
     
 Themes 
     
 Styles 
     
 Packages 
     
 Keybindings 
     
 Youtube 
     
 Wiki 
  

showcase_720p.mp4

wallbash_720p.mp4

 
 🡅 
 

Installation

The installation script is made for Arch, but may work on some Arch based distros with systemd. For Debian, please refer Senshi111's version here. Checkout Ksk's video for full installation walkthrough.

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. This script is also designed to be done after a minimal arch installation, using it on previously installed desktop should work but will change whatever you currently have (gtk/qt theming, shell, sddm, grub, etc) and is at your own risk.

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

pacman -Sy git
git clone --depth 1 https://github.com/prasanthrangan/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

Updating

To update Hyprdots you will need to pull the latest changes from github and restore the configs by doing -

cd ~/Hyprdots/Scripts
git pull
./install.sh -r

Important

This backs up and overwrites all configs as setup by restore_cfg.lst in ~/Hyprdots/Scripts. So please note that any configurations you made may be overwritten if listed to be done so, but can be recovered in ~/.config/cfg_backups.

 
 🡅 
 

Themes

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.

// Catppuccin-Mocha // Catppuccin-Latte // Decay-Green // Rosé-Pine // Tokyo-Night // Material-Sakura // Graphite-Mono // Cyberpunk-Edge // Frosted-Glass by T-crypt // Gruvbox-Retro by T-crypt

 
 🡅 
 

Styles

Theme Select

Wallpaper Select

Launcher Style Select

Launcher Styles

Wlogout Menu

Game Launchers

 
 🡅 
 

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
Alt + F4	quit active/focused window
Super + Del	quit hyprland session
Super + W	toggle window on focus to float
Alt + Enter	toggle window on focus to fullscreen
Super + J	toggle layout
Super + G	toggle window group
Super + T	launch kitty terminal
Super + E	launch dolphin file explorer
Super + C	launch vscode
Super + F	launch firefox
Super + A	launch desktop applications (rofi)
Super + Tab	switch open applications (rofi)
Super + R	browse system files (rofi)
F10	mute audio output (toggle)
F11	decrease volume (hold)
F12	increase volume (hold)
Super + V	clipboard history paste
Super + L	lock screen
Super + Backspace	logout menu
Super + K	switch keyboard layout
Super + P	drag to select area or click on a window to print
Super + Alt + P	print current screen
Super + Ctrl + P	print current screen (frozen)
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 + Alt + →	next wallpaper
Super + Alt + ←	previous wallpaper
Super + Alt + ↑	next waybar mode
Super + Alt + ↓	previous waybar mode
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

 
 🡅 
 

Youtube

p l a y l i s t