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