// Aesthetic, dynamic and minimal dots for Arch hyprland by YSL
ShellGPL-3.0
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 -
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)