{"id":31557375,"url":"https://github.com/koompi/koompi-hyperland-conf","last_synced_at":"2026-06-29T21:31:16.644Z","repository":{"id":313142771,"uuid":"1049834000","full_name":"koompi/koompi-hyperland-conf","owner":"koompi","description":"koompi hyperland config","archived":false,"fork":false,"pushed_at":"2025-09-06T00:38:18.000Z","size":1404,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-04T23:58:50.479Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/koompi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-03T15:03:04.000Z","updated_at":"2025-09-30T14:15:41.000Z","dependencies_parsed_at":"2025-10-08T23:31:00.596Z","dependency_job_id":null,"html_url":"https://github.com/koompi/koompi-hyperland-conf","commit_stats":null,"previous_names":["koompi/koompi-hypr","koompi/koompi-hyperland-conf"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/koompi/koompi-hyperland-conf","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koompi%2Fkoompi-hyperland-conf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koompi%2Fkoompi-hyperland-conf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koompi%2Fkoompi-hyperland-conf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koompi%2Fkoompi-hyperland-conf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/koompi","download_url":"https://codeload.github.com/koompi/koompi-hyperland-conf/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koompi%2Fkoompi-hyperland-conf/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34944146,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-29T02:00:05.398Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-04T23:58:22.522Z","updated_at":"2026-06-29T21:31:16.638Z","avatar_url":"https://github.com/koompi.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 KOOMPI Hyprland Desktop Environment\n\nA modern, elegant Hyprland configuration optimized for productivity and aesthetics. Features a beautiful Waybar with rainbow animations, compact macOS-style spacing, and comprehensive system monitoring.\n\n![Preview](https://img.shields.io/badge/Hyprland-Modern-blue?style=for-the-badge\u0026logo=wayland)\n![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)\n![Wayland](https://img.shields.io/badge/Wayland-Ready-purple?style=for-the-badge)\n\n## ✨ Features\n\n- **🌈 Rainbow Border Animation** - Matching Hyprland window borders\n- **📊 System Monitoring** - CPU, Memory, Temperature, Battery with colorful indicators  \n- **🎨 Glass Morphism UI** - Modern transparent design with subtle effects\n- **⚡ Performance Optimized** - Smooth animations for Intel Xeon + NVIDIA Quadro\n- **🔧 Professional Workflow** - Vim-style keybindings and workspace management\n- **📱 macOS-Style Compact Layout** - Clean, space-efficient design\n\n## 🖥️ Waybar\n\n```\n┌─────────────────────────────────────────────────────────────────────────────────────────────┐\n│  🏠  Workspace  Window Title     🕐 Time     📊 CPU 󰍛 RAM 🌡️ Temp 󰃞 BRI 󰕾 VOL 󰂯 📶 🔋 ⏻   │\n└─────────────────────────────────────────────────────────────────────────────────────────────┘\n```\n\n## 🎯 Requirements\n\n### System Requirements\n- **GPU**: Any modern GPU with OpenGL support (Intel integrated, NVIDIA, AMD)\n- **RAM**: 2GB minimum, 4GB recommended for smooth experience\n- **CPU**: Any modern x86_64 processor (Intel/AMD from ~2010+)\n- **Display**: Any resolution (1080p to 4K+, single or multi-monitor)\n- **OS**: Linux distribution with Wayland support\n\n**Note**: Hyprland is lightweight and runs well on older hardware. This configuration is optimized for performance across low to high-end systems.\n\n### Supported Distributions\n- ✅ **Arch Linux** (and derivatives: Manjaro, EndeavourOS, ArcoLinux)\n- ✅ **Debian** (and derivatives: Ubuntu, Pop!_OS, Linux Mint)\n- ✅ **Fedora** (and derivatives: Nobara, Silverblue)\n- ✅ **openSUSE** (Tumbleweed, Leap)\n- ✅ **Void Linux**\n- ✅ **Gentoo**\n\n## 🚀 One-Line Installation\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/koompi/koompi-hypr/main/install.sh | bash\n```\n\nOr download and run manually:\n```bash\ngit clone https://github.com/koompi/koompi-hypr.git\ncd koompi-hypr\nchmod +x install.sh\n./install.sh\n```\n\n## 📋 Manual Installation\n\n### 1. Install Dependencies\n\n#### Arch Linux\n```bash\nsudo pacman -S hyprland waybar dunst hyprpaper kitty thunar firefox rofi wofi \\\n               polkit-gnome xdg-desktop-portal-hyprland qt5-wayland qt6-wayland \\\n               wl-clipboard cliphist grim slurp grimblast brightnessctl pamixer \\\n               pavucontrol networkmanager bluez bluez-utils\n```\n\n#### Debian/Ubuntu\n```bash\nsudo apt update\nsudo apt install hyprland waybar dunst hyprpaper kitty thunar firefox-esr \\\n                 rofi polkit-gnome xdg-desktop-portal-wlr qtwayland5 \\\n                 wl-clipboard grim slurp brightnessctl pulseaudio-utils \\\n                 pavucontrol network-manager bluez\n```\n\n#### Fedora\n```bash\nsudo dnf install hyprland waybar dunst hyprpaper kitty thunar firefox \\\n                 rofi polkit-gnome xdg-desktop-portal-hyprland qt5-qtwayland \\\n                 qt6-qtwayland wl-clipboard grim slurp brightnessctl \\\n                 pulseaudio-utils pavucontrol NetworkManager bluez\n```\n\n### 2. Install Configuration\n\n```bash\n# Backup existing config (if any)\n[ -d ~/.config/hypr ] \u0026\u0026 mv ~/.config/hypr ~/.config/hypr.backup.$(date +%s)\n\n# Clone and install\ngit clone https://github.com/koompi/koompi-hypr.git ~/koompi-hypr\ncp -r ~/koompi-hypr/.config/hypr ~/.config/\ncp -r ~/koompi-hypr/.config/waybar ~/.config/\n\n# Set permissions\nchmod +x ~/.config/hypr/scripts/*.sh\nchmod +x ~/.config/waybar/scripts/*.sh\n```\n\n### 3. Start Hyprland\n\nFrom TTY:\n```bash\nHyprland\n```\n\nOr add to your display manager.\n\n## ⌨️ Key Bindings\n\n### Core Applications\n| Key | Action |\n|-----|--------|\n| `Super + Return` | Terminal (Kitty) |\n| `Super + E` | File Manager (Thunar) |\n| `Super + B` | Browser (Firefox) |\n| `Super + C` | Code Editor |\n| `Super + Space` | App Launcher (Rofi) |\n| `Super + Shift + Space` | Command Palette |\n\n### Window Management\n| Key | Action |\n|-----|--------|\n| `Super + Q` | Close Window |\n| `Super + V` | Toggle Floating |\n| `Super + F` | Fullscreen |\n| `Super + H/J/K/L` | Move Focus (Vim-style) |\n| `Super + Shift + H/J/K/L` | Move Window |\n| `Super + Ctrl + H/J/K/L` | Resize Window |\n\n### Workspaces\n| Key | Action |\n|-----|--------|\n| `Super + 1-9` | Switch to Workspace |\n| `Super + Shift + 1-9` | Move Window to Workspace |\n| `Super + S` | Scratchpad |\n\n### System\n| Key | Action |\n|-----|--------|\n| `Print` | Screenshot Area |\n| `Shift + Print` | Screenshot Screen |\n| `Super + Print` | Screenshot Window |\n| `XF86AudioRaise/Lower` | Volume Control |\n| `XF86MonBrightnessUp/Down` | Brightness Control |\n\n## 🎨 Customization\n\n### Color Themes\nThe configuration uses **Catppuccin Mocha** colors:\n- **Blue**: `#89b4fa` (CPU, Bluetooth)\n- **Purple**: `#cba6f7` (Memory)\n- **Orange**: `#fab387` (Temperature, Brightness)\n- **Green**: `#a6e3a1` (Audio, Battery)\n- **Cyan**: `#94e2d5` (Network)\n- **Pink**: `#f5c2e7` (Power)\n\n### Wallpaper\n```bash\n# Change wallpaper\ncp your-wallpaper.jpg ~/.config/hypr/.koompi/wall/\n# Update hyprpaper.conf with new path\n```\n\n### Waybar Modules\nEdit `~/.config/waybar/config` to add/remove modules:\n```json\n\"modules-right\": [\n    \"cpu\",           // System monitoring\n    \"memory\", \n    \"temperature\",\n    \"battery\",       // Power management\n    \"network\",       // Connectivity\n    \"pulseaudio\",\n    \"custom/power\"   // Custom modules\n]\n```\n\n## 🔧 Configuration Files\n\n```\n~/.config/hypr/\n├── hyprland.conf          # Main Hyprland config\n├── hyprpaper.conf         # Wallpaper configuration\n├── .koompi/\n│   ├── koompi-logo-40.png # Waybar logo\n│   └── wall/              # Wallpapers\n└── scripts/\n    └── *.sh              # Helper scripts\n\n~/.config/waybar/\n├── config                 # Waybar modules\n├── style.css             # Waybar styling\n└── scripts/\n    └── *.sh              # Waybar scripts\n```\n\n## 🐛 Troubleshooting\n\n### Common Issues\n\n#### 1. Waybar not starting\n```bash\n# Check for errors\nwaybar -l debug\n\n# Restart waybar\npkill waybar \u0026\u0026 waybar \u0026\n```\n\n#### 2. NVIDIA issues\nAdd to `hyprland.conf`:\n```conf\nenv = LIBVA_DRIVER_NAME,nvidia\nenv = __GLX_VENDOR_LIBRARY_NAME,nvidia\nenv = WLR_NO_HARDWARE_CURSORS,1\n```\n\n#### 3. Screen tearing\n```conf\ngeneral {\n    allow_tearing = true\n}\n```\n\n#### 4. High CPU usage\nReduce animation complexity in `hyprland.conf`:\n```conf\nanimations {\n    enabled = true\n    \n    animation = windows, 1, 4, default, slide\n    animation = border, 1, 1, default\n    animation = fade, 1, 6, default\n}\n```\n\n### Logs and Debug\n```bash\n# View Hyprland logs\njournalctl -f -u display-manager\n\n# Check Waybar status\nsystemctl --user status waybar\n\n# Test configurations\nhyprctl reload\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md).\n\n### Development Setup\n```bash\ngit clone https://github.com/koompi/koompi-hypr.git\ncd koompi-hypr\n\n# Make changes and test\n./test-config.sh\n\n# Submit pull request\n```\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- **Hyprland** - Amazing Wayland compositor\n- **Waybar** - Highly customizable status bar\n- **Catppuccin** - Beautiful color palette\n- **KOOMPI Team** - Original design inspiration\n\n## 📞 Support\n\n- 🐛 **Issues**: [GitHub Issues](https://github.com/koompi/koompi-hypr/issues)\n- 💬 **Discussions**: [GitHub Discussions](https://github.com/koompi/koompi-hypr/discussions)\n- 📧 **Email**: support@koompi.com\n\n---\n\n**Made with ❤️ for the Linux community**\n\n\u003e ⭐ If you find this project useful, please give it a star on GitHub!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoompi%2Fkoompi-hyperland-conf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkoompi%2Fkoompi-hyperland-conf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoompi%2Fkoompi-hyperland-conf/lists"}