Arch Linux · Hyprland · Wayland

Vicious
Viper

A minimal, keyboard-driven Hyprland dotfiles setup for Arch Linux. Laptop-first. Script-heavy. Zero bloat.

Wayland
display protocol
Laptop-first
design focus
Scripts
custom automation
Open Source
MIT licensed

Software Stack

Every component is handpicked for speed, aesthetics, and keyboard-first operation.

Hyprland
Wayland compositor
🌼 compositor
Waybar
Status bar
✨ bar
Thunar
GUI File Manager
💦 file manager
Yazi
CLI File Manager
🗄️ tui manager
Rofi / Wofi
App launcher
🚀 launcher
Zen Browser
Web Browser
🌐 browser
Eza
Modern ls replacement
ls alternative
Custom Scripts
Wallpaper switcher, yt-dlp & more
🎬 automation

What's Included

More than just config files — a complete, opinionated workflow for daily Arch Linux use.

Keyboard-driven layout — Navigate workspaces and windows entirely without a mouse

Wallpaper switcher — Keyboard shortcut scripts to cycle wallpapers on the fly

yt-dlp integration — Download videos and audio from platforms via custom scripts

Laptop-optimized — Battery, brightness, and touchpad gestures tuned out of the box

Waybar config — Clean, minimal status bar with workspaces, clock, and system tray

Fd + Eza aliases — Fast, modern CLI utilities pre-configured with sensible defaults

GTK themes.themes directory included for consistent app theming

Works on desktops too — Primarily laptop-focused but desktop-compatible


Layout Preview

Screenshots from the Vicious Viper setup.

Hyprland workspace with Waybar and terminals
Yazi file manager in Wayland
Lock Screen
Login Manager
Neovim
Neovim Data Analysis Setup

Installation

Make sure to add the scripts folder to your PATH, otherwise the setup won't work as intended.

Clone the repository

$ git clone https://github.com/Cybersnake223/Hypr
$ cd Hypr

Copy config files

$ cp -r .config/* $HOME/.config

Install scripts & add to PATH

$ cp -r .local/bin/scripts $HOME/.local/bin
# Add to ~/.bashrc or ~/.zshrc:
$ export PATH="$HOME/.local/bin/scripts:$PATH"

Copy GTK themes (optional)

$ cp -r .themes $HOME/.themes