--// Hyprdots //--

My Arch Hyprland Config

showcase_720p.mp4

Installation

The installation script is made for Arch, but may work on some Arch based distros.
For Debian, please refer Senshi111's version here.

Warning

Install script will auto-detect nvidia card and install nvidia-dkms drivers for your kernel.
Nvidia drm will be enabled in grub, so please ensure your nvidia card supports dkms drivers/hyprland.

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

pacman -Sy git
git clone https://github.com/prasanthrangan/hyprdots ~/Hyprdots
cd ~/Hyprdots/Scripts
./install.sh

Note

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.md

Theming

To add your own custom theme, please refer theming.md

• Available themes

  • Catppuccin-Mocha
  • Catppuccin-Latte
  • Decay-Green
  • Rosé-Pine
  • Tokyo-Night
  • Material-Sakura
  • Graphite-Mono
  • Cyberpunk-Edge
  • Gruvbox-Retro (maybe later)
  • Nordic-Blue (maybe later)

• Contributors themes

  • Frosted-Glass by T-Crypt

Catppuccin-Mocha

Catppuccin-Latte

Decay-Green

Rosé-Pine

Tokyo-Night

Material-Sakura

Graphite-Mono

Cyberpunk-Edge

Frosted-Glass

Styles

Theme Select

Wallpaper Select

Launcher Style Select

Launcher Styles

Wlogout Menu

Game Launchers

Packages

nvidia
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
nvidia-utils	nvidia drivers (script will auto detect from lspci -k

tools
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
brightnessctl	brightness control for laptop

login
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

hypr
hyprland-git	main window manager (script will change this to 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
swayidle	idle management daemon
wlogout	logout screen
grim	screenshot tool
slurp	selects region for screenshot/screenshare
swappy	screenshot editor
cliphist	clipboard manager

dependencies
polkit-kde-agent	authentication agent
xdg-desktop-portal-hyprland-git	XDG Desktop Portal
imagemagick	for kitty/neofetch image processing
qt5-imageformats	for dolphin thumbnails
pavucontrol	audio settings gui
pamixer	for waybar audio

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

applications
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

shell
zsh	main shell
exa	colorful file lister
oh-my-zsh-git	for zsh plugins
zsh-theme-powerlevel10k-git	theme for zsh
zsh-syntax-highlighting-git	highlighting of commands
zsh-autosuggestions-git	see completion as you type
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
Alt + 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 + Ctrl + ↓	decrease volume for spotify (hold)
Super + Ctrl + ↑	increase volume for spotify (hold)
Super + V	clipboard history paste
Super + L	lock screen
Super + Backspace	logout menu
Super + P	screenshot snip
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 + [0-9]	switch to workspace [0-9]
Super + Shift + [0-9]	move active window to workspace [0-9]
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

Playlist

youtube

Known Issues

• Few scaling issues with rofi configs, as they are created based on my 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