SYSTEM INITIALIZED
Event-Driven
Hyprland
Ecosystem
Vicious Viper is a modular Hyprland ecosystem engineered for laptop-first workflows. Dynamic Material You theming, automation-driven tooling, event-based scripting, and performance-oriented UX — designed for daily Arch Linux usage.
Automation Pipeline
Vicious Viper is designed around event-driven automation. Wallpaper changes, audio updates, workspace events, and system state transitions propagate through lightweight scripts and dynamic reload hooks.
Wallpaper Event
Wallpaper switch triggers automation pipeline.
Matugen
Extracts Material You palettes and generates templates.
Template Engine
Updates Waybar, Rofi, Mako, GTK and terminal themes.
Reload Hooks
Reloads components without restarting the session.
Live UI Sync
Entire desktop updates dynamically in real time.
Workflow-Oriented Design
More than aesthetic dotfiles — Vicious Viper focuses on operational workflows, dynamic theming, automation tooling, and low-friction keyboard-first UX.
Performance Tuned
Lightweight Waybar modules, efficient shell scripts, laptop-focused power management, and low idle overhead.
Dynamic Theming
Material You color extraction via Matugen with synchronized GTK, terminal, notifications, lockscreen and Waybar styling.
Automation Ecosystem
Custom scripts for wallpaper management, media downloads, Bluetooth workflows, notifications, and system automation.
Keyboard-Centric UX
ALT-based navigation model optimized for workspace switching, launchers, clipboard workflows, and rapid task execution.
Modular Installer
Dry-run validation, selective installs, timestamped backups, uninstall routines, and profile-aware deployment.
Multi-Environment Ready
Designed for laptops first, but validated for desktop usage, multi-monitor setups, NVIDIA systems, and Arch derivatives.
Runtime Performance
Real-world runtime characteristics collected from daily laptop usage.
780MB
Idle Session RAM
0.2%
Waybar CPU Usage
7.3s
Cold Boot Time
0.4s
Hyprland Startup
Measured on Lenovo IdeaPad Slim 5 · AMD Ryzen 5 · 16GB RAM · Arch Linux
Interactive Desktop Environment
Screenshots are contextualized with actual workflow capabilities, not just visual presentation.
Modular Deployment System
Vicious Viper ships with a profile-aware installation pipeline featuring dry-run validation, backup generation, selective module deployment, and rollback-safe configuration management.
Dry-Run Validation
Validate dependencies, packages, and system compatibility before modifying the environment.
Selective Installs
Deploy only the required modules including Waybar, Hyprland, Rofi, Neovim, notifications, and automation scripts.
Automatic Backups
Existing dotfiles are timestamped and preserved before deployment to ensure rollback safety.
Searchable Configuration Map
Treat the project like an ecosystem instead of a screenshot repository. Expose major configs and scripts directly.
No matching configs found
Common Questions
Does it work with NVIDIA GPUs?
Yes. Vicious Viper includes NVIDIA compatibility checks in its installer and provides pre-configured environment variables for Hyprland on proprietary drivers.
Can I use it without Hyprland?
No. The ecosystem is deeply integrated with Hyprland's event system. Some scripts and themes may work on other Wayland compositors, but the automation pipeline requires Hyprland.
Does it work on desktop or only laptops?
Both. The default profile is laptop-tuned, but the full profile and desktop profiles work on multi-monitor desktop setups including ultra-wide configurations.
How do I update installed modules?
Re-run ./install.sh --select to redeploy specific modules. Existing dotfiles are timestamped and backed up automatically before any override.
Can I contribute or fork?
Absolutely. The project is MIT licensed. Pull requests, issue reports, and forks are welcome. Check the GitHub repository for contribution guidelines.