TechCraft-Solutions · rusnakdima · Apr 16, 2026
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,59 @@
+```
+# Logs and temp files
+*.log
+*.tmp
+*.swp
+
+# Environment
+.env
+.env.local
+*.env.*
+
+# Editors
+.vscode/
+.idea/
+
+# OS generated files
+.DS_Store
+Thumbs.db
+
+# Build artifacts
+dist/
+build/
+target/
+
+# Dependencies
+node_modules/
+.venv/
+venv/
+__pycache__/
+.mypy_cache/
+.pytest_cache/
+.coverage
+coverage/
+htmlcov/
+
+# Compression files
+*.zip
+*.gz
+*.tar
+*.tgz
+*.bz2
+*.xz
+*.7z
+*.rar
+*.zst
+*.lz4
+*.lzh
+*.cab
+*.arj
+*.rpm
+*.deb
+*.Z
+*.lz
+*.lzo
+*.tar.gz
+*.tar.bz2
+*.tar.xz
+*.tar.zst
+```
diff --git a/README.md b/README.md
@@ -1 +1,189 @@
+# Enhanced Illogical Impulse Theme
 
+A modern, feature-rich Hyprland theme based on the beautiful **Illogical Impulse** by end-4 dots, with additional enhancements and modular architecture.
+
+## 🎨 Features
+
+### Phase 1: Foundation & Architecture ✅
+- **Modular Configuration**: Organized directory structure with separate modules
+  - `colors.conf` - Centralized color palette
+  - `settings.conf` - User-customizable settings
+  - `monitors/` - Display configurations
+  - `animations/` - Basic and enhanced animations
+  - `binds/` - Core, media, workspace, and window keybindings
+  - `windowrules/` - General and special window rules
+
+- **Performance Optimizations**
+  - Variable Frame Rate (VFR) enabled
+  - Configurable animation speeds
+  - Battery-aware performance mode (optional)
+
+### Planned Features (Future Phases)
+- **Phase 2**: Dynamic wallpapers, GLSL shaders, cursor theming, enhanced hyprlock
+- **Phase 3**: Interactive Waybar widgets, enhanced notifications, OSD
+- **Phase 4**: Smart window rules, Zen Mode, clipboard manager, screenshot suite
+- **Phase 5**: Resource dashboard, battery saver, Bluetooth audio switcher
+- **Phase 6**: Complete documentation and troubleshooting guide
+
+## 📦 Installation
+
+### Prerequisites
+
+Required packages:
+```bash
+# Arch Linux
+sudo pacman -S hyprland waybar wofi kitty swaync hyprlock hypridle \
+    grim slurp wl-clipboard playerctl brightnessctl wireplumber
+
+# Fedora
+sudo dnf install hyprland waybar wofi kitty swaync hyprlock hypridle \
+    grim slurp wl-clipboard playerctl brightnessctl wireplumber
+```
+
+### Quick Install
+
+```bash
+cd /workspace
+./scripts/install.sh
+```
+
+The installer will:
+1. Check for dependencies
+2. Backup existing configuration
+3. Create directory structure
+4. Install all configuration files
+5. Set proper permissions
+
+### Manual Installation
+
+```bash
+# Copy config directory
+cp -r config/hypr ~/.config/
+
+# Or symlink for development
+ln -s $(pwd)/config/hypr ~/.config/hypr
+```
+
+## ⌨️ Default Keybindings
+
+| Keybinding | Action |
+|------------|--------|
+| `SUPER + RETURN` | Open terminal (kitty) |
+| `SUPER + D` | Open app launcher (wofi) |
+| `SUPER + SHIFT + D` | Open run dialog |
+| `SUPER + L` | Lock screen |
+| `SUPER + Q` | Close active window |
+| `SUPER + F` | Toggle fullscreen |
+| `SUPER + H/J/K/L` | Navigate between windows |
+| `SUPER + 1-9` | Switch to workspace |
+| `SUPER + SHIFT + 1-9` | Move window to workspace |
+| `SUPER + S` | Toggle scratchpad |
+| `SUPER + V` | Clipboard manager |
+| `SUPER + N` | Notification center |
+| `SUPER + PRINT` | Screenshot output |
+| `SUPER + SHIFT + PRINT` | Screenshot area |
+
+## 🎯 Customization
+
+### Colors
+
+Edit `~/.config/hypr/colors.conf` to change the color scheme:
+
+```ini
+[colors]
+primary_bg = rgba(1a1b26ff)
+primary_fg = rgba(c0caf5ff)
+accent_blue = rgba(7aa2f7ff)
+# ... more colors
+```
+
+### Settings
+
+Edit `~/.config/hypr/settings.conf` for global settings:
+
+```ini
+[settings]
+animation_speed = 1.0
+blur_intensity = 8
+border_size = 2
+gaps_in = 5
+gaps_out = 10
+```
+
+### Keybindings
+
+Modify files in `~/.config/hypr/binds/`:
+- `core.conf` - Essential shortcuts
+- `media.conf` - Media controls
+- `workspaces.conf` - Workspace management
+- `windows.conf` - Window management
+
+## 📁 Directory Structure
+
+```
+/workspace
+├── config/
+│   ├── hypr/
+│   │   ├── hyprland.conf      # Main entry point
+│   │   ├── monitors/
+│   │   ├── animations/
+│   │   ├── binds/
+│   │   └── windowrules/
+│   ├── colors.conf            # Color palette
+│   └── settings.conf          # Global settings
+├── scripts/
+│   └── install.sh             # Installation script
+├── assets/
+│   ├── wallpapers/
+│   ├── icons/
+│   └── cursors/
+└── docs/                      # Documentation
+```
+
+## 🔧 Troubleshooting
+
+### Common Issues
+
+1. **Black screen after login**
+   - Check if all dependencies are installed
+   - Review logs: `journalctl -u hyprland`
+
+2. **Keybindings not working**
+   - Reload config: `SUPER + SHIFT + R`
+   - Check for syntax errors in config files
+
+3. **Animations stuttering**
+   - Reduce animation speed in settings.conf
+   - Enable performance mode
+
+## 🤝 Contributing
+
+Contributions are welcome! Please follow these steps:
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Test thoroughly
+5. Submit a pull request
+
+## 📄 License
+
+This theme is based on the original **Illogical Impulse** theme by end-4 dots.
+
+## 🙏 Credits
+
+- Original theme: [end-4/dots-hyprland](https://github.com/end-4/dots-hyprland)
+- Icon theme: Tokyonight/Tokyo Night
+- Font: JetBrainsMono Nerd Font
+- Color scheme: Tokyo Night
+
+## 📞 Support
+
+For issues and questions:
+- Open an issue on GitHub
+- Check the documentation in `/docs`
+- Join the Hyprland Discord community
+
+---
+
+**Enjoy your enhanced Hyprland experience!** 🚀
diff --git a/config/colors.conf b/config/colors.conf
@@ -0,0 +1,44 @@
+# ===========================================
+# Centralized Color Palette Configuration
+# ===========================================
+# Based on Illogical Impulse theme with enhancements
+
+[colors]
+# Primary Colors
+primary_bg = rgba(1a1b26ff)
+primary_fg = rgba(c0caf5ff)
+secondary_bg = rgba(2428dbff)
+secondary_fg = rgba(7aa2f7ff)
+
+# Accent Colors
+accent_blue = rgba(7aa2f7ff)
+accent_cyan = rgba(7dcfff88)
+accent_purple = rgba(bb9af7ff)
+accent_green = rgba(9ece6aff)
+accent_yellow = rgba(e0af68ff)
+accent_red = rgba(f7768eff)
+accent_orange = rgba(ff9e64ff)
+
+# Status Colors
+status_good = rgba(9ece6aff)
+status_warning = rgba(e0af68ff)
+status_critical = rgba(f7768eff)
+
+# UI Elements
+border_active = rgba(7aa2f7ff)
+border_inactive = rgba(414868ff)
+title_active = rgba(c0caf5ff)
+title_inactive = rgba(565f89ff)
+panel_bg = rgba(1a1b26ee)
+popup_bg = rgba(2428dbff)
+
+# Gradients (for shaders)
+gradient_start = rgba(1a1b26ff)
+gradient_mid = rgba(16213eff)
+gradient_end = rgba(0d0f18ff)
+
+# Transparency Levels
+opaque = 1.0
+semi_transparent = 0.9
+transparent = 0.8
+glass = 0.6
diff --git a/config/hypr/animations/basic.conf b/config/hypr/animations/basic.conf
@@ -0,0 +1,25 @@
+# ===========================================
+# Basic Animations Configuration
+# ===========================================
+
+animations {
+    # Window open/close
+    animation = windowsIn, 1, 5, myBezier, popin 60%
+    animation = windowsOut, 1, 4, myBezier, popin 60%
+
+    # Window fade
+    animation = fadeIn, 1, 5, myBezier
+
+    # Window move/resize
+    animation = windowsMove, 1, 4, myBezier
+
+    # Border fade
+    animation = border, 1, 4, linear
+
+    # Fade on switch (workspaces)
+    animation = fade, 1, 5, myBezier
+
+    # Layers (notifications, menus)
+    animation = layersIn, 1, 4, myBezier, slide
+    animation = layersOut, 1, 3, myBezier, slide
+}
diff --git a/config/hypr/animations/enhanced.conf b/config/hypr/animations/enhanced.conf
@@ -0,0 +1,36 @@
+# ===========================================
+# Enhanced Animations Configuration
+# ===========================================
+# Advanced animation effects for a polished experience
+
+animations {
+    # Workspace changes with smooth transition
+    animation = workspace, 1, 6, myBezier2
+
+    # Special workspaces (scratchpad)
+    animation = specialWorkspace, 1, 5, myBezier, slidevert
+
+    # Group bar animations
+    animation = group, 1, 4, myBezier
+
+    # Scroll in groups
+    animation = scrollGroup, 1, 3, linear
+}
+
+# Performance optimization: reduce animations on battery
+# Uncomment to enable battery-aware animations
+# bind = SUPER, B, exec, hyprctl keyword animations:enabled false # Performance mode
+# bind = SUPER ALT, B, exec, hyprctl keyword animations:enabled true # Normal mode
+
+# Custom animation profiles (switch via keybind)
+# Profile: Minimal (for low-end hardware or presentations)
+# animation = windowsIn, 0
+# animation = windowsOut, 0
+# animation = fadeIn, 0
+# animation = windowsMove, 0
+# animation = border, 0
+# animation = fade, 0
+# animation = layersIn, 0
+# animation = layersOut, 0
+# animation = workspace, 0
+# animation = specialWorkspace, 0