125 lines
4 KiB
Markdown
125 lines
4 KiB
Markdown
|
````markdown
|
||
|
|
<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>
|
||
|
|
|
||
|
|
|
||
|
|
_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
|
||
|
|
```
|
||
|
|
````
|
||
|
|
|
||
|
|
3. **Install dependencies**:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd ~/.dotfiles
|
||
|
|
./install.sh
|
||
|
|
```
|
||
|
|
|
||
|
|
4. **Post-installation**:
|
||
|
|
- Configure SDDM to use Hyprland session
|
||
|
|
- Reboot your system
|
||
|
|
|
||
|
|
## 🎨 Customization
|
||
|
|
|
||
|
|
### Wallpapers
|
||
|
|
|
||
|
|
Download additional wallpapers from the [Wallpaper Collection](https://drive.google.com/drive/folders/1Eog40yvrTshjDLVIETVncBKcDsvPLMIX?usp=sharing)
|
||
|
|
|
||
|
|
### 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](LICENSE) for details
|
||
|
|
|
||
|
|
---
|