Hyprland + Arch · Dotfiles

A cozy, keyboard-centric environment built on Arch Linux and Hyprland. Tweaked for speed, simple customization, and a clean visual style.
View configuration details »

Preview · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Features
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact

About The Project

These are personal configuration files for an Arch Linux desktop powered by Hyprland.
The setup focuses on a lightweight workflow with fast terminal access, smooth animations, and a clean Wayland environment.

The core stack:

Component	Package	Install
Terminal	Kitty	pacman -S kitty
Shell	Zsh + oh-my-zsh	pacman -S zsh and install ohmyzsh
WM / Compositor	Hyprland	pacman -S hyprland
Status Bar	Waybar	pacman -S waybar
Editor	Zed	pacman -S zed
File Manager	Dolphin	pacman -S dolphin
System Info	fastfetch	pacman -S fastfetch
Action Menu	nwg-bar	pacman -S nwg-bar
Launcher	Walker + Elephant	yay -S walker dolphinAUR

(back to top)

Features

• Fully modular Hyprland configuration (hypr/conf/*)
• GTK + Kvantum theming with Catppuccin influence
• Waybar modules for workspaces, temperature, network, music, notifications, and GPU/CPU usage
• Kitty + Zsh with theme support
• Cava visualizer integrations
• Dolphin + KDE integration details for file handling

(back to top)

Getting Started

Clone the repository, then selectively copy only what you want into ~/.config/. No scripts are included here—manual placement is encouraged so you maintain awareness of changes.

Prerequisites

• Arch Linux or derivative
• Working Wayland setup
• GPU compatible with Hyprland
• Git

Installation

Clone the dotfiles and copy the .config contents into your home config directory:

git clone https://github.com/boomboompower/dotfiles
cd dotfiles
cp -r .config/* ~/.config/

Usage

Configurations live at:

~/.config/

Highlights:

• hypr/ holds compositor logic: rules, animations, monitors, and autostart programs. Individual files separate concerns such as appearance, inputs, gestures, layouts, workspace logic, plugins, and window rules.
• waybar/ provides status bar configuration, including two bar layouts (bars/), theme styles, icons, and JSONC modules for CPU, GPU, weather, clipboard, workspaces, and more.
• kitty/ stores terminal settings and Catppuccin-based themes.
• zed/ contains editor preferences and themes for consistent syntax highlighting.
• cava/ includes audio visualizer configurations, themes, and a shader collection for various waveform aesthetics.
• mako/ configures notification behavior to keep popups minimal.
• fastfetch/ offers a themed system info layout.
• dolphin/ + KDE config files store file-manager tweaks and MIME integration.
• Kvantum/ supports themed Qt styling to help GTK/Qt match visually.
• elephant/ holds desktop application metadata.

Some extra texture:

Cava’s fragment shaders in cava/shaders/ let the visualizer speak in different dialects: from classic spectrograms to “eye of phi” wisdom. Spicetify themes roam freely like butterflies of CSS. Waybar feels more like a small instrument toolbox, each JSONC module a quiet gear.

(back to top)

Roadmap

• Migrate away from nm-applet when upstream nmgui PR is merged
• Rework Waybar themes for deeper aesthetic cohesion
• Create an script which helps automate installation (asks about what themes to apply and does so modularly)

(back to top)

Contributing

This setup reflects personal preferences, but anyone is welcome to explore, adapt, or fork it for experimentation. Contributions, suggestions, or questions are always appreciated.

(back to top)

License

No license, feel free to use as you please

Wallpaper: from here - Takayama, Japan

(back to top)

Contact

boomboompower · https://github.com/boomboompower

(back to top)