WehttamSnaps Hypr-Snaps: GitHub-ready modular Hyprland setup

WehttamSnaps Hypr-Snaps is a modular Hyprland-based setup tailored for WehttamSnaps branding. It’s designed for gaming, streaming, and a fast, responsive workflow on Arch Linux.

What’s included

Core Hyprland config (hyprland.conf) with modular pieces
Waybar config and neon cyberpunk styling
Clickable launcher icons for Steam, Lutris, MO2, and Vortex in Waybar
A rofi-based game launcher with a full icon set
Per-app workspace rules and an auto-assign startup helper
Audio routing templates (PipeWire + qpwgraph)
A ready-to-use “README-CUSTOMIZE.md” for quick branding tweaks
A CI workflow to validate the template structure on pushes

Repo structure (high level)

config/hypr/hyprland.conf.template
config/hypr/config.d/
- bar/ (Waybar config)
- launcher/ (launcher scripts)
- workspace/ (workspace rules, auto-assign)
- settings/ (ML4W-like, stub)
- workspace/ (per-app workspace rules)
- audio/ (audio routing scripts)
waybar/config and style.css
scripts/ (install.sh, build-final-config.sh)
assets/ (optional icons and themes)
docs/ (customization guide, notes)
README.md
README-CUSTOMIZE.md
CONTRIBUTING.md
LICENSE

Getting started

Prerequisites: Arch Linux, NVIDIA RTX 1650 (can swap to RX580 later)
Install: clone this repo, copy templates to your Arch install, customize paths, and run the build script
Build final Hyprland config and reload Hyprland

Contributing

Fork the repository and create feature branches (e.g., feature/bar, feature/launcher, feature/workspace)
Open a pull request to merge into main
Ensure scripts pass shellcheck, and templates remain modular and well-documented
See CONTRIBUTING.md for more details

License

MIT license. See LICENSE in the repo.

Project governance

This is a community-oriented starter template. You’re encouraged to adapt, extend, and share improvements.

Customization quick-start

Edit Waybar’s style.css for color tweaks (cyberpunk violet-to-cyan gradient)
Add or modify launcher scripts under config/hypr/config.d/launcher
Update per-app workspaces in config/hypr/config.d/workspace/workspace-assignments.conf
Rebuild final config with: bash config/hypr/build-final-config.sh
Start Hyprland (log out/in or restart Hyprland)

Description

This is my daily driver configuration that I use on both my laptop and desktop for coding, gaming, trading, browsing the web, etc., with Dvorak in mind. I am constantly adding new features and improvements.

I use Arch BTW.. :)

Feel free to open an issue ♡ (anything you can think of)!

Discord

New official Discord server.

See Wiki

The README as an organized WIKI

Design Philosophy

Enhanced productivity
Faster responsiveness
Smooth animations
Vibrant color schemes
It just works

Features

Dynamic wallpapers based on workspaces: Custom scripts & Hyprpaper
Dynamic color schemes based on current wallpaper: Custom scripts & PyWal
Global Theme switcher (Light/Dark): Custom scripts
Ags V2 widgets ~~(Eww replaced)~~: these are just some of the features
- Color scheme based on current wallpaper
- Main bar
  - Dark/light modes
  - Bandwidth speed monitor
- Application launcher ~~(Rofi replaced)~~
  - App launcher
  - Emojis
  - Arithmetics
  - Url forwarding to default browser
  - custom commands
- Wallpaper switcher for each workspace
- Media player
- Right Panel
  - Waifu display -- using Danbooru and Gelbooru APIs
  - Media Player
  - Notification history - filter
  - Calendar
- Left Panel
  - Chat Bot -- multiple APIs + image generation
  - Booru Viewer -- using Danbooru and Gelbooru APIs
- Hyprland Settings widget
- User Panel (logout etc...)
High-quality wallpapers from Danbooru, Yandere, and Gelbooru

Current Workflow

Important: Screenshots below ⊽

W1	W2	W3	W4	W5	W6	W7	W8	W9	W10
---	Browser	---	Spotify	Btop	Discord	Steam/Lutris	---	---	Games

Wid: Workspace with corresponding ID.
---: Placeholder, any app can go here.
name: Application that opens automatically in its designated workspace.

To-Do List

Users: Any suggestions or issues?
AGS V2 bundling
AGS V2: GTK-3 --> GTK-4
Make sure the dot-files work for every machine not just mine (WIP)
Add tutorials for each part of the dot-files (WIP)
Continuous improvements and polishing (INDEFINITELY)

KeyBinds

KeyBinds are displayed and organized Here, be sure to check them out!

Installation and Update

Required Dependencies and packages

Arch Linux (I use Arch linux BTW)
Hyprland
Necessary packages (do not worry they will be installed automatically)

Installation Guide

Run this one liner in the terminal -- Say Yes to everything

bash -c "$(curl -fsSL https://raw.githubusercontent.com/Crowdrocker/Snaps-ArchEclipse/refs/heads/master/.config/hypr/maintenance/INSTALL.sh)"

Update Guide

To update the config and its related pkgs Simply run update in the terminal

update

Tips

User Icon is stored in $HOME/.face.icon
Press SUPER + w to select the wallpaper you like
Custom wallpapers should be added in $HOME/.config/wallpapers/custom
Custom hyprland configuration should be put in $HOME/.config/hypr/configs/custom
Most functionalities have associated keybinds. Check them out!

Important: If you encounter any problems, no matter how small, please feel free to open an issue. I’m happy to help! :)

Additional Notes

Machines with batteries (aka: laptops) require upower to be installed for battery monitoring to work properly.

Star History

Visuals

Application Launcher

Apps	Emojis	Arithmetics	URLs

Right Panel

You can customize the widget layout however you want!

Example Layout	Example Layout

Left Panel

Chat Bot	Booru Viewer

Media Player

Wallpaper Switcher

Theme Switching

Dark Theme + Custom colors based on wallpaper	Light Theme + Custom colors based on wallpaper

User Panel

Tutorials

App launcher

> [name] : Custom Apps
emoji [name] : emojis
translate [text] > fr|en|es|jp... : translate text into other languages
[...1+2...] : arithmetics (maths)
[link] : open the link in browser