🌟 Cachy Dots - CachyOS Configuration Files

A comprehensive collection of configuration files and dotfiles for a CachyOS-based Linux setup featuring Hyprland, themed terminals, and productivity tools.

📸 Preview

Add screenshots of your desktop setup here

🚀 Features

🎨 Desktop Environment

• Hyprland - Modern Wayland compositor with animations and effects
• HyDE (Hyprland Desktop Environment) - Pre-configured Hyprland setup
• Waybar - Highly customizable status bar
• Rofi - Application launcher and window switcher
• Swaylock - Screen locker
• Wlogout - Logout menu

🖥️ Terminal & Shell

• Fish Shell with CachyOS configuration
• Zsh with Oh My Zsh and Catppuccin theme
• Alacritty - GPU-accelerated terminal emulator
• Kitty - Feature-rich terminal emulator
• Ghostty - Fast terminal emulator
• Starship - Cross-shell prompt

🎵 Media & Entertainment

• MPV with modernx UI and advanced configuration
• Spicetify - Spotify theming
• VLC - Media player configuration

📊 System Monitoring

• btop - Resource monitor
• Fastfetch - System information tool

🎨 Themes & Aesthetics

• Catppuccin theme variants (Mocha, Frappe, Macchiato, Latte)
• Custom color schemes across applications
• Consistent theming for terminals, editors, and applications

📁 Directory Structure

├── .bashrc                 # Bash shell configuration
├── .zshrc                  # Zsh shell configuration with Oh My Zsh
├── .config/
│   ├── alacritty/         # Alacritty terminal configuration
│   ├── btop/              # System monitor configuration
│   ├── fastfetch/         # System info display
│   ├── fish/              # Fish shell configuration
│   ├── ghostty/           # Ghostty terminal configuration
│   ├── hyde/              # HyDE desktop environment
│   ├── hypr/              # Hyprland compositor configuration
│   ├── kitty/             # Kitty terminal configuration
│   ├── mpv/               # MPV media player configuration
│   ├── rofi/              # Application launcher configuration
│   ├── spicetify/         # Spotify theming
│   ├── starship/          # Cross-shell prompt configuration
│   ├── swaylock/          # Screen locker configuration
│   ├── vim/               # Vim configuration
│   ├── waybar/            # Status bar configuration
│   └── wlogout/           # Logout menu configuration
└── .oh-my-zsh/            # Oh My Zsh framework

🛠️ Installation

Prerequisites

Make sure you have the following packages installed on your CachyOS system:

# Core packages
sudo pacman -S hyprland waybar rofi swaylock wlogout

# Terminal emulators
sudo pacman -S alacritty kitty

# Shell and tools
sudo pacman -S fish zsh oh-my-zsh starship fastfetch btop

# Media players
sudo pacman -S mpv vlc

# Fonts (recommended)
sudo pacman -S ttf-fira-code ttf-jetbrains-mono noto-fonts-emoji

Quick Setup

1. Clone this repository:

   git clone https://github.com/yourusername/cachy-dots.git
   cd cachy-dots

2. Backup your existing configurations:

   mkdir -p ~/.config/backup
   cp -r ~/.config/* ~/.config/backup/ 2>/dev/null || true
   cp ~/.zshrc ~/.zshrc.backup 2>/dev/null || true
   cp ~/.bashrc ~/.bashrc.backup 2>/dev/null || true

3. Install the configurations:

   # Copy configuration files
   cp -r .config/* ~/.config/
   cp .zshrc ~/
   cp .bashrc ~/
   cp -r .oh-my-zsh ~/

4. Set up shell configurations:

   # Set Fish as default shell (optional)
   chsh -s /usr/bin/fish
   
   # Or set Zsh as default shell
   chsh -s /usr/bin/zsh

5. Install additional dependencies:

   # Install HyDE if not already installed
   yay -S hyde-git
   
   # Install additional AUR packages
   yay -S ghostty-bin

⚙️ Configuration

Hyprland

The Hyprland configuration is split across multiple files:

• hyprland.conf - Main configuration file
• keybindings.conf - Keyboard shortcuts
• windowrules.conf - Window management rules
• monitors.conf - Monitor setup
• userprefs.conf - Personal preferences

Terminal Themes

All terminals are configured with the Catppuccin theme:

• Fish: Uses CachyOS Fish configuration
• Zsh: Catppuccin theme with useful plugins
• Alacritty/Kitty: Consistent color schemes

Waybar

Multiple layout configurations available in waybar/layouts/ directory.

🎨 Customization

Changing Themes

1. Catppuccin Variants: Edit .zshrc and change CATPPUCCIN_FLAVOR
2. Hyprland Colors: Modify userprefs.conf
3. Terminal Colors: Update individual terminal config files

Adding Your Own Configurations

1. Fork this repository
2. Make your changes
3. Update this README with your modifications
4. Submit a pull request if you want to share improvements

🔧 Troubleshooting

Common Issues

Fonts not displaying correctly:

sudo pacman -S noto-fonts noto-fonts-emoji ttf-dejavu
fc-cache -fv

Waybar not starting:

# Check if all waybar dependencies are installed
waybar --config ~/.config/waybar/config.jsonc --style ~/.config/waybar/style.css

Hyprland crashes:

# Check logs
journalctl --user -u hyprland

📝 Notes

• Some configurations may require adjustment based on your specific hardware
• Monitor configurations in monitors.conf should be adjusted for your setup
• Webhook URLs and personal paths have been cleaned from the configurations
• Make sure to review and customize paths in configuration files

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test configurations
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• CachyOS - The amazing Linux distribution
• HyDE Project - Hyprland Desktop Environment
• Catppuccin - Beautiful color scheme
• Oh My Zsh - Zsh framework
• All the open-source projects that make this setup possible

🔗 Links

• CachyOS Documentation
• Hyprland Documentation
• Waybar Documentation

---

⚠️ Disclaimer: Always backup your existing configurations before applying these dotfiles. These configurations are tailored for a specific setup and may require adjustments for your system.