2025-12-21 10:20:12 +01:00
7 changed files with 49 additions and 1401 deletions
--- a/BUILD_METHOD_OPTIONS.md
+++ b/BUILD_METHOD_OPTIONS.md
@ -1,178 +0,0 @@
-# Hyprland Installation Method Options
-
-## Overview
-
-The `install.sh` script has been updated to support **two installation methods**:
-
-1. **Build from Source** (Original method)
-2. **Install from Pre-built Packages** (New method - faster)
-
-## Configuration
-
-### Setting the Package Source Location
-
-At the top of `install.sh`, you'll find this variable:
-
-```bash
-DEB_PACKAGES_SOURCE="/mnt/nas/Projects/Jak/debian-pkg/build/debs"
-```
-
-**To change the package location:**
- Modify `DEB_PACKAGES_SOURCE` to point to your pre-built .deb package directory
- Can be a local path or network share
- Leave empty to always build from source
-
-### Current Configuration
-
-**Current source location:** `/mnt/nas/Projects/Jak/debian-pkg/build/debs`
-
-**Available packages:** 59 .deb files
- All Hyprland components (0.52.2)
- All dependencies (utilities, graphics, cursors, etc.)
- 9 Hyprland plugins
- Debug symbols and development files
-
-## Installation Flow
-
-### Automatic Method Selection
-
-When you run `install.sh`:
-
-1. **Environment Check**: Script checks if packages are available at `DEB_PACKAGES_SOURCE`
-2. **User Prompt**: If packages found, you're asked to choose:
-   - **YES** → Install from pre-built packages (faster, ~5-10 minutes)
-   - **NO** → Build from source (slower, ~1-2 hours)
-
-3. **Execution**: Script runs the selected method
-
-### Build from Source Method
-
-If you choose "from source" or no packages are available:
- Runs all the original install scripts
- Builds each component from GitHub source
- Takes significantly longer but gives latest upstream code
-
-### Build from Packages Method
-
-If you choose "pre-built packages":
-1. Validates package directory exists and contains .deb files
-2. Counts available packages
-3. Installs all .deb files using `dpkg -i`
-4. Fixes any missing dependencies with `apt-get install -f`
-5. Completes much faster than source builds
-
-## Usage Examples
-
-### To use current pre-built packages (on test network):
-
-```bash
-cd ~/Projects/Jak/Debian-Hyprland
-./install.sh
-# When prompted, select YES to use pre-built packages
-```
-
-### To always build from source (ignore packages):
-
-```bash
-# Edit install.sh and change:
-DEB_PACKAGES_SOURCE=""
-# Then run:
-./install.sh
-```
-
-### To use packages from a different location:
-
-```bash
-# Edit install.sh and change:
-DEB_PACKAGES_SOURCE="/path/to/your/packages"
-# Then run:
-./install.sh
-```
-
-## Building Your Own Packages
-
-To generate pre-built packages:
-
-```bash
-cd /mnt/nas/Projects/Jak/debian-pkg
-./build_all_final.sh
-```
-
-This creates all 59 .deb packages in `build/debs/`
-
-## Package Versions
-
-All pre-built packages match upstream versions:
-
-| Package | Version |
-|---------|---------|
-| hyprland | 0.52.2 |
-| hyprutils | 0.10.4 |
-| hyprgraphics | 0.4.0 |
-| aquamarine | 0.10.0 |
-| hyprtoolkit | 0.4.0 |
-| (and 11 more) | (see VERSION_VERIFICATION.txt) |
-
-## Benefits of Each Method
-
-### Build from Source
- ✅ Ensures latest upstream code
- ✅ Custom compilation options possible
- ❌ Takes 1-2 hours
- ❌ Requires all build tools and deb-src enabled
-
-### Build from Packages
- ✅ Fast installation (5-10 minutes)
- ✅ Pre-tested and validated builds
- ✅ No build tools required
- ✅ Works from network share
- ❌ Fixed versions (no custom compilation)
-
-## Troubleshooting
-
-### "No .deb files found" error
-
-**Solution:**
-1. Check `DEB_PACKAGES_SOURCE` path exists
-2. Verify .deb files are in that location
-3. Check file permissions
-4. Run `ls $DEB_PACKAGES_SOURCE/*.deb` to verify
-
-### Package installation fails
-
-**Solution:**
-```bash
-# Manually fix dependencies:
-sudo apt-get install -f -y
-
-# Or reinstall specific package:
-sudo dpkg -i /path/to/package.deb
-sudo apt-get install -f -y
-```
-
-### Mixed dependency errors
-
-**Solution:** Ensure all interdependent packages are installed together:
-```bash
-sudo dpkg -i $DEB_PACKAGES_SOURCE/*.deb
-sudo apt-get install -f -y
-```
-
-## Network Share Access
-
-If packages are on a NAS/network share:
-
-```bash
-# Mount the share (if not already mounted):
-sudo mount -t nfs nas:/path/to/share /mnt/nas
-
-# Or modify DEB_PACKAGES_SOURCE to your network path:
-DEB_PACKAGES_SOURCE="//nas/Projects/Jak/debian-pkg/build/debs"
-```
-
-## Version Information
-
- **Install script updated:** 2025-12-13
- **Package build system:** Debian dpkg-buildpackage
- **Supported distributions:** Debian Trixie / SiD
- **Pre-built packages location:** `/mnt/nas/Projects/Jak/debian-pkg/build/debs`
--- a/CHANGES_SUMMARY.md
+++ b/CHANGES_SUMMARY.md
@ -1,247 +0,0 @@
-# Install Script Updates - Summary of Changes
-
-## Files Modified
- `install.sh` - Main installation script
-
-## Files Created
- `INSTALL_METHOD_GUIDE.md` - Comprehensive documentation
- `QUICK_START.txt` - Quick reference guide
- `CHANGES_SUMMARY.md` - This file
-
-## Key Additions to install.sh
-
-### 1. Package Source Variable (Line 4-6)
-```bash
-# Source location for pre-built Debian packages (can be local or network share)
-# Set this variable to the path containing .deb files, or leave empty to build from source
-DEB_PACKAGES_SOURCE="/mnt/nas/Projects/Jak/debian-pkg/build/debs"
-```
-
-**Purpose:** Configurable location for pre-built .deb packages
-**Default:** `/mnt/nas/Projects/Jak/debian-pkg/build/debs`
-**Can be modified to:** Any local path or network share with .deb files
-
-### 2. clean_existing_hyprland() Function (Lines 123-160)
-**Purpose:** Remove conflicting installations before installing from packages
-
-**Operations:**
- Removes all .deb packages using `apt-get remove`
- Deletes source-built binaries from /usr/bin and /usr/local/bin
- Removes development files from /usr/local/include and /usr/local/lib
- Updates library cache with `ldconfig`
-
-**Packages Cleaned:**
- hyprland, hyprutils, hyprgraphics, hyprcursor, hyprtoolkit
- hyprland-guiutils, hyprwire, aquamarine, hypridle, hyprlock
- hyprpolkitagent, hyprpicker, xdg-desktop-portal-hyprland, hyprland-plugins
-
-**Binaries Cleaned:**
- /usr/local/bin/Hyprland, /usr/local/bin/hyprland
- /usr/bin/Hyprland, /usr/bin/hyprland
-
-**Development Files Cleaned:**
- /usr/local/include/hyprland*
- /usr/local/lib/libhypr*
- /usr/local/lib/libaquamarine*
- /usr/local/lib/libypr*
-
-### 3. install_from_packages() Function (Lines 162-197)
-**Purpose:** Install Hyprland from pre-built .deb packages
-
-**Steps:**
-1. Validate DEB_PACKAGES_SOURCE exists
-2. Count available .deb files
-3. Call clean_existing_hyprland() for cleanup
-4. Update package cache with `apt-get update`
-5. Install all .deb files with `dpkg -i`
-6. Fix dependencies with `apt-get install -f -y`
-
-### 4. Build Method Selection (Lines 206-231)
-**Purpose:** Allow user to choose between source build and package installation
-
-**Logic:**
- Detects if packages are available at DEB_PACKAGES_SOURCE
- If yes, prompts user with whiptail dialog
-  - YES: Install from pre-built packages
-  - NO: Build from source
- If no packages found, defaults to source build
-
-**User Prompts:**
- "Build Method" dialog shows package location and options
- "Proceed with Installation?" dialog shows selected method and instructions
-
-### 5. Installation Flow Modification (Lines 429-490)
-**Purpose:** Execute selected build method with proper conditional logic
-
-**Changes:**
- Added if/else condition checking `build_method` variable
- If "packages": Calls install_from_packages()
- If "source": Executes original build scripts
-
-**Original Behavior:** Always builds from source
-**New Behavior:** Offers choice, defaults to source if packages unavailable
-
-## Benefits
-
-### For Users
- **Faster Installation:** 5-10 minutes vs 1-2 hours with pre-built packages
- **Simpler Setup:** No build tools required for package installation
- **Flexibility:** Can choose between speed (packages) or latest code (source)
- **Safety:** Automatic cleanup prevents conflicts between methods
- **Testing Ready:** Can quickly test pre-built packages on shared network
-
-### For Testing/Development
- **Network Share Support:** Can test on NAS without compiling
- **Version Control:** Easy to test different package versions
- **Quick Iteration:** Fast install/uninstall cycles for testing
- **Shared Resources:** Multiple users can share pre-built packages
-
-## Configuration
-
-### Default Setup (Current)
-```bash
-DEB_PACKAGES_SOURCE="/mnt/nas/Projects/Jak/debian-pkg/build/debs"
-```
-
-### To Disable Package Installation (Always Source)
-```bash
-DEB_PACKAGES_SOURCE=""
-```
-
-### To Use Different Package Location
-```bash
-DEB_PACKAGES_SOURCE="/path/to/your/packages"
-```
-
-## Usage Examples
-
-### Quick Install from Packages
-```bash
-./install.sh
-# Select YES when prompted
-# ~5-10 minutes
-```
-
-### Build from Source
-```bash
-./install.sh
-# Select NO when prompted
-# ~1-2 hours
-```
-
-### Force Package Location
-```bash
-DEB_PACKAGES_SOURCE="/custom/path" ./install.sh
-```
-
-## Backward Compatibility
-
-✓ **Fully backward compatible**
- If DEB_PACKAGES_SOURCE not found, script defaults to source build
- Original source build scripts still work unchanged
- Existing workflows not disrupted
-
-## Testing Notes
-
-**Test Scenario 1:** Fresh installation from packages
-```
-Expected: 5-10 minute install
-Actual: [To be tested]
-```
-
-**Test Scenario 2:** Switch from source to packages
-```
-Expected: Automatic cleanup, fresh install
-Actual: [To be tested]
-```
-
-**Test Scenario 3:** Switch from packages to source
-```
-Expected: Cleanup, source build
-Actual: [To be tested]
-```
-
-## Files Included
-
-| File | Purpose |
-|------|---------|
-| install.sh | Modified main script with build method options |
-| INSTALL_METHOD_GUIDE.md | Comprehensive documentation |
-| QUICK_START.txt | Quick reference for users |
-| CHANGES_SUMMARY.md | This file |
-
-## Lines Changed in install.sh
-
-| Section | Lines | Change Type |
-|---------|-------|------------|
-| Package source config | 4-6 | New variable |
-| clean_existing_hyprland() | 123-160 | New function |
-| install_from_packages() | 162-197 | New function |
-| Build method selection | 206-231 | New conditional |
-| Installation flow | 429-490 | Modified logic |
-
-## Documentation Created
-
-1. **INSTALL_METHOD_GUIDE.md** (303 lines)
-   - Comprehensive user guide
-   - Installation flows
-   - Troubleshooting
-   - Environment variables
-   - Performance comparison
-
-2. **QUICK_START.txt** (Plain text format)
-   - Quick reference
-   - Common questions
-   - Troubleshooting
-   - Ready-to-use commands
-
-## Pre-built Package Information
-
-**Location:** `/mnt/nas/Projects/Jak/debian-pkg/build/debs`
-**Count:** 59 .deb files
-**Version:** Hyprland 0.52.2
-**Date Built:** 2025-12-13
-
-### Package Breakdown
- Core packages: 5
- Utilities: 5
- Extensions: 5
- Development files: 7
- Debug symbols: 24
- Binary packages: 28
-
-## Known Limitations
-
-1. **Package Availability**: Requires packages to exist at DEB_PACKAGES_SOURCE
-2. **Network Dependency**: Remote packages need accessible network path
-3. **Version Pinning**: Pre-built packages are fixed version (no live updates)
-4. **Space Requirements**: 59 .deb files require ~1-2GB total
-
-## Future Enhancements
-
-Potential improvements for future versions:
- Package version selection dialog
- Automatic package generation option
- Package download from repository
- Package cache management
- Mirror support for distributed testing
-
-## Support & Maintenance
-
-For issues or questions:
-1. Check INSTALL_METHOD_GUIDE.md
-2. Review Install-Logs/ directory
-3. Verify DEB_PACKAGES_SOURCE accessibility
-4. Run `apt-get update` manually if needed
-
-## Version History
-
-| Date | Version | Changes |
-|------|---------|---------|
-| 2025-12-13 | 1.0 | Initial release with package installation support |
-
---
-
-**Script Updated:** 2025-12-13
-**Compatible with:** Debian Trixie / SiD
-**Build System:** dpkg-buildpackage
--- a/GIT_STATUS.md
+++ b/GIT_STATUS.md
@ -1,158 +0,0 @@
-# Git Repository Status - Debian-Hyprland
-
-## Repository Status
-✅ **Current and Up-to-Date**
-
-```
-On branch development
-Your branch is up to date with 'origin/development'.
-```
-
-## Changes Made
-
-### Modified Files
- `install.sh` - Main installation script
-
-**Changes:**
- Added `DEB_PACKAGES_SOURCE` variable configuration
- Added `clean_existing_hyprland()` function (38 lines)
- Added `install_from_packages()` function (36 lines)
- Added build method selection logic (18 lines)
- Modified installation flow to handle both source and package methods (70+ lines modified/added)
-
-**Total additions:** ~160 lines of code
-**Total modifications:** ~70 lines wrapped in conditional logic
-
-### New Files (Untracked)
-1. `INSTALL_METHOD_GUIDE.md` - Comprehensive documentation (303 lines)
-2. `QUICK_START.txt` - Quick reference guide (50 lines)
-3. `CHANGES_SUMMARY.md` - Detailed change log (160 lines)
-4. `GIT_STATUS.md` - This file
-
-## Verification
-
-### Script Integrity
-✅ `install.sh` modifications are complete
-✅ All functions properly integrated
-✅ Build method selection working
-✅ Cleanup function in place
-✅ Package installation function active
-
-### Key Features Added
-✅ Package source variable (`DEB_PACKAGES_SOURCE`)
-✅ Automatic build method detection
-✅ User prompt for method selection
-✅ Existing installation cleanup
-✅ Pre-built package installation
-✅ Backward compatibility with source builds
-
-## Git Commands for Next Steps
-
-### To stage and commit changes:
-```bash
-cd ~/Projects/Jak/Debian-Hyprland
-
-# Stage all changes
-git add install.sh INSTALL_METHOD_GUIDE.md QUICK_START.txt CHANGES_SUMMARY.md
-
-# Review changes
-git status
-
-# Commit
-git commit -m "Add pre-built package installation option with automatic cleanup"
-
-# Push to remote
-git push origin development
-```
-
-### To check what changed:
-```bash
-# Show differences
-git diff install.sh
-
-# Show stats
-git diff --stat
-
-# Show full patch
-git diff --patch
-```
-
-## Installation Script Summary
-
-**Modified Lines:** ~250 total
-**New Functions:** 2 (`clean_existing_hyprland`, `install_from_packages`)
-**Configuration:** 1 variable (`DEB_PACKAGES_SOURCE`)
-**New Logic:** Build method selection and conditional execution
-
-## Current Configuration
-
-```bash
-# Location of pre-built .deb packages
-DEB_PACKAGES_SOURCE="/mnt/nas/Projects/Jak/debian-pkg/build/debs"
-
-# Available packages: 59 .deb files
-# Hyprland version: 0.52.2
-```
-
-## Next Steps
-
-1. **Test the changes:**
-   ```bash
-   cd ~/Projects/Jak/Debian-Hyprland
-   ./install.sh
-   # Select "YES" to test package installation
-   ```
-
-2. **Commit if successful:**
-   ```bash
-   git add .
-   git commit -m "Add package installation support"
-   git push
-   ```
-
-3. **Update documentation in repo:**
-   - Add README section about new installation methods
-   - Link to INSTALL_METHOD_GUIDE.md from README
-
-## Files Modified vs Untracked
-
-### Modified (Will be committed):
- `install.sh` - Ready to commit
-
-### Untracked (Consider committing):
- `INSTALL_METHOD_GUIDE.md` - Detailed documentation
- `QUICK_START.txt` - User guide
- `CHANGES_SUMMARY.md` - Technical reference
- `GIT_STATUS.md` - This status file
-
-## Backward Compatibility
-
-✅ **Fully backward compatible**
- Source build method still available
- If `DEB_PACKAGES_SOURCE` unavailable, defaults to source
- No breaking changes to existing workflows
- All original scripts still functional
-
-## Testing Checklist
-
-Before committing, test:
- [ ] Fresh install from pre-built packages
- [ ] Fresh install from source (select NO)
- [ ] Switch from source to packages on same system
- [ ] Package cleanup functionality
- [ ] Dependency resolution
- [ ] Final Hyprland installation verification
-
-## Notes
-
- Branch: `development` (not main)
- Remote is current: `origin/development` is up to date
- No merge conflicts
- Safe to commit after testing
-
---
-
-**Status Verified:** 2025-12-13
-**Repository:** ~/Projects/Jak/Debian-Hyprland
-**Branch:** development
-**Remote Status:** Current
--- a/INSTALL_METHOD_GUIDE.md
+++ b/INSTALL_METHOD_GUIDE.md
@ -1,303 +0,0 @@
-# Hyprland Installation Method Guide
-
-## Overview
-
-The `install.sh` script has been updated to support **two installation methods** with automatic cleanup of existing installations:
-
-1. **Build from Source** (original method - slower, ~1-2 hours)
-2. **Install from Pre-built Packages** (new method - faster, ~5-10 minutes)
-
-## Key Features
-
-### 1. Package Source Configuration
-
-Located at the top of `install.sh`:
-
-```bash
-DEB_PACKAGES_SOURCE="/mnt/nas/Projects/Jak/debian-pkg/build/debs"
-```
-
-**Modify this variable to:**
- Point to a local directory with .deb files
- Point to a network share (NAS/SMB/NFS)
- Leave empty (`""`) to always build from source
-
-### 2. Automatic Build Method Selection
-
-When you run `install.sh`:
-
-```
-1. Script checks if DEB_PACKAGES_SOURCE exists and contains .deb files
-2. If found, prompts: "Install from pre-built packages or build from source?"
-   - YES → Install from packages (5-10 minutes)
-   - NO  → Build from source (1-2 hours)
-3. If not found, defaults to building from source
-```
-
-### 3. Automatic Cleanup Before Package Installation
-
-When installing from pre-built packages, the script **automatically removes** any existing Hyprland installations:
-
-#### .deb Packages Removed
-```
- hyprland
- hyprutils
- hyprgraphics
- hyprcursor
- hyprtoolkit
- hyprland-guiutils
- hyprwire
- aquamarine
- hypridle
- hyprlock
- hyprpolkitagent
- hyprpicker
- xdg-desktop-portal-hyprland
- hyprland-plugins
-```
-
-#### Binaries Removed
-```
- /usr/local/bin/Hyprland
- /usr/local/bin/hyprland
- /usr/bin/Hyprland
- /usr/bin/hyprland
-```
-
-#### Development Files Removed
-```
- /usr/local/include/hyprland*
- /usr/local/lib/libhypr*
- /usr/local/lib/libaquamarine*
- /usr/local/lib/libypr*
-```
-
-#### Cleanup Steps
-1. Removes all installed .deb packages using `apt-get remove`
-2. Deletes source-built binaries
-3. Removes development files from /usr/local
-4. Updates library cache with `ldconfig`
-5. Updates package cache with `apt-get update`
-6. Installs new packages from .deb files
-7. Fixes any dependency issues with `apt-get install -f`
-
-## Usage
-
-### Basic Usage (Automatic Method Selection)
-
-```bash
-cd ~/Projects/Jak/Debian-Hyprland
-./install.sh
-```
-
-The script will:
-1. Detect available packages at `DEB_PACKAGES_SOURCE`
-2. Ask which method you prefer
-3. Execute the selected method with proper cleanup
-
-### Using Pre-built Packages (Current Setup)
-
-**Current package location:** `/mnt/nas/Projects/Jak/debian-pkg/build/debs`
-
-```bash
-./install.sh
-# When prompted: Select YES to use pre-built packages
-# Script will:
-# 1. Remove any existing Hyprland installations
-# 2. Install 59 .deb packages (~5-10 minutes)
-# 3. Verify installations
-```
-
-### Using Custom Package Location
-
-Edit `install.sh` to change the source:
-
-```bash
-# Edit this line in install.sh:
-DEB_PACKAGES_SOURCE="/path/to/your/packages"
-
-# Then run:
-./install.sh
-```
-
-### Building from Source
-
-Option 1: Edit script to disable packages
-```bash
-# In install.sh, change:
-DEB_PACKAGES_SOURCE=""
-
-# Then run:
-./install.sh
-```
-
-Option 2: During installation
-```bash
-./install.sh
-# When prompted: Select NO to build from source
-```
-
-## Installation Flow
-
-```
-START
-  ↓
-Check DEB_PACKAGES_SOURCE exists and has .deb files
-  ↓
-  ├─ YES → Prompt user for build method
-  │         ├─ YES → Install from packages (selected method)
-  │         │         ├─ Clean existing installations
-  │         │         ├─ Remove .deb packages
-  │         │         ├─ Remove source binaries
-  │         │         ├─ Remove dev files
-  │         │         ├─ Update package cache
-  │         │         ├─ Install all .deb files
-  │         │         ├─ Fix dependencies
-  │         │         └─ Done
-  │         │
-  │         └─ NO → Build from source (selected method)
-  │                  └─ Execute source build scripts
-  │
-  └─ NO → Build from source (default method)
-           └─ Execute source build scripts
-```
-
-## Available Pre-built Packages
-
-**Location:** `/mnt/nas/Projects/Jak/debian-pkg/build/debs`
-**Total:** 59 .deb files
-
-### Core Packages
- hyprland 0.52.2
- hyprutils 0.10.4
- hyprgraphics 0.4.0
- aquamarine 0.10.0
- hyprtoolkit 0.4.0
-
-### Utilities & Tools
- hypridle 0.1.7
- hyprlock 0.9.2
- hyprpicker 0.4.5
- hyprpolkitagent 0.1.3
- hyprcursor 0.1.13
-
-### Extensions
- hyprland-guiutils 0.1.0
- hyprland-qt-support 0.1.0
- hyprwire 0.2.1
- xdg-desktop-portal-hyprland 1.3.11
- hyprland-plugins 0.52.0 (9 plugins)
-
-### Package Types
- Binary packages: 28
- Development (-dev): 7
- Debug symbols (-dbgsym): 24
-
-## Cleanup Function Details
-
-### Function: `clean_existing_hyprland()`
-
-**Purpose:** Remove conflicting installations before installing from packages
-
-**Operations:**
-1. **Package Removal**
-   - Uses `apt-get remove -y` for clean uninstallation
-   - Removes only installed packages (checks with `dpkg -l`)
-
-2. **Binary Removal**
-   - Removes compiled binaries from /usr/bin and /usr/local/bin
-   - Safely handles missing files
-
-3. **Development File Removal**
-   - Clears header files from /usr/local/include/
-   - Clears library files from /usr/local/lib/
-   - Updates library cache
-
-**Logging:** All actions logged to Install-Logs directory
-
-## Troubleshooting
-
-### "No .deb files found" error
-
-**Solution:**
-```bash
-# Check if directory exists:
-ls -la /mnt/nas/Projects/Jak/debian-pkg/build/debs/
-
-# Verify files are readable:
-ls /mnt/nas/Projects/Jak/debian-pkg/build/debs/*.deb | wc -l
-
-# If network share, verify mount:
-mount | grep nas
-```
-
-### Package installation fails
-
-**Solution:**
-```bash
-# Manually fix dependencies:
-sudo apt-get install -f -y
-
-# Check package status:
-dpkg -l | grep hyprland
-```
-
-### Conflicts with source-built version
-
-The cleanup function should handle this automatically. If issues persist:
-
-```bash
-# Manual cleanup:
-sudo apt-get remove -y hyprland* hyprutils* hyprgraphics* aquamarine* hyprtoolkit*
-sudo rm -rf /usr/local/include/hyprland* /usr/local/lib/libhypr*
-sudo ldconfig
-sudo apt-get update
-```
-
-## Environment Variables
-
-### DEB_PACKAGES_SOURCE
-
- **Type:** Path (local or network)
- **Default:** `/mnt/nas/Projects/Jak/debian-pkg/build/debs`
- **Usage:** Specifies where pre-built .deb packages are located
- **Can be:** 
-  - Local path: `/home/user/debs`
-  - Network share: `//nas/share/debs`
-  - Empty (to disable): `""`
-
-## Performance Comparison
-
-| Aspect | Source Build | Pre-built Packages |
-|--------|--------------|-------------------|
-| Time | 1-2 hours | 5-10 minutes |
-| Complexity | High (compile, test) | Low (install only) |
-| Disk Space | ~10-20GB | ~1-2GB |
-| Build Tools | Required | Not needed |
-| Customization | Full control | Fixed version |
-| Network Dependency | GitHub API | Package location |
-
-## Version Information
-
- **Script Updated:** 2025-12-13
- **Compatible with:** Debian Trixie / SiD
- **Hyprland Version:** 0.52.2
- **Build System:** dpkg-buildpackage
- **Pre-built Package Count:** 59 files
-
-## Notes
-
- **Cleanup is automatic:** No manual intervention needed when switching from source to packages
- **Safe removal:** Only removes known Hyprland packages and binaries
- **Dependency fixing:** Automatic `apt-get install -f` handles missing dependencies
- **Logging:** All operations logged to Install-Logs/ directory
- **Network shares:** Works with NFS, SMB, or local paths
-
-## Support
-
-For issues:
-1. Check Install-Logs/ directory for detailed error messages
-2. Verify package location exists and is accessible
-3. Ensure read permissions on .deb files
-4. Run `apt-get update` manually if needed
-5. Check system resources (disk space, RAM)
--- a/PACKAGE_INSTALL_TROUBLESHOOTING.md
+++ b/PACKAGE_INSTALL_TROUBLESHOOTING.md
@ -1,259 +0,0 @@
-# Package Installation Troubleshooting Guide
-
-## Recent Update (2025-12-13)
-
-The `install.sh` script has been updated to:
- **Skip plugins by default** (optional, can install manually)
- **Skip debug symbols by default** (optional, can install manually)
- **Focus on core packages only** for initial installation
- **Improve dependency resolution** with `apt-get install -f`
-
-## Common Dependency Issues
-
-### Issue: Missing libhyprlang2
-
-**Error:**
-```
-hypridle depends on libhyprlang2 (>= 0.6.4); however:
-Package libhyprlang2 is not installed.
-```
-
-**Cause:** libhyprlang is not included in the current pre-built packages. It needs to be built or installed from Debian repositories.
-
-**Solution:**
-```bash
-# Option 1: Install from Debian repositories
-sudo apt-get install libhyprlang2
-
-# Option 2: Build from source (fallback to source method in install.sh)
-```
-
-### Issue: Missing libaquamarine8
-
-**Error:**
-```
-hyprland depends on libaquamarine8 (>= 0.9.5); however:
-Package libaquamarine8 is not installed.
-```
-
-**Cause:** Pre-built packages have libaquamarine9, not libaquamarine8. Version mismatch.
-
-**Solution:**
-```bash
-# Check what's installed:
-dpkg -l | grep aquamarine
-
-# If you have libaquamarine9, it should work with newer hyprland
-# If not, install aquamarine from packages:
-sudo dpkg -i /mnt/nas/Projects/Jak/debian-pkg/build/debs/libaquamarine*.deb
-```
-
-### Issue: libstdc++6 version too old
-
-**Error:**
-```
-hyprland depends on libstdc++6 (>= 15); however:
-Version of libstdc++6:amd64 on system is 14.2.0-19.
-```
-
-**Cause:** System C++ standard library is older than required.
-
-**Solution:**
-```bash
-# Update your system (highest priority):
-sudo apt-get update
-sudo apt-get upgrade
-
-# Or install g++ 15:
-sudo apt-get install g++-15
-```
-
-### Issue: libxkbcommon0 version too old
-
-**Error:**
-```
-hyprland depends on libxkbcommon0 (>= 1.12.3); however:
-Version of libxkbcommon0:amd64 on system is 1.7.0-2.
-```
-
-**Cause:** System xkbcommon library is older than required.
-
-**Solution:**
-```bash
-# Update system packages:
-sudo apt-get update
-sudo apt-get upgrade libxkbcommon0
-
-# Or build from source:
-sudo apt-get build-dep libxkbcommon
-```
-
-## Installation Workflow (Updated)
-
-### Step 1: Install Core Packages
-
-```bash
-cd ~/Projects/Jak/Debian-Hyprland
-./install.sh
-# Select YES to use pre-built packages
-# Script will skip plugins and debug symbols automatically
-```
-
-**What gets installed:**
- Core libraries (hyprutils, hyprgraphics, hyprcursor, etc.)
- Main compositor (hyprland)
- Essential utilities (hypridle, hyprlock, etc.)
- Development files (-dev packages)
-
-**What is skipped (can install manually later):**
- Hyprland plugins (9 optional plugins)
- Debug symbols (-dbgsym packages)
-
-### Step 2: Fix Missing Dependencies
-
-If you encounter missing dependencies:
-
-```bash
-# Install missing system dependencies:
-sudo apt-get install -f -y
-
-# This will attempt to resolve any broken dependencies from Debian repos
-```
-
-### Step 3: Install Optional Components
-
-**Install plugins (if desired):**
-```bash
-sudo dpkg -i /mnt/nas/Projects/Jak/debian-pkg/build/debs/hyprland-plugin-*.deb
-```
-
-**Install debug symbols (if desired):**
-```bash
-sudo dpkg -i /mnt/nas/Projects/Jak/debian-pkg/build/debs/*-dbgsym*.deb
-```
-
-## Dependency Resolution Strategy
-
-The updated script uses a staged approach:
-
-1. **Install core packages** (libraries and binaries)
-2. **Run `apt-get install -f`** to resolve from Debian repos
-3. **Skip optional components** (plugins, debug)
-4. **Provide manual install commands** for optional packages
-
-## System Requirements
-
-For successful installation, ensure:
-
-| Component | Minimum | Recommended |
-|-----------|---------|------------|
-| libstdc++6 | 14.2.0 | 15.x |
-| libxkbcommon0 | 1.7.0 | 1.12.3+ |
-| Debian Release | Trixie | Trixie or newer |
-
-## Upgrading System Libraries
-
-If you have dependency version issues:
-
-```bash
-# Full system upgrade (safest approach)
-sudo apt-get update
-sudo apt-get upgrade
-
-# Or targeted package upgrades
-sudo apt-get install --only-upgrade libstdc++6
-sudo apt-get install --only-upgrade libxkbcommon0
-```
-
-## Manual Installation Without Script
-
-If the script fails, install packages manually:
-
-```bash
-cd /mnt/nas/Projects/Jak/debian-pkg/build/debs
-
-# Install only core .deb files (not plugins or debug):
-for deb in *.deb; do
-    if [[ "$deb" != *"-dbgsym"* ]] && [[ "$deb" != "hyprland-plugin"* ]]; then
-        sudo dpkg -i "$deb"
-    fi
-done
-
-# Fix dependencies:
-sudo apt-get install -f -y
-```
-
-## Known Issues
-
-### Issue: Plugins require hyprland to be installed first
-**Status:** Fixed in updated script (plugins skipped)
-**Solution:** Install core packages first, then manually install plugins
-
-### Issue: Debug symbols require main package
-**Status:** Fixed in updated script (dbgsym skipped)
-**Solution:** Install main packages first, then manually install -dbgsym
-
-### Issue: Some libraries missing from pre-built
-**Status:** Partially fixed with `apt-get install -f`
-**Solution:** Keep system updated, use fallback to source build if needed
-
-## Fallback to Source Build
-
-If package installation fails completely:
-
-```bash
-cd ~/Projects/Jak/Debian-Hyprland
-./install.sh
-# When prompted: Select NO to build from source instead
-# Takes 1-2 hours but builds everything from scratch
-```
-
-## Getting Help
-
-1. **Check Install-Logs directory:**
-   ```bash
-   cat Install-Logs/01-Hyprland-Install-Scripts-*.log
-   ```
-
-2. **Check package status:**
-   ```bash
-   dpkg -l | grep hyprland
-   apt-cache policy hyprland
-   ```
-
-3. **Check system libraries:**
-   ```bash
-   ldd /usr/bin/Hyprland
-   dpkg -l | grep libstdc++6
-   dpkg -l | grep libxkbcommon0
-   ```
-
-## Summary
-
-**Core Changes (2025-12-13):**
- ✅ Skip plugins by default (reduce dependency issues)
- ✅ Skip debug symbols by default (faster installation)
- ✅ Auto-fix missing Debian dependencies with `apt-get install -f`
- ✅ Provide manual commands for optional packages
- ✅ Better error handling and logging
-
-**Installation Time:**
- Core packages: 5-10 minutes
- With plugins: +5 minutes
- With debug symbols: +10 minutes
-
-**Next Steps After Install:**
-```bash
-# Verify installation:
-hyprland --version
-Hyprland --help
-
-# Install plugins (optional):
-sudo dpkg -i /mnt/nas/Projects/Jak/debian-pkg/build/debs/hyprland-plugin-*.deb
-
-# Install debug symbols (optional):
-sudo dpkg -i /mnt/nas/Projects/Jak/debian-pkg/build/debs/*-dbgsym*.deb
-
-# Reboot to ensure all changes take effect:
-sudo reboot
-```
--- a/QUICK_START.txt
+++ b/QUICK_START.txt
@ -1,79 +0,0 @@
-=== QUICK START - HYPRLAND INSTALLATION ===
-
-OPTION 1: Install from Pre-built Packages (RECOMMENDED - 5-10 minutes)
---
-cd ~/Projects/Jak/Debian-Hyprland
-./install.sh
-→ When prompted, select YES to use pre-built packages
-→ Script automatically cleans old installations and installs fresh
-
-Benefits:
-✓ Fast (5-10 minutes vs 1-2 hours)
-✓ No build tools needed
-✓ Pre-tested and validated
-✓ 59 packages ready to install
-
-
-OPTION 2: Build from Source (1-2 hours)
---
-cd ~/Projects/Jak/Debian-Hyprland
-./install.sh
-→ When prompted, select NO to build from source
-→ Script compiles everything from GitHub
-
-Benefits:
-✓ Latest upstream code
-✓ Custom build options possible
-✗ Takes much longer
-✗ Requires all build tools
-
-
-KEY CHANGES IN install.sh:
---
-1. DEB_PACKAGES_SOURCE variable (line 6)
-   Current: /mnt/nas/Projects/Jak/debian-pkg/build/debs
-   Change this to use different package location
-
-2. clean_existing_hyprland() function (lines 123-160)
-   - Removes old .deb packages
-   - Removes source-built binaries
-   - Removes development files from /usr/local
-   - Updates library cache
-
-3. install_from_packages() function (lines 162-197)
-   - Validates packages exist
-   - Calls cleanup function
-   - Installs all .deb files
-   - Fixes dependencies
-
-
-PRE-BUILT PACKAGES:
---
-Location: /mnt/nas/Projects/Jak/debian-pkg/build/debs
-Total: 59 .deb files
-Version: Hyprland 0.52.2 (and all dependencies)
-
-
-TROUBLESHOOTING:
---
-Q: Script says "No .deb files found"
-A: Check if path is correct and accessible
-   ls -la /mnt/nas/Projects/Jak/debian-pkg/build/debs/
-
-Q: Installation fails with dependency errors
-A: Run manually: sudo apt-get install -f -y
-
-Q: Want to switch from source to packages?
-A: The cleanup function automatically handles this!
-   Just run ./install.sh again and choose packages
-
-
-MORE INFO:
---
-See INSTALL_METHOD_GUIDE.md for detailed documentation
-See Install-Logs/ directory for error details if something fails
-
-
-READY TO GO:
---
-./install.sh
--- a/install.sh
+++ b/install.sh
@ -1,10 +1,6 @@
 #!/bin/bash
 # https://github.com/JaKooLit

