mine-hyprdots/2.md
2025-04-06 12:08:08 +05:30

4 KiB

<h1 align="center">Hyprdots - Aesthetic Dotfiles for Hyprland</h1>

<p align="center">
  <img src="https://img.shields.io/github/stars/prateekarya/hyprdots?style=for-the-badge" alt="Stars">
  <img src="https://img.shields.io/github/forks/prateekarya/hyprdots?style=for-the-badge" alt="Forks">
  <img src="https://img.shields.io/github/issues/prateekarya/hyprdots?style=for-the-badge" alt="Issues">
  <img src="https://img.shields.io/github/license/prateekarya/hyprdots?style=for-the-badge" alt="License">
  <img src="https://img.shields.io/github/last-commit/prateekarya/hyprdots?style=for-the-badge" alt="Last Commit">
</p>

<p align="center">
  <strong>A beautiful, functional Hyprland configuration with carefully curated tools and utilities</strong>
</p>

![Screenshot Gallery](Assets/main.png)
_Screenshots: [Main Desktop](Assets/main.png) | [Power Menu](Assets/powermenu.png) | [System Monitoring](Assets/btop.png) | [Development Environment](Assets/go.png)_

## ✨ Features

- **Hyprland** tiling window manager with smooth animations
- **Minimalist** yet functional aesthetic
- **Performance-optimized** configuration
- **Complete ecosystem** of CLI/TUI/GUI tools
- **Easy customization** with well-organized dotfiles

## 🖥️ System Overview

| Category        | Components                                           |
| --------------- | ---------------------------------------------------- |
| **OS**          | Arch Linux (btrfs filesystem)                        |
| **Boot Loader** | GRUB                                                 |
| **Display**     | SDDM (Login Manager) + Hyprland (Wayland Compositor) |
| **Audio**       | PipeWire with PulseAudio compatibility               |
| **Fonts**       | JetBrains Mono Nerd Font (with icons support)        |

## 🛠️ Installation

1. **Prerequisites**:

   - Arch Linux (or derivative) installed
   - Base development tools installed
   - Git installed

2. **Clone the repository**:
   ```bash
   git clone https://github.com/prateekarya/hyprdots.git ~/.dotfiles
   ```
  1. Install dependencies:

    cd ~/.dotfiles
    ./install.sh
    
  2. Post-installation:

    • Configure SDDM to use Hyprland session
    • Reboot your system

🎨 Customization

Wallpapers

Download additional wallpapers from the Wallpaper Collection

Keybindings

Modify ~/.config/hypr/hyprland.conf for window manager keybindings

Theme

Edit ~/.config/waybar/style.css for status bar customization

🧩 Component Breakdown

GUI Environment

Component Purpose Alternative
Hyprland Window Manager Sway
Waybar Status Bar Polybar
Rofi Application Launcher Wofi, dmenu
Thunar File Manager Nautilus, PCManFM
Firefox Web Browser Chromium

CLI Tools

Command Replacement Purpose
ls eza Better file listing
cd zoxide Smarter directory navigation
cat bat Syntax highlighting
find fd Faster file searching
grep rg Faster text searching

System Management

  • Network: NetworkManager + iwd
  • Bluetooth: Bluez + bluetuith (TUI)
  • Power: acpi, tlp, auto-cpufreq
  • Media: playerctl, mpv, cava (audio visualizer)

💡 Tips & Tricks

  1. Quick Launch: Super + Space opens application launcher
  2. Screenshots: Super + Shift + S for area selection
  3. Window Management: Use Super + W to close windows
  4. Terminal: Super + T opens Kitty terminal

🤝 Contributing

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Submit a pull request

📜 License

MIT License - See LICENSE for details