🎵 Symphony 2.0 - Coming Soon

Want to help make it happen faster? Contribute to the project! • Check the TODO • Create an issue if you spot any problems

---

Showcase

matugen.mp4

rofi.mp4

wall_switcher.mp4

Features

• Matugen theming — Automatic color scheme generation from wallpapers
• Modular configuration — Clean, organized, and easy to customize
• Complete development environment — Hyprland, Neovim, Tmux, and essential tools
• Comprehensive tooling — Waybar, Rofi, Swaync, Wlogout, Hyprlock
• GNU Stow — Efficient dotfile management
• Dual-mode system — Vibe mode for aesthetics, Focus mode for distraction-free work
• Wallpaper collection — My favourite Wallpapers Collection

---

Dual Mode System

This setup adapts to your workflow with two distinct modes:

Vibe Mode

Visual-first experience with animations, borders, and transparency for a polished aesthetic.

Focus Mode

Minimal, distraction-free environment:

• Animations disabled completely
• Borders reduced to minimal thickness
• Transparency removed by default
• Toggle transparency on demand: Super + Backspace

Perfect for deep work sessions where performance and focus take priority over visuals.

Switch modes: Super + Ctrl + Backspace

---

Components

Rofi Menus

Emoji Picker

Clipboard Manager

Wallpaper Selector

Power Profile Manager

Notification Center (Swaync)

Neovim & Tmux

Music (RMPC)

Wlogout

Hyprlock

---

Installation

Before Installation

⚠️ Important: GNU Stow will not work if configuration directories or files already exist.

Backup and remove existing configurations:

# Backup existing configs (recommended)
mv ~/.config/hypr ~/.config/hypr.bak
mv ~/.config/nvim ~/.config/nvim.bak
mv ~/.config/tmux ~/.config/tmux.bak
mv ~/.config/waybar ~/.config/waybar.bak
mv ~/.config/rofi ~/.config/rofi.bak
mv ~/.config/kitty ~/.config/kitty.bak
mv ~/.config/fish ~/.config/fish.bak
mv ~/.config/swaync ~/.config/swaync.bak

# Or remove directly (use with caution)
rm -rf ~/.config/hypr ~/.config/nvim ~/.config/tmux

Prerequisites

# Core dependencies
sudo pacman -S stow git base-devel

# Hyprland & Wayland
sudo pacman -S hyprland xdg-desktop-portal-hyprland

# System utilities
sudo pacman -S waybar rofi swaync swww hypridle hyprlock wlogout
sudo pacman -S polkit-gnome cliphist wl-clipboard 

# Terminal & Shell
sudo pacman -S kitty alacritty fish starship tmux

# Development
sudo pacman -S neovim lazygit btop yazi

# Audio & Media
sudo pacman -S pipewire wireplumber pavucontrol mpd mpc ncmpcpp mpv-mpris mpd-mpris

# Theming
sudo pacman -S matugen pywalfox

# Additional tools
sudo pacman -S fastfetch jq fd ripgrep fzf swayosd

Clone & Install

# Clone the repository
git clone https://github.com/vyrx-dev/dotfiles.git ~/dotfiles

# Navigate to the directory
cd ~/dotfiles

# Create symlinks using GNU Stow
stow .

💡 Tip: Grab wallpapers from here for automatic theming.

Post-Installation

After running stow ., all configuration files will be symlinked to their appropriate locations in ~/.config/.

If you want to uninstall:

cd ~/dotfiles
stow -D .

---

Tools Included

Tool	Description
Hyprland	Dynamic tiling Wayland compositor
Waybar	Highly customizable status bar
Rofi	Application launcher and menu system
Swaync	Notification daemon with control center
Kitty	GPU-accelerated terminal emulator
Alacritty	Fast, cross-platform terminal emulator
Neovim	Hyperextensible Vim-based text editor
Tmux	Terminal multiplexer
Fish	Smart and user-friendly shell
Starship	Minimal, fast, and customizable prompt
Lazygit	Simple terminal UI for git commands
Matugen	Material Design color scheme generator
RMPC	Rusty Music Player Client for MPD

---

Keyboard Shortcuts

Applications

Keybind	Action
Super + Return	Terminal (Kitty)
Super + B	Browser
Super + E	File Manager (Nautilus)
Super + M	Music (Spotify)
Super + D	Discord
Super + O	Obsidian
Super + C	VS Code

Rofi Menus

Keybind	Action
Super + Space	Application Launcher
Alt + ,	Clipboard Manager
Alt + .	Emoji Picker
Super + Ctrl + B	Power Profiles
Super + Ctrl + Space	Theme Selector (Matugen)
Super + Alt + Space	Wallpaper Picker

Window Management

Keybind	Action
Super + Q	Close Window
Super + K	Kill Application
Super + Shift + O	Pop Window (Float & Pin)

System

Keybind	Action
Super + L	Lock Screen (Hyprlock)
Super + Escape	Wlogout Menu
Super + N	Notification Center
Alt + /	System Monitor (btop)
Super + Backspace	Toggle Terminal Transparency
Super + Ctrl + Backspace	Toggle Focus/Vibe Mode

Screenshots & Recording

Keybind	Action
Super + P	Screenshot Region
Super + R	Screen Record (System Audio)
Super + Alt + R	Screen Record (System + Mic)
Super + Shift + P	Color Picker

Tmux Sessions

Keybind	Action
Super + Shift + Return	Attach Tmux Session
Super + Alt + Return	New Tmux Session

For complete keybindings, see .config/hypr/bindings.conf

---

Configuration Structure

.config/
├── hypr/           # Hyprland configuration
├── waybar/         # Status bar
├── rofi/           # Launchers and menus
├── swaync/         # Notification center
├── kitty/          # Terminal (Kitty)
├── alacritty/      # Terminal (Alacritty)
├── nvim/           # Neovim configuration
├── tmux/           # Tmux configuration
├── fish/           # Fish shell
├── matugen/        # Theme generator
└── starship.toml   # Shell prompt

---

If you found this useful, consider giving it a ⭐

Made with ❤️ for the Linux community