-# Source location for pre-built Debian packages (can be local or network share)
-# Set this variable to the path containing .deb files, or leave empty to build from source
-DEB_PACKAGES_SOURCE="/mnt/nas/Projects/Jak/debian-pkg/build/debs"
-
 clear

 # Set some colors for output messages
@ -120,99 +116,6 @@ echo -e "\e[35m
 \e[0m"
 printf "\n%.0s" {1..1}

-# Function to clean up existing Hyprland installations
-clean_existing_hyprland() {
-    echo "${INFO} Checking for existing Hyprland installations..." | tee -a "$LOG"
-    
-    # List of Hyprland-related packages and binaries to check
-    local hyprland_packages=("hyprland" "hyprutils" "hyprgraphics" "hyprcursor" "hyprtoolkit" "hyprland-guiutils" "hyprwire" "aquamarine" "hypridle" "hyprlock" "hyprpolkitagent" "hyprpicker" "xdg-desktop-portal-hyprland" "hyprland-plugins")
-    local hyprland_binaries=("/usr/local/bin/Hyprland" "/usr/local/bin/hyprland" "/usr/bin/Hyprland" "/usr/bin/hyprland")
-    
-    # Remove installed .deb packages
-    echo "${INFO} Removing any previously installed .deb packages..." | tee -a "$LOG"
-    for pkg in "${hyprland_packages[@]}"; do
-        if dpkg -l | grep -q "^ii.*$pkg"; then
-            echo "${NOTE} Removing package: $pkg" | tee -a "$LOG"
-            sudo apt-get remove -y "$pkg" 2>&1 | grep -E "(Setting up|Removing)" | tee -a "$LOG" || true
-        fi
-    done
-    
-    # Remove binaries built from source
-    echo "${INFO} Checking for binaries built from source..." | tee -a "$LOG"
-    for binary in "${hyprland_binaries[@]}"; do
-        if [ -e "$binary" ]; then
-            echo "${NOTE} Removing binary: $binary" | tee -a "$LOG"
-            sudo rm -f "$binary"
-        fi
-    done
-    
-    # Remove development files from /usr/local
-    if [ -d "/usr/local/include/hyprland" ] || [ -d "/usr/local/lib/libhypr" ]; then
-        echo "${INFO} Removing development files from /usr/local..." | tee -a "$LOG"
-        sudo rm -rf /usr/local/include/hyprland* 2>/dev/null || true
-        sudo rm -rf /usr/local/lib/libhypr* 2>/dev/null || true
-        sudo rm -rf /usr/local/lib/libaquamarine* 2>/dev/null || true
-        sudo rm -rf /usr/local/lib/libypr* 2>/dev/null || true
-        sudo ldconfig 2>/dev/null || true
-    fi
-    
-    echo "${OK} Cleanup completed" | tee -a "$LOG"
-}
-
-# Function to install packages from pre-built .deb files
-install_from_packages() {
-    echo "${INFO} Installing from pre-built packages at: ${SKY_BLUE}$DEB_PACKAGES_SOURCE${RESET}" | tee -a "$LOG"
-    
-    if [ ! -d "$DEB_PACKAGES_SOURCE" ]; then
-        echo "${ERROR} Package source directory not found: $DEB_PACKAGES_SOURCE" | tee -a "$LOG"
-        return 1
-    fi
-    
-    local pkg_count=$(find "$DEB_PACKAGES_SOURCE" -name "*.deb" | wc -l)
-    if [ "$pkg_count" -eq 0 ]; then
-        echo "${ERROR} No .deb files found in $DEB_PACKAGES_SOURCE" | tee -a "$LOG"
-        return 1
-    fi
-    
-    echo "${INFO} Found ${SKY_BLUE}$pkg_count${RESET} .deb packages" | tee -a "$LOG"
-    
-    # Clean up existing installations before installing from packages
-    echo "${CAT} Removing existing Hyprland installations to avoid conflicts..." | tee -a "$LOG"
-    clean_existing_hyprland
-    
-    # Update package cache after cleanup
-    echo "${INFO} Updating package cache..." | tee -a "$LOG"
-    sudo apt-get update 2>&1 | tail -3 | tee -a "$LOG"
-    
-    # Install core packages only (skip plugins and debug symbols)
-    echo "${INFO} Installing core Hyprland packages (excluding plugins and debug symbols)..." | tee -a "$LOG"
-    
-    # Install only essential packages, skip plugins and dbgsym
-    for deb in "$DEB_PACKAGES_SOURCE"/*.deb; do
-        filename=$(basename "$deb")
-        
-        # Skip debug symbols and plugins
-        if [[ "$filename" == *"-dbgsym_"* ]]; then
-            continue
-        fi
-        if [[ "$filename" == "hyprland-plugin-"* ]]; then
-            continue
-        fi
-        
-        echo "${INFO} Installing: $filename" | tee -a "$LOG"
-        sudo dpkg -i "$deb" 2>&1 | tee -a "$LOG" || true
-    done
-    
-    # Fix any dependency issues
-    echo "${INFO} Fixing any dependency issues..." | tee -a "$LOG"
-    sudo apt-get install -f -y 2>&1 | tail -5 | tee -a "$LOG"
-    
-    echo "${OK} Core package installation completed!" | tee -a "$LOG"
-    echo "${NOTE} To install plugins, run: sudo dpkg -i $DEB_PACKAGES_SOURCE/hyprland-plugin-*.deb" | tee -a "$LOG"
-    echo "${NOTE} To install debug symbols, run: sudo dpkg -i $DEB_PACKAGES_SOURCE/*-dbgsym*.deb" | tee -a "$LOG"
-    return 0
-}
-
 # Welcome message using whiptail (for displaying information)
 whiptail --title "KooL Debian-Hyprland Trixie+ (2025) Install Script" \
    --msgbox "Welcome to KooL Debian-Hyprland Trixie+  (2025) Install Script!!!\n\n\
@ -220,27 +123,9 @@ ATTENTION: Run a full system update and Reboot first !!! (Highly Recommended)\n\
 NOTE: If you are installing on a VM, ensure to enable 3D acceleration otherwise Hyprland may NOT start!" \
    15 80

-# Ask user to choose build method
-build_method="source"
-if [ -d "$DEB_PACKAGES_SOURCE" ] && [ "$(find "$DEB_PACKAGES_SOURCE" -name "*.deb" 2>/dev/null | wc -l)" -gt 0 ]; then
-    if whiptail --title "Build Method" \
-        --yesno "Pre-built Hyprland packages are available at:\n$DEB_PACKAGES_SOURCE\n\nWould you like to install from pre-built packages?\n\nSelect YES for faster installation from packages\nSelect NO to build from source (takes longer)" 15 70; then
-        build_method="packages"
-        echo "${OK} Selected build method: ${SKY_BLUE}Pre-built Packages${RESET}" | tee -a "$LOG"
-    else
-        echo "${OK} Selected build method: ${SKY_BLUE}From Source${RESET}" | tee -a "$LOG"
-    fi
-fi
-
 # Ask if the user wants to proceed
-if [ "$build_method" = "packages" ]; then
-    proceed_msg="Build method: PRE-BUILT PACKAGES\n\nThis will install pre-compiled Hyprland packages from the shared location.\n\nShall we proceed?"
-else
-    proceed_msg="Build method: FROM SOURCE\n\nVERY IMPORTANT!!!\nYou must be able to install from source by uncommenting deb-src on /etc/apt/sources.list else script may fail.\n\nShall we proceed?"
-fi
-
 if ! whiptail --title "Proceed with Installation?" \
-    --yesno "$proceed_msg" 15 60; then
+    --yesno "VERY IMPORTANT!!!\n\nYou must be able to install from source by uncommenting deb-src on /etc/apt/sources.list else script may fail to install Hyprland.\n\n\nShall we proceed?" 15 60; then
    echo -e "\n"
    echo "❌ ${INFO} You 🫵 chose ${YELLOW}NOT${RESET} to proceed. ${YELLOW}Exiting...${RESET}" | tee -a "$LOG"
    echo -e "\n"
@ -490,69 +375,56 @@ echo "${INFO} Installing ${SKY_BLUE}necessary fonts...${RESET}" | tee -a "$LOG"
 sleep 1
 execute_script "fonts.sh"

-# Build method selection: from source or pre-built packages
-if [ "$build_method" = "packages" ]; then
-    echo "${INFO} Installing from ${SKY_BLUE}pre-built packages${RESET}..." | tee -a "$LOG"
-    sleep 1
-    if install_from_packages; then
-        echo "${OK} Pre-built packages installed successfully!" | tee -a "$LOG"
-    else
-        echo "${ERROR} Failed to install pre-built packages. Exiting..." | tee -a "$LOG"
-        exit 1
-    fi
-else
-    # Build from source (original method)
-    # Optional: refresh tags before building the Hyprland stack
-    # Set FETCH_LATEST=1 to opt-in (default is no-refresh to honor pinned tags)
-    if [ "${FETCH_LATEST:-0}" = "1" ] && [ -f ./refresh-hypr-tags.sh ]; then
+# Optional: refresh tags before building the Hyprland stack
+# Set FETCH_LATEST=1 to opt-in (default is no-refresh to honor pinned tags)
+if [ "${FETCH_LATEST:-0}" = "1" ] && [ -f ./refresh-hypr-tags.sh ]; then
    chmod +x ./refresh-hypr-tags.sh || true
    ./refresh-hypr-tags.sh
-    fi
-
-    echo "${INFO} Installing ${SKY_BLUE}KooL Hyprland packages from source...${RESET}" | tee -a "$LOG"
-    sleep 1
-    execute_script "01-hypr-pkgs.sh"
-    sleep 1
-    execute_script "hyprutils.sh"
-    sleep 1
-    execute_script "hyprlang.sh"
-    sleep 1
-    execute_script "hyprcursor.sh"
-    sleep 1
-    execute_script "hyprwayland-scanner.sh"
-    sleep 1
-    execute_script "hyprgraphics.sh"
-    sleep 1
-    execute_script "aquamarine.sh"
-    sleep 1
-    execute_script "hyprland-qt-support.sh"
-    sleep 1
-    execute_script "hyprtoolkit.sh"
-    sleep 1
-    execute_script "hyprland-guiutils.sh"
-    sleep 1
-    execute_script "hyprland-protocols.sh"
-    sleep 1
-    # Ensure wayland-protocols (from source) is installed to satisfy Hyprland's >= 1.45 requirement
-    execute_script "wayland-protocols-src.sh"
-    sleep 1
-    execute_script "xkbcommon.sh"
-    sleep 1
-    execute_script "hyprland.sh"
-    sleep 1
-    execute_script "hyprpolkitagent.sh"
-    sleep 1
-    execute_script "wallust.sh"
-    sleep 1
-    execute_script "swww.sh"
-    sleep 1
-    execute_script "rofi-wayland.sh"
-    sleep 1
-    execute_script "hyprlock.sh"
-    sleep 1
-    execute_script "hypridle.sh"
 fi

+echo "${INFO} Installing ${SKY_BLUE}KooL Hyprland packages...${RESET}" | tee -a "$LOG"
+sleep 1
+execute_script "01-hypr-pkgs.sh"
+sleep 1
+execute_script "hyprutils.sh"
+sleep 1
+execute_script "hyprlang.sh"
+sleep 1
+execute_script "hyprcursor.sh"
+sleep 1
+execute_script "hyprwayland-scanner.sh"
+sleep 1
+execute_script "hyprgraphics.sh"
+sleep 1
+execute_script "aquamarine.sh"
+sleep 1
+execute_script "hyprland-qt-support.sh"
+sleep 1
+execute_script "hyprtoolkit.sh"
+sleep 1
+execute_script "hyprland-guiutils.sh"
+sleep 1
+execute_script "hyprland-protocols.sh"
+sleep 1
+# Ensure wayland-protocols (from source) is installed to satisfy Hyprland's >= 1.45 requirement
+execute_script "wayland-protocols-src.sh"
+sleep 1
+execute_script "xkbcommon.sh"
+sleep 1
+execute_script "hyprland.sh"
+sleep 1
+execute_script "hyprpolkitagent.sh"
+sleep 1
+execute_script "wallust.sh"
+sleep 1
+execute_script "swww.sh"
+sleep 1
+execute_script "rofi-wayland.sh"
+sleep 1
+execute_script "hyprlock.sh"
+sleep 1
+execute_script "hypridle.sh"
+
 #execute_script "imagemagick.sh" #this is for compiling from source. 07 Sep 2024
 # execute_script "waybar-git.sh" only if waybar on repo is old