_{// design by t2}

  
 Install 
     
 Themes 
     
 Styles 
     
 Packages 
     
 Keybindings 
     
 Youtube 
     
 KnownIssues 
  

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.
Tested on:

• EndeavourOS
• Arco Linux
• Arch using ALCI - Arch Linux Calamares Installer

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

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

sudo pacman -Sy git
git clone --depth 1 https://github.com/devckvargas/hyprdots ~/Hyprdots
cd ~/Hyprdots/Scripts

Tip

Add apps you want to install (replace nvim with your own editor e.g. nano, vim, code, kate, etc..)

nvim ~/Hyprdots/Scripts/custom_apps.lst

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

 
 Top 
 

Theming

To create your own custom theme, please refer theming wiki

Available themes by default

• Catppuccin-Mocha
• Catppuccin-Latte
• Decay-Green
• Rosé-Pine
• Tokyo-Night
• Material-Sakura
• Graphite-Mono
• Cyberpunk-Edge

Contributors themes

• Frosted-Glass by T-Crypt
• Gruvbox-Retro by T-Crypt

Tip

You can also maintain/share/browse/install additional themes (for 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

Gruvbox-Retro

 
 Top 
 

Styles

Theme Select

Wallpaper Select

Launcher Style Select

Launcher Styles

Wlogout Menu

Game Launchers

 
 Top 
 

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

edge browser kitty terminal neofetch fetch tool dolphin kde file manager visual-studio-code-bin gui code editor nvim 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

 
 Top 
 

Keybindings

Keys	Action
Super + Q or Alt + F4	quit active/focused window
Super + L	lock screen
Ctrl + Shift + Escape	Open system monitor (btop)
Super + Backspace / X	logout menu
Super + Del	quit hyprland session (logout w/out confirmation)
Super + SPACE	toggle window on focus to float
Super + F	toggle window on focus to fullscreen (keep borders)
Super + Shift + F	toggle window on focus to fullscreen
Super + J	toggle layout
Super + P	toggle pseudotile
Super + G	toggle window group
Super + RETURN / Numpad ENTER	launch terminal (kitty)
Super + E	launch file explorer (dolphin)
Super + C	launch editor (vscode)
Super + B	launch browser (msedge)
Super + D	launch desktop applications (rofi)
Super + Tab	switch open applications (rofi)
Super + R	browse system files (rofi)
Super + period	browse emoji
fn + F9	mute audio output (toggle)
fn + F10 (hold)	decrease volume
fn + F11 (hold)	increase volume
Super + Ctrl + Alt + S	open spotify
Super + Ctrl + ↓ (hold)	decrease volume for spotify
Super + Ctrl + ↑ (hold)	increase volume for spotify
Super + V	clipboard history
Super + Shift + A	screenshot snip (rectangular select)
Super + Shift + S / PrintScreen	screenshot all screen
Super + Shift + W	screenshot active window
Super + Shift + D	screenshot focused monitor
Super + Shift + X	opens screenshot folder (HOME/Pictures)
Super + RightClick (drag)	resize the window
Super + LeftClick (drag)	change the window position
Super + MouseScroll / PageUp/PageDown	cycle through workspaces
Super + Shift + ←→↑↓ (hold)	resize windows
Super + [0-9]	switch to workspace [0-9] (Workspace 9 opens Spotify)
Super + backtick	switch to workspace [10] (opens Caprine)
Super + Ctrl + ←→	switch to relative workspaces
Super + Ctrl + ↓	switch to first empty workspace
Super + Ctrl + Alt + ←→	move active window between relative workspaces
Super + Shift + [0-9]	move active window to workspace [0-9]
Super + Shift + backtick / backquote	move active window to workspace [0]
Super + Shift + Ctrl + ←→↑↓	move active window around
Super + Alt + [0-9]	move active window to workspace silently [0-9] (cursor won't follow)
Super + Alt + backtick / backquote	move active window to workspace silently [0] (cursor won't follow)
Super + Ctrl + 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 + Alt + D	toggle (theme <//> wall) based colors
Super + Alt + T	theme select menu
Super + Alt + W	wallpaper select menu
Super + Alt + A	rofi style select menu
Super + Alt + PageDown/PageUp	turn on/off blue light filter

Playlist

youtube (Prasanth Rangan)

 
 Top 
 

Known Issues

• Few scaling issues with rofi configs, as they are created based on prasanthrangan's ultrawide (21:9) display.
• Random lockscreen crash, refer swaywm/sway#7046
• Waybar launching rofi breaks mouse input (added sleep 0.1 as workaround), refer Alexays/Waybar#1850
• Flatpak QT apps does not follow system theme