Merge pull request #229 from JaKooLit/development

Development to main,  Updated HL to 0.52.2

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

CHANGELOGS.md

@@ -1,190 +1,348 @@
 ## CHANGELOGS
 
+## 10 December 2025
+
+- Updated:
+    - Hyprland Build to v0.52.2
+    - Thanks entirely to @sdegler
+- Fixed:
+    - `qt5-style-kvantum-themes` failed to install
+        - Wrong package name it's `qt-style-kvantume-themes`
+    - `libdisplay-info2` failed to install
+        - New package name: `libdisplay-info3`
+
+## 10 October 2025
+
+### Hyprland 0.51.x install support
+
+-     Hyprland builds 0.51.x from source
+-     Added documentation for upgrading from 0.49/0.50.x to 0.51.1.
+
+### New scripts and modules
+
+    - update-hyprland.sh: Manage the Hyprland stack with:
+      - --install / --dry-run build modes
+      - --only and --skip for selective components
+      - --with-deps to (re)install build deps
+      - --set {KEY=TAG} and --restore tag backup support
+      - --fetch-latest to pull latest GitHub release tags
+      - --via-helper to delegate summary-only dry-runs
+    - dry-run-build.sh: Compile-only helper with summary output
+    - install-scripts/wayland-protocols-src.sh: Build wayland-protocols from
+      source (>= 1.45) to satisfy Hyprland 0.51.x requirements
+
+### Core features
+
+    - Centralized tag management via hypr-tags.env; tags exported to all
+      modules. Environment overrides remain first priority.
+    - Automatic dependency ordering for Hyprland 0.51.x:
+      wayland-protocols-src → hyprland-protocols → hyprutils → hyprlang →
+      aquamarine → hyprland
+    - Optional auto-fetch of latest tags on install runs that include
+      hyprland (can be disabled via --no-fetch)
+    - Selective updates for targeted components and skip lists
+    - Dry-run mode to validate builds without installing
+
+### Installer integration
+
+    - install.sh reads hypr-tags.env and optionally refreshes tags.
+    - Ensures wayland-protocols-src is built before Hyprland.
+    - Maintains proper sequencing for the Hyprland dependencies.
+
+### Docs
+
+    - Debian-Hyprland-Install-Upgrade.md and .es.md:
+      - Add explicit section: Upgrade 0.49/0.50.x → 0.51.1
+      - Recommend: `./update-hyprland.sh --install --only hyprland`
+      - Provide optional `--with-deps` and `--dry-run` flows
+    - Full install via install.sh is not required for this
+      upgrade unless optional modules need refresh
+
+### Usage highlights
+
+    - Pin and upgrade to 0.51.1:
+      ./update-hyprland.sh --set HYPRLAND=v0.51.1
+      ./update-hyprland.sh --install --only hyprland
+    - Optional:
+      ./update-hyprland.sh --with-deps --install --only hyprland
+      ./update-hyprland.sh --dry-run --only hyprland
+
+### Notes
+
+    - Target OS remains Debian Trixie/Testing/SID
+    - Run as sudo-capable user (not root)
+    - Ensure deb-src entries are enabled.
+
+## 22 July 2025
+
+- Updated sddm theme and script to work with the updated simple_sddm_2 theme
+- Manual building process
+
+## 21 June 2025
+
+- Added a warning message that support is now very limited
+
+## 08 June 2025
+
+- updated SDDM theme.
+
+## 20 March 2025
+
+- added findutils as dependencies
+
+## 11 March 2025
+
+- Added uninstall script
+- forked AGS v1 into JakooLit repo. This is just incase Aylur decide to take down v1
+
+## 10 March 2025
+
+- Dropped pyprland in favor of hyprland built in tool for a drop down like terminal and Desktop magnifier
+
+## 06 March 2025
+
+- Switched to whiptail version for Y & N questions
+- switched eza to lsd
+
 ## 23 Feb 2025
+
 - added Victor Mono Font for proper hyprlock font rendering for Dots v2.3.12
 - added Fantasque Sans Mono Nerd for Kitty
 
 ## 22 Feb 2025
+
 - replaced eog with loupe
 - changed url for installing oh-my-zsh to get wider coverage. Some countries are blocking github raw url's
 
 ## 18 Feb 2025
+
 - Change default zsh theme to adnosterzak
 - pokemon coloscript integrated with fastfetch when opted with pokemon to add some bling
 - additional external oh-my-zsh theme
 
 ## 06 Feb 2025
+
 - added semi-unattended function.
 - move all the initial questions at the beginning
 
 ## 04 Feb 2025
+
 - Re-coded for better visibility
 - Offered a new SDDM theme.
 - script will automatically detect if you have nvidia but script still offer if you want to set up for user
 
 ## 30 Jan 2025
+
 - AGS (aylur's GTK shell) v1 for desktop overview is now optional
 
 ## 12 Jan 2025
+
 - switch to final version of aylurs-gtk-shell-v1
 
 ## 01 Jan 2025
+
 - Switched to download dots from KooL's Hyprland dots specific branch
 
 ## 26 Dec 2024
+
 - Removal of Bibata Ice cursor on assets since its integrated in the GTK Themes and Icons extract from a separate repo
 
 ## 10 Dec 2024
+
 - updated swww.sh to download from version v0.9.5
 
 ## 24 Nov 2024
+
 - switched to download rofi-wayland from releases instead from upstream
 
 ## 20 Sep 2024
+
 - User will be ask if they want to set Thunar as default file manager if they decided to install it
 
 ## 19 Sep 2024
+
 - updated xdph installation since it is now in Debian Repo
 - Added fastfetch on tty. However, will be disabled if user decided to install pokemon colorscripts
 
 ## 14 Sep 2024
+
 - Added Essential Packages final check in lieu of errors from Install log files in Install-Logs directory
 - nwg-look is now in Debian Repo
 
 ## 10 Sep 2024
+
 - added background check of known login managers if they are active if user chose to install sddm
 
 ## 08 Sep 2024
+
 - Added final error checks on install-logs
 
 ## 07 Sep 2024
+
 - Fix installation issue on hyprlock and xdph
 - disabled imagemagick compilation from source
 - dotfiles adjusted so it will be compatible for imagemagick v6
 
 ## 04 Sep 2024
+
 - added a function to check if it is Ubuntu or Based on Ubuntu and script will exit
 
 ## 28 Aug 2024
+
 - Added final check if hyprland is installed and will give an error to user
 
 ## 24 Aug 2024
+
 - Created a newer and compatible Hyprland-Dots repo
 -
+
 ## 23 Aug 2024
+
 - Moved Ubuntu-Hyprland on a separate Github Repo
 
 ## 22 Aug 2024
+
 - refactor Debian-Hyprland script. As Hyprland is now in official repo
 
 ## 07 Jul 2024
+
 - added eza (ls replacement for tty). Note only on .zshrc
 
 ## 06 July 2024
+
 - Version bumps for Debian (Hyprland v0.41.2)
 
 ## 11 June 2024
+
 - adjusted script to install only Hyprland-Dots v2.2.14
 
 ## 10 June 2024
+
 - changed behaviour of rofi-wayland.sh. To redownload a new rofi-wayland from repo instead of pulling changes. (It proves giving issue)
 
 ## 04 June 2024
+
 - switched over to source install for imagemagick
 - removal of fzf for Debian and Ubuntu (headache)
 
 ## 26 May 2024
+
 - Added fzf for zsh (CTRL R to invoke FZF history)
 
 ## 23 May 2024
+
 - added qalculate-gtk to work with rofi-calc. Default keybinds (SUPER ALT C)
 - added power-profiles-daemon for ROG laptops. Note, I cant add to all since it conflicts with TLP, CPU-Auto-frequency etc.
 - Note: Fastfetch configs will be added from Hyprland-Dots v2.2.12. However, you need to install from Fastfetch github page
 
 ## 19 May 2024
+
 - Disabled the auto-login in .zprofile as it causes auto-login to Hyprland if any wayland was chosen. Can enabled if only using hyprland
 
 ## 15 May 2025
+
 - Backed down hyprland version to install as v0.40.0 is failing to install
 - removed from waybar-git to install. Instead to install from official repo
 - cliphist install script is removed as it is now on Debian repo
 - dependencies cleaned up and added
 
 ## 10 May 2024
+
 - added wallust-git and remove python-pywal for migration to wallust on Hyprland-Dots v2.2.11
 
 ## 07 May 2024
+
 - added ags.sh for upcoming ags overview for next Hyprland-Dots release. Will be installed form source
 - added manual installation of waybar since Debian is very slow in updating their packages
 
 ## 03 May 2024
+
 - Bump swww to v0.9.5
 - added python3-pyquery for new weather-waybar python based on Hyprland-Dots
 
 ## 02 May 2024
+
 - Added pyprland (hyprland plugin) - warning, I cant make it to properly run. Drop Down terminal not working, zoom is hit and miss
 
 ## 30 Apr 2024
+
 - Updated hyprland.sh to install v0.39.1 Hyprland
 - adding hypridle and hyprlock
 - dropping swaylock-effects and swayidle
 - adjusted to work with current Hyprland-Dots
 
 ## 22 Apr 2024
+
 - Change dotfiles to specific version only as Debian and Ubuntu cant keep up with Hyprland development
 
 ## 20 Apr 2024
+
 - Change default Oh-my-zsh theme to xiong-chiamiov-plus
 
 ## 11 Jan 2024
+
 - dropped wlsunset
 - added hyprlang build and install
 
 ## 02 Jan 2024
+
 - Readme updated for cliphist instruction for ubuntu 23.10 users
 - Created cliphist.sh for ubuntu 23.10 users (disabled by default and needs to be enabled on install.sh if desired)
 
 ## 30 December 2023
+
 - Code Cleaned up.
 - Pokemon Color Scripts now offered as optional
 
 ## 29 December 2023
+
 - Remove dunst in favor of swaync. NOTE: Part of the script is to also uninstall mako and dunst (if installed) as on my experience, dunst is sometimes taking over the notification even if it is not set to start
 
 ## 16 Dec 2023
+
 - zsh theme switched to `agnoster` theme by default
 - pywal tty color change disabled by default
 
 ## 13 Dec 2023
+
 - Added a script / function to force install packages. Some users reported that it is not installed.
 
 ## 11 Dec 2023
+
 - Changing over to zsh automatically if user opted
 - If chose to install zsh and have no login manager, zsh auto login will auto start Hyprland
 - added as optional, with zsh, pokemon colorscripts
 - improved zsh install scripts, so even the existing zsh users of can still opt for zsh and oh-my-zsh installation :)
 
 ## 03 Dec 2023
+
 - Added kvantum for qt apps theming
 - return of wlogout due to theming issues of rofi-power
 
 ## 1 Dec 2023
+
 - replace the Hyprland to specific branch/version as newest needed some new libraries and debian dont have those yet
 
 ## 26 Nov 2023
+
 - nvidia - Move to normal hyprland package as nvidia patches are doing nothing see [`commit`](https://github.com/hyprwm/Hyprland/commit/cd96ceecc551c25631783499bd92c6662c5d3616)
 
 ## 25 Nov 2023
+
 - drop wlogout since Hyprland-Dots v2.1.9 uses rofi-power
 
 ## 23-Nov-2023
+
 - Added Bibata cursor to install if opted for GTK Themes. However, it is not pre-applied. Use nwg-look utility to apply
 
 ## 19-Nov-2023
+
 - Adjust dotfiles script to download from releases instead of from upstream
 
 ## 14-Oct-2023
+
 - initial release. Added swappy for screenshots
 
 ## 12-Oct-2023
+
 - BETA release

CONTRIBUTING.md

@@ -1,6 +1,6 @@
-# Contributing to Community Standards
+# Contributing to KooL Hyprland Projects
 
-Thank you for your interest in contributing to Community Standards! We welcome any contributions, including bug fixes, feature enhancements, documentation improvements, and other general improvements.
+Thank you for your interest in contributing to KooL Hyprland Projects! We welcome any contributions, including bug fixes, feature enhancements, documentation improvements, and other general improvements.
 
 ## Getting Started
 
@@ -55,10 +55,9 @@ Thank you for your interest in contributing to Community Standards! We welcome a
 - Make sure all tests pass or fully tested before submitting your changes.
 - Keep your pull request focused and avoid including unrelated changes.
 - Remember to follow the following files before submitting your changes.
-  - [bug_report.md](https://github.com/JaKooLit/Debian-Hyprland/blob/main/.github/ISSUE_TEMPLATE/bug_report.md) - Use this template to create a report to help us improve.
-  - [feature_request.md](https://github.com/JaKooLit/Debian-Hyprland/blob/main/.github/ISSUE_TEMPLATE/feature_request.md) - Use this template to suggest a feature for this project.
-  - [documentation_update.md](https://github.com/JaKooLit/Debian-Hyprland/blob/main/.github/ISSUE_TEMPLATE/documentation_update.md) - Use this template to propose a change to the documentation.
-  - [custom.md](https://github.com/JaKooLit/Debian-Hyprland/blob/main/.github/ISSUE_TEMPLATE/custom.md) - Use this template to submit a custom issue.
+  - [bug.yml](https://github.com/JaKooLit/Debian-Hyprland/blob/main/.github/ISSUE_TEMPLATE/bug.yml) - Use this template to create a report to help us improve.
+  - [feature.yml](https://github.com/JaKooLit/Debian-Hyprland/blob/main/.github/ISSUE_TEMPLATE/feature.yml) - Use this template to suggest a feature for this project.
+  - [documentation-update.yml](https://github.com/JaKooLit/Debian-Hyprland/blob/main/.github/ISSUE_TEMPLATE/documentation-update.yml) - Use this template to propose a change to the documentation.
   - [PULL_REQUEST_TEMPLATE.md](https://github.com/JaKooLit/Debian-Hyprland/blob/main/.github/PULL_REQUEST_TEMPLATE.md) - Use this template to submit a pull request.
   - [COMMIT_MESSAGE_GUIDELINES.md](https://github.com/JaKooLit/Debian-Hyprland/blob/main/COMMIT_MESSAGE_GUIDELINES.md) - Read this file to learn about the commit message guidelines.
   - [CONTRIBUTING.md](https://github.com/JaKooLit/Debian-Hyprland/blob/main/CONTRIBUTING.md) - Read this file to learn about the contributing guidelines.
@@ -67,4 +66,4 @@ Thank you for your interest in contributing to Community Standards! We welcome a
 
 ## Contact
 
-If you have any questions, feel free to contact via [GitHub Discussions](https://github.com/JaKooLit/Debian-Hyprland/discussions) or [Through Discord Server](https://discord.gg/V2SJ92vbEN)
+If you have any questions, feel free to contact via [GitHub Discussions](https://github.com/JaKooLit/Debian-Hyprland/discussions) or [Through Discord Server](https://discord.gg/kool-tech-world)

Debian-Hyprland-Install-Upgrade.es.md

@@ -0,0 +1,423 @@
+# Guía de Instalación y Actualización de Debian-Hyprland
+
+Esta guía cubre los flujos de instalación y actualización mejorados para el proyecto Debian-Hyprland de KooL, incluyendo nuevas funciones de automatización, gestión centralizada de versiones y capacidades de dry-run.
+
+## Tabla de Contenidos
+
+1. [Resumen](#resumen)
+2. [Nuevas Funciones](#nuevas-funciones)
+3. [Gestión Central de Versiones](#gestión-central-de-versiones)
+4. [Métodos de Instalación](#métodos-de-instalación)
+5. [Flujos de Actualización](#flujos-de-actualización)
+6. [Pruebas con Dry-Run](#pruebas-con-dry-run)
+7. [Gestión de Logs](#gestión-de-logs)
+8. [Uso Avanzado](#uso-avanzado)
+9. [Solución de Problemas](#solución-de-problemas)
+
+## Resumen
+
+El proyecto Debian-Hyprland ahora incluye herramientas de automatización y gestión mejoradas, manteniendo la compatibilidad con el script original install.sh. Las principales adiciones son:
+
+- **Gestión centralizada de versiones** mediante `hypr-tags.env`
+- **Orden automático de dependencias** para los requisitos de Hyprland 0.51.x
+- **Pruebas de compilación con dry-run** sin modificar el sistema
+- **Actualizaciones selectivas de componentes** con `update-hyprland.sh`
+- **Obtención automática de últimas versiones** desde GitHub
+
+## Nuevas Funciones
+
+### install.sh mejorado
+El script original ahora:
+
+- **Unifica versiones**: Lee `hypr-tags.env` y exporta variables de versión a todos los módulos
+- **wayland-protocols automático**: Instala wayland-protocols desde el código fuente (≥1.45) antes de Hyprland
+- **Orden robusto de dependencias**: Garantiza la secuencia correcta de requisitos
+
+### Nuevos Scripts
+
+#### update-hyprland.sh
+Herramienta enfocada para gestionar y compilar solo el stack de Hyprland:
+```bash
+chmod +x ./update-hyprland.sh
+./update-hyprland.sh --help  # Ver todas las opciones
+```
+
+#### dry-run-build.sh
+Herramienta de pruebas que compila componentes sin instalarlos:
+```bash
+chmod +x ./dry-run-build.sh
+./dry-run-build.sh --help  # Ver todas las opciones
+```
+
+#### wayland-protocols-src.sh
+Módulo que compila wayland-protocols desde el origen para satisfacer los requisitos de Hyprland 0.51.x.
+
+## Gestión Central de Versiones
+
+### hypr-tags.env
+Archivo con etiquetas de versión para todos los componentes de Hyprland:
+
+```bash
+# Versiones actuales (ejemplo)
+HYPRLAND_TAG=v0.51.1
+AQUAMARINE_TAG=v0.9.3
+HYPRUTILS_TAG=v0.8.2
+HYPRLANG_TAG=v0.6.4
+HYPRGRAPHICS_TAG=v0.1.5
+HYPRWAYLAND_SCANNER_TAG=v0.4.5
+HYPRLAND_PROTOCOLS_TAG=v0.6.4
+HYPRLAND_QT_SUPPORT_TAG=v0.1.0
+HYPRLAND_QTUTILS_TAG=v0.1.4
+WAYLAND_PROTOCOLS_TAG=1.45
+```
+
+### Prioridad de Sobrescritura de Versiones
+1. Variables de entorno (exportadas)
+2. Valores en el archivo `hypr-tags.env`
+3. Valores por defecto en cada módulo
+
+## Métodos de Instalación
+
+### Método 1: Instalación Completa Original
+```bash
+# Instalación estándar con todos los componentes
+chmod +x install.sh
+./install.sh
+```
+
+Ahora, este método automáticamente:
+- Carga versiones desde `hypr-tags.env`
+- Instala wayland-protocols desde el origen antes de Hyprland
+- Mantiene el orden correcto de dependencias
+
+### Método 2: Solo el Stack de Hyprland
+```bash
+# Instala solo Hyprland y componentes esenciales
+./update-hyprland.sh --install
+```
+
+### Método 3: Instalación Nueva con Últimas Versiones
+```bash
+# Obtiene últimas versiones de GitHub e instala
+./update-hyprland.sh --fetch-latest --install
+```
+
+### Método 4: Instalación con Preset
+```bash
+# Usa un preset para elecciones automáticas
+./install.sh --preset ./preset.sh
+```
+
+## Flujos de Actualización
+
+Enlace rápido: [Actualización 0.49/0.50.x → 0.51.1](#actualización-049050x--0511)
+
+### Actualizar a la Última Versión de Hyprland
+
+#### Opción A: Descubrimiento Automático
+```bash
+# Obtiene las últimas etiquetas e instala
+./update-hyprland.sh --fetch-latest --install
+```
+
+#### Opción B: Versión Específica
+```bash
+# Establece una versión específica de Hyprland
+./update-hyprland.sh --set HYPRLAND=v0.51.1 --install
+```
+
+#### Opción C: Probar Antes de Instalar
+```bash
+# Prueba la compilación primero, luego instala si es exitoso
+./update-hyprland.sh --fetch-latest --dry-run
+# Si es exitoso:
+./update-hyprland.sh --install
+```
+
+### Actualizar Componentes Individuales
+
+```bash
+# Actualiza solo librerías núcleo (a menudo necesario para nuevas versiones de Hyprland)
+./update-hyprland.sh --fetch-latest --install --only hyprutils,hyprlang
+
+# Actualiza aquamarine específicamente
+./update-hyprland.sh --set AQUAMARINE=v0.9.3 --install --only aquamarine
+```
+
+### Actualizaciones Selectivas
+
+```bash
+# Instalar todo excepto los componentes Qt
+./update-hyprland.sh --install --skip hyprland-qt-support,hyprland-qtutils
+
+# Instalar solo componentes específicos
+./update-hyprland.sh --install --only hyprland,aquamarine
+```
+
+### Actualización: 0.49/0.50.x ➜ 0.51.1
+
+Si actualmente estás en Hyprland 0.49 o 0.50.x, puedes actualizar directamente a 0.51.1 sin una reinstalación completa.
+
+Ruta recomendada:
+```bash
+# Asegura que hypr-tags.env apunte a la versión objetivo (omitir si ya es v0.51.1)
+./update-hyprland.sh --set HYPRLAND=v0.51.1
+
+# Actualiza Hyprland (los prerrequisitos se incluyen y ordenan automáticamente)
+./update-hyprland.sh --install --only hyprland
+```
+
+Notas:
+- El comando garantiza y ejecuta, según sea necesario: wayland-protocols-src, hyprland-protocols, hyprutils, hyprlang, aquamarine y luego hyprland.
+- No es necesario usar install.sh para esta actualización, a menos que también quieras instalar/actualizar módulos opcionales (p. ej., SDDM, Bluetooth, Thunar, AGS, dotfiles) o estés recuperándote de una instalación fallida/parcial.
+- Opcional: agrega --with-deps para reinstalar dependencias primero:
+```bash
+./update-hyprland.sh --with-deps --install --only hyprland
+```
+- Puedes hacer un dry-run primero para validar:
+```bash
+./update-hyprland.sh --dry-run --only hyprland
+```
+
+## Pruebas con Dry-Run
+
+### ¿Por qué usar Dry-Run?
+- Probar compatibilidad de compilación antes de instalar
+- Validar combinaciones de versiones
+- Depurar problemas de compilación sin cambios en el sistema
+- Integración en CI/CD
+
+### Uso Básico de Dry-Run
+
+```bash
+# Probar la configuración actual de versiones
+./update-hyprland.sh --dry-run
+
+# Probar con últimas versiones de GitHub
+./update-hyprland.sh --fetch-latest --dry-run
+
+# Probar una versión específica
+./update-hyprland.sh --set HYPRLAND=v0.51.1 --dry-run
+```
+
+### Pruebas Avanzadas con Dry-Run
+
+```bash
+# Formato alternativo de resumen
+./update-hyprland.sh --via-helper
+
+# Probar con instalación de dependencias
+./dry-run-build.sh --with-deps
+
+# Probar solo componentes específicos
+./dry-run-build.sh --only hyprland,aquamarine
+```
+
+### Limitaciones de Dry-Run
+- **Las dependencias se instalan**: apt se ejecuta para asegurar la compilación
+- **Requisitos de pkg-config**: Algunos componentes necesitan requisitos instalados en el sistema
+- **Sin cambios en el sistema**: No instala archivos en /usr/local o /usr
+
+## Gestión de Logs
+
+### Ubicación de Logs
+Todas las actividades de construcción generan logs con sello de tiempo en:
+```
+Install-Logs/
+├── 01-Hyprland-Install-Scripts-YYYY-MM-DD-HHMMSS.log  # Log principal de instalación
+├── install-DD-HHMMSS_module-name.log                   # Logs por módulo
+├── build-dry-run-YYYY-MM-DD-HHMMSS.log                # Resumen de dry-run
+└── update-hypr-YYYY-MM-DD-HHMMSS.log                  # Resumen de actualización
+```
+
+### Análisis de Logs
+```bash
+# Ver el log de instalación más reciente
+ls -t Install-Logs/*.log | head -1 | xargs less
+
+# Buscar errores en un módulo específico
+grep -i error Install-Logs/install-*hyprland*.log
+
+# Ver resumen de dry-run
+cat Install-Logs/build-dry-run-*.log
+```
+
+### Retención de Logs
+- Los logs se acumulan con el tiempo para referencia histórica
+- Se recomienda limpieza manual periódica:
+```bash
+# Mantener solo logs de los últimos 30 días
+find Install-Logs/ -name "*.log" -mtime +30 -delete
+```
+
+## Uso Avanzado
+
+### Gestión de Versiones
+
+#### Copia de Seguridad y Restauración
+```bash
+# Las etiquetas se respaldan automáticamente cuando cambian
+# Restaurar la copia más reciente
+./update-hyprland.sh --restore --dry-run
+```
+
+#### Múltiples Conjuntos de Versiones
+```bash
+# Guardar configuración actual
+cp hypr-tags.env hypr-tags-stable.env
+
+# Probar versiones experimentales
+./update-hyprland.sh --fetch-latest --dry-run
+
+# Restaurar estable si es necesario
+cp hypr-tags-stable.env hypr-tags.env
+```
+
+### Integración con el Entorno
+
+#### PKG_CONFIG_PATH personalizado
+```bash
+# Asegurar que /usr/local tenga prioridad
+export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:/usr/local/share/pkgconfig:${PKG_CONFIG_PATH:-}"
+./update-hyprland.sh --install
+```
+
+#### Compilaciones en Paralelo
+```bash
+# Controlar el paralelismo (por defecto: todos los núcleos)
+export MAKEFLAGS="-j4"
+./update-hyprland.sh --install
+```
+
+### Flujo de Trabajo de Desarrollo
+
+#### Probar Nuevos Lanzamientos
+```bash
+# 1. Crear entorno de pruebas
+cp hypr-tags.env hypr-tags.backup
+
+# 2. Probar nueva versión
+./update-hyprland.sh --set HYPRLAND=v0.52.0 --dry-run
+
+# 3. Instalar si es exitoso
+./update-hyprland.sh --install
+
+# 4. Revertir si hay problemas
+./update-hyprland.sh --restore --install
+```
+
+#### Desarrollo de Componentes
+```bash
+# Solo instalar dependencias
+./update-hyprland.sh --with-deps --dry-run
+
+# Pruebas manuales de módulo
+DRY_RUN=1 ./install-scripts/hyprland.sh
+
+# Ver logs de un módulo específico
+tail -f Install-Logs/install-*hyprland*.log
+```
+
+## Solución de Problemas
+
+### Problemas Comunes
+
+#### Falla de Configuración con CMake
+**Síntomas**: "Package dependency requirement not satisfied"
+
+**Soluciones**:
+```bash
+# Instalar requisitos faltantes
+./update-hyprland.sh --install --only wayland-protocols-src,hyprutils,hyprlang
+
+# Limpiar caché de compilación
+rm -rf hyprland aquamarine hyprutils hyprlang
+
+# Reintentar instalación
+./update-hyprland.sh --install --only hyprland
+```
+
+#### Errores de Compilación
+**Síntomas**: "too many errors emitted"
+
+**Soluciones**:
+```bash
+# Actualizar dependencias núcleo primero
+./update-hyprland.sh --fetch-latest --install --only hyprutils,hyprlang
+
+# Revisar incompatibilidades de API en logs
+grep -A5 -B5 "error:" Install-Logs/install-*hyprland*.log
+```
+
+#### Etiqueta No Encontrada
+**Síntomas**: "Remote branch X not found"
+
+**Soluciones**:
+```bash
+# Ver etiquetas disponibles
+git ls-remote --tags https://github.com/hyprwm/Hyprland
+
+# Usar etiqueta confirmada
+./update-hyprland.sh --set HYPRLAND=v0.50.1 --install
+```
+
+### Pasos de Depuración
+
+1. **Verificar compatibilidad del sistema**:
+   ```bash
+   # Verificar versión de Debian
+   cat /etc/os-release
+   
+   # Asegurar deb-src habilitado
+   grep -E "^deb-src" /etc/apt/sources.list
+   ```
+
+2. **Verificar entorno**:
+   ```bash
+   # Ver etiquetas actuales
+   cat hypr-tags.env
+   
+   # Probar dry-run primero
+   ./update-hyprland.sh --dry-run --only hyprland
+   ```
+
+3. **Analizar logs**:
+   ```bash
+   # Errores más recientes
+   grep -i "error\|fail" Install-Logs/*.log | tail -20
+   
+   # Problemas por módulo
+   ls -la Install-Logs/install-*[component]*.log
+   ```
+
+### Obtener Ayuda
+
+1. **Revisar logs**: Consulte siempre Install-Logs/ para detalles
+2. **Probar dry-run**: Valide antes de instalar
+3. **Soporte de la comunidad**: Envíe issues con extractos de logs
+4. **Documentación**: Consulte README.md del proyecto para requisitos base
+
+## Migración desde Versiones Previas
+
+### Instalaciones Existentes
+Las nuevas herramientas funcionan junto a instalaciones existentes:
+
+```bash
+# Actualizar instalación existente
+./update-hyprland.sh --install
+
+# Probar sin afectar el sistema actual
+./update-hyprland.sh --dry-run
+```
+
+### Convertir a Gestión por Etiquetas
+```bash
+# Las versiones actuales se guardan en hypr-tags.env automáticamente
+# Verificar con:
+cat hypr-tags.env
+
+# Modificar versiones según necesidad:
+./update-hyprland.sh --set HYPRLAND=v0.51.1
+```
+
+El flujo mejorado ofrece mayor control, capacidad de prueba y automatización, manteniendo la compatibilidad total con el proceso de instalación original.

Debian-Hyprland-Install-Upgrade.md

@@ -0,0 +1,423 @@
+# Debian-Hyprland Install & Upgrade Guide
+
+This guide covers the enhanced installation and upgrade workflows for KooL's Debian-Hyprland project, including new automation features, centralized version management, and dry-run capabilities.
+
+## Table of Contents
+
+1. [Overview](#overview)
+2. [New Features](#new-features)
+3. [Central Version Management](#central-version-management)
+4. [Installation Methods](#installation-methods)
+5. [Upgrade Workflows](#upgrade-workflows)
+6. [Dry-Run Testing](#dry-run-testing)
+7. [Log Management](#log-management)
+8. [Advanced Usage](#advanced-usage)
+9. [Troubleshooting](#troubleshooting)
+
+## Overview
+
+The Debian-Hyprland project now includes enhanced automation and management tools while maintaining backward compatibility with the original install.sh script. The key additions are:
+
+- **Centralized version management** via `hypr-tags.env`
+- **Automated dependency ordering** for Hyprland 0.51.x requirements
+- **Dry-run compilation testing** without system modifications
+- **Selective component updates** via `update-hyprland.sh`
+- **GitHub latest tag fetching** for automatic version discovery
+
+## New Features
+
+### Enhanced install.sh
+The original install.sh script now includes:
+
+- **Tag consistency**: Reads `hypr-tags.env` and exports version variables to all modules
+- **Automatic wayland-protocols**: Installs wayland-protocols from source (≥1.45) before Hyprland
+- **Robust dependency ordering**: Ensures prerequisites are built in the correct sequence
+
+### New Scripts
+
+#### update-hyprland.sh
+A focused tool for managing and building just the Hyprland stack:
+```bash
+chmod +x ./update-hyprland.sh
+./update-hyprland.sh --help  # View all options
+```
+
+#### dry-run-build.sh
+A testing tool that compiles components without installing:
+```bash
+chmod +x ./dry-run-build.sh
+./dry-run-build.sh --help  # View all options
+```
+
+#### wayland-protocols-src.sh
+A new module that builds wayland-protocols from source to satisfy Hyprland 0.51.x requirements.
+
+## Central Version Management
+
+### hypr-tags.env
+This file contains version tags for all Hyprland components:
+
+```bash
+# Current versions (example)
+HYPRLAND_TAG=v0.51.1
+AQUAMARINE_TAG=v0.9.3
+HYPRUTILS_TAG=v0.8.2
+HYPRLANG_TAG=v0.6.4
+HYPRGRAPHICS_TAG=v0.1.5
+HYPRWAYLAND_SCANNER_TAG=v0.4.5
+HYPRLAND_PROTOCOLS_TAG=v0.6.4
+HYPRLAND_QT_SUPPORT_TAG=v0.1.0
+HYPRLAND_QTUTILS_TAG=v0.1.4
+WAYLAND_PROTOCOLS_TAG=1.45
+```
+
+### Version Override Priority
+1. Environment variables (exported)
+2. hypr-tags.env file values
+3. Default hardcoded values in each module
+
+## Installation Methods
+
+### Method 1: Original Full Installation
+```bash
+# Standard installation with all components
+chmod +x install.sh
+./install.sh
+```
+
+This method now automatically:
+- Loads versions from `hypr-tags.env`
+- Installs wayland-protocols from source before Hyprland
+- Maintains proper dependency ordering
+
+### Method 2: Hyprland Stack Only
+```bash
+# Install only Hyprland and essential components
+./update-hyprland.sh --install
+```
+
+### Method 3: Fresh Installation with Latest Versions
+```bash
+# Fetch latest GitHub releases and install
+./update-hyprland.sh --fetch-latest --install
+```
+
+### Method 4: Preset-Based Installation
+```bash
+# Use preset file for automated choices
+./install.sh --preset ./preset.sh
+```
+
+## Upgrade Workflows
+
+Quick link: [Upgrade 0.49/0.50.x → 0.51.1](#upgrade-049050x--0511)
+
+### Upgrading to Latest Hyprland Release
+
+#### Option A: Automatic Discovery
+```bash
+# Fetch latest tags and install
+./update-hyprland.sh --fetch-latest --install
+```
+
+#### Option B: Specific Version
+```bash
+# Set specific Hyprland version
+./update-hyprland.sh --set HYPRLAND=v0.51.1 --install
+```
+
+#### Option C: Test Before Installing
+```bash
+# Test compilation first, then install if successful
+./update-hyprland.sh --fetch-latest --dry-run
+# If successful:
+./update-hyprland.sh --install
+```
+
+### Upgrading Individual Components
+
+```bash
+# Update only core libraries (often needed for new Hyprland versions)
+./update-hyprland.sh --fetch-latest --install --only hyprutils,hyprlang
+
+# Update aquamarine specifically
+./update-hyprland.sh --set AQUAMARINE=v0.9.3 --install --only aquamarine
+```
+
+### Selective Updates
+
+```bash
+# Install everything except Qt components
+./update-hyprland.sh --install --skip hyprland-qt-support,hyprland-qtutils
+
+# Install only specific components
+./update-hyprland.sh --install --only hyprland,aquamarine
+```
+
+### Upgrade: 0.49/0.50.x ➜ 0.51.1
+
+If you’re currently on Hyprland 0.49 or 0.50.x, you can upgrade directly to 0.51.1 without a full reinstall.
+
+Recommended path:
+```bash
+# Ensure hypr-tags.env pins the target version (skip if already v0.51.1)
+./update-hyprland.sh --set HYPRLAND=v0.51.1
+
+# Upgrade Hyprland (prerequisites are auto-included and ordered)
+./update-hyprland.sh --install --only hyprland
+```
+
+Notes:
+- The command will automatically ensure and run, as needed: wayland-protocols-src, hyprland-protocols, hyprutils, hyprlang, aquamarine, then hyprland.
+- Full install via install.sh is not required for this upgrade unless you also want to install/refresh optional modules (e.g., SDDM, Bluetooth, Thunar, AGS, dotfiles) or you’re recovering from a failed/partial setup.
+- Optional: add --with-deps to re-run dependency installation first:
+```bash
+./update-hyprland.sh --with-deps --install --only hyprland
+```
+- You can dry-run first to validate:
+```bash
+./update-hyprland.sh --dry-run --only hyprland
+```
+
+## Dry-Run Testing
+
+### Why Use Dry-Run?
+- Test compilation compatibility before installing
+- Validate version combinations
+- Debug build issues without system changes
+- CI/CD pipeline integration
+
+### Basic Dry-Run Usage
+
+```bash
+# Test current tag configuration
+./update-hyprland.sh --dry-run
+
+# Test with latest GitHub releases
+./update-hyprland.sh --fetch-latest --dry-run
+
+# Test specific version
+./update-hyprland.sh --set HYPRLAND=v0.51.1 --dry-run
+```
+
+### Advanced Dry-Run Testing
+
+```bash
+# Use alternative summary format
+./update-hyprland.sh --via-helper
+
+# Test with dependencies installation
+./dry-run-build.sh --with-deps
+
+# Test only specific components
+./dry-run-build.sh --only hyprland,aquamarine
+```
+
+### Dry-Run Limitations
+- **Dependencies still install**: apt operations run to ensure compilation succeeds
+- **pkg-config requirements**: Some components need system-installed prerequisites
+- **No system changes**: No files installed to /usr/local or /usr
+
+## Log Management
+
+### Log Location
+All build activities generate timestamped logs in:
+```
+Install-Logs/
+├── 01-Hyprland-Install-Scripts-YYYY-MM-DD-HHMMSS.log  # Main install log
+├── install-DD-HHMMSS_module-name.log                   # Per-module logs
+├── build-dry-run-YYYY-MM-DD-HHMMSS.log                # Dry-run summary
+└── update-hypr-YYYY-MM-DD-HHMMSS.log                  # Update tool summary
+```
+
+### Log Analysis
+```bash
+# View most recent install log
+ls -t Install-Logs/*.log | head -1 | xargs less
+
+# Check for errors in specific module
+grep -i error Install-Logs/install-*hyprland*.log
+
+# View dry-run summary
+cat Install-Logs/build-dry-run-*.log
+```
+
+### Log Retention
+- Logs accumulate over time for historical reference
+- Manual cleanup recommended periodically:
+```bash
+# Keep only logs from last 30 days
+find Install-Logs/ -name "*.log" -mtime +30 -delete
+```
+
+## Advanced Usage
+
+### Tag Management
+
+#### Backup and Restore
+```bash
+# Tags are automatically backed up on changes
+# Restore most recent backup
+./update-hyprland.sh --restore --dry-run
+```
+
+#### Multiple Version Sets
+```bash
+# Save current configuration
+cp hypr-tags.env hypr-tags-stable.env
+
+# Try experimental versions
+./update-hyprland.sh --fetch-latest --dry-run
+
+# Restore stable if needed
+cp hypr-tags-stable.env hypr-tags.env
+```
+
+### Environment Integration
+
+#### Custom PKG_CONFIG_PATH
+```bash
+# Ensure /usr/local takes precedence
+export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:/usr/local/share/pkgconfig:${PKG_CONFIG_PATH:-}"
+./update-hyprland.sh --install
+```
+
+#### Parallel Builds
+```bash
+# Control build parallelism (default: all cores)
+export MAKEFLAGS="-j4"
+./update-hyprland.sh --install
+```
+
+### Development Workflow
+
+#### Testing New Releases
+```bash
+# 1. Create test environment
+cp hypr-tags.env hypr-tags.backup
+
+# 2. Test new version
+./update-hyprland.sh --set HYPRLAND=v0.52.0 --dry-run
+
+# 3. Install if successful
+./update-hyprland.sh --install
+
+# 4. Rollback if issues
+./update-hyprland.sh --restore --install
+```
+
+#### Component Development
+```bash
+# Install dependencies only
+./update-hyprland.sh --with-deps --dry-run
+
+# Manual module testing
+DRY_RUN=1 ./install-scripts/hyprland.sh
+
+# Check logs for specific module
+tail -f Install-Logs/install-*hyprland*.log
+```
+
+## Troubleshooting
+
+### Common Issues
+
+#### CMake Configuration Fails
+**Symptoms**: "Package dependency requirement not satisfied"
+
+**Solutions**:
+```bash
+# Install missing prerequisites
+./update-hyprland.sh --install --only wayland-protocols-src,hyprutils,hyprlang
+
+# Clear build cache
+rm -rf hyprland aquamarine hyprutils hyprlang
+
+# Retry installation
+./update-hyprland.sh --install --only hyprland
+```
+
+#### Compilation Errors
+**Symptoms**: "too many errors emitted"
+
+**Solutions**:
+```bash
+# Update core dependencies first
+./update-hyprland.sh --fetch-latest --install --only hyprutils,hyprlang
+
+# Check for API mismatches in logs
+grep -A5 -B5 "error:" Install-Logs/install-*hyprland*.log
+```
+
+#### Tag Not Found
+**Symptoms**: "Remote branch X not found"
+
+**Solutions**:
+```bash
+# Check available tags
+git ls-remote --tags https://github.com/hyprwm/Hyprland
+
+# Use confirmed existing tag
+./update-hyprland.sh --set HYPRLAND=v0.50.1 --install
+```
+
+### Debug Steps
+
+1. **Check system compatibility**:
+   ```bash
+   # Verify Debian version
+   cat /etc/os-release
+   
+   # Ensure deb-src enabled
+   grep -E "^deb-src" /etc/apt/sources.list
+   ```
+
+2. **Verify environment**:
+   ```bash
+   # Check current tags
+   cat hypr-tags.env
+   
+   # Test dry-run first
+   ./update-hyprland.sh --dry-run --only hyprland
+   ```
+
+3. **Analyze logs**:
+   ```bash
+   # Most recent errors
+   grep -i "error\|fail" Install-Logs/*.log | tail -20
+   
+   # Module-specific issues
+   ls -la Install-Logs/install-*[component]*.log
+   ```
+
+### Getting Help
+
+1. **Check logs**: Always review Install-Logs/ for detailed error information
+2. **Test dry-run**: Use --dry-run to validate before installing
+3. **Community support**: Submit issues with relevant log excerpts
+4. **Documentation**: Refer to main project README.md for base requirements
+
+## Migration from Previous Versions
+
+### Existing Installations
+The new tools work alongside existing installations:
+
+```bash
+# Update existing installation
+./update-hyprland.sh --install
+
+# Test without affecting current system
+./update-hyprland.sh --dry-run
+```
+
+### Converting to Tag Management
+```bash
+# Current versions are saved to hypr-tags.env automatically
+# Verify with:
+cat hypr-tags.env
+
+# Modify versions as needed:
+./update-hyprland.sh --set HYPRLAND=v0.51.1
+```
+
+The enhanced workflow provides better control, testing capabilities, and automation while maintaining full compatibility with the original installation process.

README.md

@@ -1,13 +1,14 @@
 <div align="center">
 
 # 💌 KooL's Debian-Hyprland Install Script 💌
-#### For Debian 13 Trixie (Testing) and SID (unstable)
+
+#### For Debian 13 (Trixie) and above (testing, SID)
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/JaKooLit/Hyprland-Dots/main/assets/latte.png" width="400" />
 </p>
 
-![GitHub Repo stars](https://img.shields.io/github/stars/JaKooLit/Debian-Hyprland?style=for-the-badge&color=cba6f7) ![GitHub last commit](https://img.shields.io/github/last-commit/JaKooLit/Debian-Hyprland?style=for-the-badge&color=b4befe) ![GitHub repo size](https://img.shields.io/github/repo-size/JaKooLit/Debian-Hyprland?style=for-the-badge&color=cba6f7) <a href="https://discord.gg/9JEgZsfhex"> <img src="https://img.shields.io/discord/1151869464405606400?style=for-the-badge&logo=discord&color=cba6f7&link=https%3A%2F%2Fdiscord.gg%9JEgZsfhex"> </a>
+![GitHub Repo stars](https://img.shields.io/github/stars/JaKooLit/Debian-Hyprland?style=for-the-badge&color=cba6f7) ![GitHub last commit](https://img.shields.io/github/last-commit/JaKooLit/Debian-Hyprland?style=for-the-badge&color=b4befe) ![GitHub repo size](https://img.shields.io/github/repo-size/JaKooLit/Debian-Hyprland?style=for-the-badge&color=cba6f7) <a href="https://discord.gg/kool-tech-world"> <img src="https://img.shields.io/discord/1151869464405606400?style=for-the-badge&logo=discord&color=cba6f7&link=https%3A%2F%2Fdiscord.gg%kool-tech-world"> </a>
 
 <br/>
 </div>
@@ -29,12 +30,12 @@
 </div>
 <div align="center">
 <br>
-  <a href="https://github.com/JaKooLit/Hyprland-Dots/tree/Deb-Untu-Dots"><kbd> <br> Hyprland-Dots Debian repo <br> </kbd></a>&ensp;&ensp;
+  <a href="https://github.com/JaKooLit/Hyprland-Dots/tree/Debian-Dots"><kbd> <br> Hyprland-Dots Debian repo <br> </kbd></a>&ensp;&ensp;
   <a href="https://www.youtube.com/playlist?list=PLDtGd5Fw5_GjXCznR0BzCJJDIQSZJRbxx"><kbd> <br> Youtube <br> </kbd></a>&ensp;&ensp;
   <a href="https://github.com/JaKooLit/Hyprland-Dots/wiki"><kbd> <br> Wiki <br> </kbd></a>&ensp;&ensp;
   <a href="https://github.com/JaKooLit/Hyprland-Dots/wiki/Keybinds"><kbd> <br> Keybinds <br> </kbd></a>&ensp;&ensp;
   <a href="https://github.com/JaKooLit/Hyprland-Dots/wiki/FAQ"><kbd> <br> FAQ <br> </kbd></a>&ensp;&ensp;
-  <a href="https://discord.gg/9JEgZsfhex"><kbd> <br> Discord <br> </kbd></a>
+  <a href="https://discord.gg/kool-tech-world"><kbd> <br> Discord <br> </kbd></a>
 </div><br>
 
 <p align="center">
@@ -49,129 +50,114 @@
 
 <div align="center">
 
-https://github.com/user-attachments/assets/49bc12b2-abaf-45de-a21c-67aacd9bb872
+<https://github.com/user-attachments/assets/49bc12b2-abaf-45de-a21c-67aacd9bb872>
 
 </div>
 
-### NOTE: Ubuntu-Hyprland install script has its own repo now
-- [`Ubuntu-Hyprland LINK`](https://github.com/JaKooLit/Ubuntu-Hyprland)
-
 ### Gallery and Videos
+
 #### 🎥 Feb 2025 Video explanation of installation with preset
+
 - [YOUTUBE-LINK](https://youtu.be/wQ70lo7P6vA?si=_QcbrNKh_Bg0L3wC)
 - [YOUTUBE-Hyprland-Playlist](https://youtube.com/playlist?list=PLDtGd5Fw5_GjXCznR0BzCJJDIQSZJRbxx&si=iaNjLulFdsZ6AV-t)
-
+- [AGS overview DEMO](https://youtu.be/zY5SLNPBJTs)
 
 > [!IMPORTANT]
-> install a backup tool like `snapper` or `timeshift`. and Backup your system before installing hyprland using this script. This script does NOT include uninstallation of packages
-
-> [!NOTE]
-> Main reason why I have not included an uninstallation script is simple. Some packages maybe already installed on your system by default. If I create an uninstall script with packages that I have set to install, you may end up a unrecoverable system. 
+> install a backup tool like `snapper` or `timeshift`. and Backup your system before installing hyprland using this script (**HIGHLY RECOMMENDED**).
 
 > [!CAUTION]
 > Download this script on a directory where you have write permissions. ie. HOME. Or any directory within your home directory. Else script will fail
 
-#### ⚠️ Pre-requisites and VERY Important! ### 
+#### ⚠️ Pre-requisites and VERY Important
+
 - Do not run this installer as sudo or as root
 - This Installer requires a user with a priviledge to install packages
-- Needs a Debian 13 Testing (Trixie) Branch  as it needs a newer wayland packages! I have tried on Stable Debian 12 Bookworm in which, Hyprland wont build.
-- edit your /etc/apt/sources.list and remove # on lines with deb-src to enable source packaging else will not install properly especially Hyprland
+- Needs a Debian 13 Trixie or greater. As it needs a newer wayland packages!
+- edit your `/etc/apt/sources.list` and **remove** `#` on lines with `deb-src` to enable source packaging else will not install properly especially Hyprland
+
 ```bash
 sudo nano /etc/apt/sources.list
 ```
+
 - delete # on the lines with 'deb-src'
 - ensure to allow to install non-free drivers especially for users with NVIDIA gpus. You can also install non-free drivers if required. Edit install-scripts/nvidia.sh and change the nvidia stuff's if required
 
-- If you have login Manager already like GDM (gnome login manager), I highly advice not to install SDDM. But if you decide to install SDDM, see here [`Issue 2 - SDDM`](https://github.com/JaKooLit/Debian-Hyprland/issues/2)
-
-
-> [!IMPORTANT]
-> If you are using Gnome already, DO NOT install the SDDM. The GDM Login Manager works well with Hyprland. For some reason, during installation, you will be asked which login manager you wanted to use. But during my test, nothing happened.
-
-> [!WARNING] 
-> If you have GDM already as log-in manager, DO NOT install SDDM
-> You will encounter issues. See [`Issue 2 - SDDM`](https://github.com/JaKooLit/Debian-Hyprland/issues/2)
-
-
 ### 🪧🪧🪧 ANNOUNCEMENT 🪧🪧🪧
-- This Repo does not contain Hyprland Dots or configs! Pre-configured Dotfiles are on [`Hyprland-Dots`](https://github.com/JaKooLit/Hyprland-Dots) . During installation, if you opt to copy pre-configured dots, it will be downloaded from that centralized repo.
 
-- Hyprland-Dots use are constantly evolving / improving. you can check CHANGELOGS here [`Hyprland-Dots-Changelogs`](https://github.com/JaKooLit/Hyprland-Dots/wiki/Changelogs)
-- Since the Hyprland-Dots are evolving, some of the screenshots maybe old
-- the wallpaper offered to be downloaded towards the end is from this [`WALLPAPER-REPO`](https://github.com/JaKooLit/Wallpaper-Bank)
+[Debian-Hyprland Changelogs](https://github.com/JaKooLit/Debian-Hyprland/blob/main/CHANGELOGS.md)
+
+- 10 October 2025 Update!
+- Hyprland-Debian nows builds 0.51.1 from source!
+  - The installer now can be used to install newer releases later
+  - If you are currently running 0.49, or 0.50, you can upgrade to 0.51.1
+  - You do not have to re-install everything, but re-running `install.sh` works also
+  - Instructions are available in English and Spanish
 
 #### ✨  Some notes on this installer / Prerequisites
-- This script is meant to install in Debian Testing (Trixie) and Debian Unstable (SID). This script Will NOT work with Bookworm
-- If However, decided to try, recommend to install SDDM. Apart from GDM and SDDM, any other Login Manager may not work nor launch Hyprland. However, hyprland can be launched through tty by type Hyprland
-- 🕯️ network-manager-gnome (nm-applet) has been removed from the packages to install. This is because it is known to restart the networkmanager causing issues in the installation process. After you boot up, inorder to get the network-manager applet, install network-manager-gnome. `sudo apt install network-manager-gnome` See below if your network or wifi became unmanaged after installation
+
+- Recommend to install SDDM. Apart from GDM and SDDM, any other Login Manager may not work nor launch Hyprland. However, hyprland can be launched through tty by type Hyprland
+- 🕯️ network-manager-gnome (nm-applet) *has been removed* from the packages to install. This is because it is known to restart the networkmanager causing issues in the installation process. After you boot up, inorder to get the network-manager applet, install network-manager-gnome. `sudo apt install network-manager-gnome` See below if your network or wifi became unmanaged after installation
+
+### 🚩 changing login manager to SDDM
+
+- if you really want to change login manager, there are couple of things you need to carry out before running this install script
+- first install sddm. the no-install-recommends is suggested else it will pull lots of plasma depencies.
+
+```bash
+sudo apt install --no-install-recommends -y sddm
+```
+
+- then ran `sudo dpkg-reconfigure sddm` choose sddm and then reboot.
+- once reboot done, you can ran the script and choose sddm & sddm theme
+- [LINK](https://www.simplified.guide/ubuntu/switch-to-gdm) for some guide
+
+#### 💫 SDDM and GTK Themes offered
+
+- If you opted to install SDDM theme, here's the [LINK](https://github.com/JaKooLit/simple-sddm-2) which is a modified fork of [LINK](https://github.com/Keyitdev/sddm-astronaut-theme)
+- If you opted to install GTK Themes, Icons,  here's the [LINK](https://github.com/JaKooLit/GTK-themes-icons). This also includes Bibata Modern Ice cursor.
+
+#### 🔔 NOTICE TO NVIDIA OWNERS ###
+
+- By default it is installing the latest and newest nvidia drivers. If you have an older nvidia-gpu (GTX 800 series and older), check out nvidia-debian website [LINK](https://wiki.debian.org/NvidiaGraphicsDrivers) and edit nvidia.sh in install-scripts directory to install proper gpu driver
 - If you have nvidia, and wanted to use proprietary drivers, uninstall nouveau first (if installed). This script will be installing proprietary nvidia drivers and will not deal with removal of nouveau.
 - NVIDIA users / owners, after installation, check [`THIS`](https://github.com/JaKooLit/Hyprland-Dots/wiki/Notes_to_remember#--for-nvidia-gpu-users)
 
-#### ✨ Costumize the packages to be installed
-- inside the install-scripts directory, you can edit 01-hypr-pkgs.sh. Do not edit 00-dependencies.sh unless you know what you are doing. Care though as the Hyprland Dots may not work properly!
-
-#### 💫 SDDM and GTK Themes offered
-- If you opted to install SDDM theme, here's the [`LINK`](https://codeberg.org/JaKooLit/sddm-sequoia) which is a fork of [`LINK`](https://codeberg.org/minMelody/sddm-sequoia)
-- If you opted to install GTK Themes, Icons,  here's the [`LINK`](https://github.com/JaKooLit/GTK-themes-icons). This also includes Bibata Modern Ice cursor.
-
-#### 🔔 NOTICE TO NVIDIA OWNERS ### 
-- by default it is installing the latest and newest nvidia drivers. If you have an older nvidia-gpu (GTX 800 series and older), check out nvidia-debian website [`LINK`](https://wiki.debian.org/NvidiaGraphicsDrivers) and edit nvidia.sh in install-scripts directory to install proper gpu driver
-
 > [!IMPORTANT]
-> If you want to use nouveau driver, choose N when asked if you have nvidia gpu. This is because the nvidia installer part, it will blacklist nouveau. Hyprland will still be installed but it will skip blacklisting nouveau.
+> If you wish to use the nouveau driver (installed by default in Debian), be sure to not select "Nvidia" in the installation options.
+> If you select this option, the NVIDIA installer part will attempt to blacklist nouveau; while Hyprland will still be installed, it will skip blacklisting nouveau if you don't select the NVIDIA option.
 
-> [!IMPORTANT]
-> Another important note for nvidia owners
-> If you have nvidia, by default debian is installing nouveau or open-source nvidia driver. If you want to keep the default nvidia driver installed by Debian, choose N on the if you have nvidia question. Or else you will encounter same issue as SDDM above.
+## ✨ Auto clone and install
+>
+> [!CAUTION]
+> If you are using FISH SHELL, DO NOT use this function. Clone and run install.sh instead
+
+- you can use this command to automatically clone the installer and ran the script for you
+- NOTE: `curl` package is required before running this command
+
+```bash
+sh <(curl -L https://raw.githubusercontent.com/JaKooLit/Debian-Hyprland/main/auto-install.sh)
+```
 
 ## ✨ to use this script
-> clone this repo (latest commit only) by using git. Change directory, make executable and run the script
+clone this repo, change directory, make executable and run the script:
+
 ```bash
 git clone --depth=1 https://github.com/JaKooLit/Debian-Hyprland.git ~/Debian-Hyprland
 cd ~/Debian-Hyprland
 chmod +x install.sh
 ./install.sh
 ```
-<p align="center">
-    <img align="center" width="100%" src="https://raw.githubusercontent.com/JaKooLit/Debian-Hyprland/main/Debian-Install.png" />
-
-
-### 🤟 semi-unattended installation (new for Feb 2025)
-- edit preset.sh to modify what packages you want. Make sure to change only with Y or N
-- to use preset instead of usual `./install.sh` you can ran like this
-
-```bash
-./install.sh --preset
-```
-
-- if you have nvidia you can add --nvidia argument
-
-```bash
-./install.sh --preset --nvidia
-```
-
-- its called semi-unattended it is because you still have to answer some questions when installing KooL's Hyprland Dots
-
-
-#### ✨ for ZSH and OH-MY-ZSH installation
-> installer should auto change your default shell to zsh. However, if it does not, do this
-```bash
-chsh -s $(which zsh)
-zsh
-source ~/.zshrc
-```
-- reboot or logout
-- by default `xiong-chiamiov-plus` theme is installed. You can find more themes from this [`OH-MY-ZSH-THEMES`](https://github.com/ohmyzsh/ohmyzsh/wiki/Themes)
-- to change the theme, edit ~/.zshrc ZSH_THEME="desired theme"
 
 #### ✨ TO DO once installation done and dotfiles copied
+
 - SUPER H for HINT or click on the waybar HINT! Button
 - Head over to [`FAQ`](https://github.com/JaKooLit/Hyprland-Dots/wiki/FAQ) and [`TIPS`](https://github.com/JaKooLit/Hyprland-Dots/wiki/TIPS)
-
+- Head over to [KooL Hyprland WIKI](https://github.com/JaKooLit/Hyprland-Dots/wiki)
 
 - if you installed in your laptop and Brightness and Keyboard brightness does not work you can execute this command `sudo chmod +s $(which brightnessctl)`
 
 #### ✨ Packages that are manually downloaded and build. These packages will not be updated by apt and have to be manually updated
+
 - Asus ROG asusctl [`LINK`](https://gitlab.com/asus-linux/asusctl) and superfxctl [`LINK`](https://gitlab.com/asus-linux/supergfxctl)
 - swww [`LINK`](https://github.com/Horus645/swww)
 - hyprlock [`LINK`](https://github.com/hyprwm/hyprlock) #22 Aug 2024 - still not on repo
@@ -182,63 +168,58 @@ source ~/.zshrc
 > [!TIP]
 > To update to latest packages, re-running this script will auto update all. Script is configured to pull latest packages build for you.
 
+### 💥   UNINSTALL SCRIPT / Removal of Config Files
+
+- 11 March 2025, due to popular request, created a guided `uninstall.sh` script. USE this with caution as it may render your system unstable.
+- I will not be responsible if your system breaks
+- The best still to revert to previous state of your system is via **timeshift or snapper**
+
 #### 🤬 FAQ
-#### Most common question I got is, Hey Ja, Why the heck it is taking long time to install? Other distro like Arch its only a minute or two. Why here takes like forever?!?!?!
-- Well, most of the core packages are downloaded and Build and compiled from SOURCE. Unlike Other distros, they already have prepacked binary that can just download and install.
 
-## 🛎 *** DEBIAN and UBUNTU Hyprland Dots UPDATING NOTES ***
-> [!IMPORTANT]
-> This is very Important for Debian and Ubuntu Dots
-- Some parts of KooL's Hyprland Dots [`LINK`](https://github.com/JaKooLit/Hyprland-Dots) are not compatible on Debian and Ubuntu especially the hyprland settings. 
-- That is the reason the DOTS for those distro's are "fixed" and they are being pulled on different branch of KooL Dots.
+**Most common question I got is, Hey Ja, Why the heck it is taking long time to install? Other distro like Arch its only a minute or two. Why here takes like forever?!?!?**
 
-- To update your KooL's Dots follow this [WIKI](https://github.com/JaKooLit/Hyprland-Dots/wiki#--debian-and-ubuntu-hyprland-dots-updating-notes-)
+- Well, most of the core packages are downloaded and Build and compiled from *SOURCE*. Unlike Other distros, they already have prepacked binary that can just download and install.
 
-#### ❗ some known issues on this Installer
-- some users reported that they have to install some packages. It is in the install-scripts/force-install.sh
-- At this time the packages force to install are the following `imagemagick`
+## 🛎 ***DEBIAN Hyprland Dots UPDATING NOTES***
+
+- With this new update to Debian-Hyprland the current Hyprland-Dots are now compatible with Debian. This applies only to Debian, not ubuntu.  
 
 > [!NOTE]
 > This script does not setup audio. Kindly set up. If you have not, I recommend pipewire. `sudo apt install -y pipewire`
 
-#### 🎞️ AGS Overview DEMO
-- in case you wonder, here is a short demo of AGS overview [Youtube LINK](https://youtu.be/zY5SLNPBJTs)
-
-#### ✨ TO DO once installation done and dotfiles copied
-- SUPER H for HINT or click on the waybar HINT! Button 
-- Head over to [KooL Hyprland WIKI](https://github.com/JaKooLit/Hyprland-Dots/wiki)
-
 #### 🙋 Got a questions regarding the Hyprland Dots or configurations? 🙋
-- Head over to wiki Link [`WIKI`](https://github.com/JaKooLit/Hyprland-Dots/wiki)
+
+Head over to wiki Link [`WIKI`](https://github.com/JaKooLit/Hyprland-Dots/wiki)
 
 #### ⌨ Keybinds
-- Keybinds [`CLICK`](https://github.com/JaKooLit/Hyprland-Dots/wiki/Keybinds)
+
+Keybinds [`CLICK`](https://github.com/JaKooLit/Hyprland-Dots/wiki/Keybinds)
 
 > [!TIP]
 > KooL Hyprland has a searchable keybind function via rofi. (SUPER SHIFT K) or right click the `HINTS` waybar button
 
 #### 🙋 👋 Having issues or questions?
+
 - for the install part, kindly open issue on this repo
 - for the Pre-configured Hyprland dots / configuration, submit issue [`here`](https://github.com/JaKooLit/Hyprland-Dots/issues)
 
 #### 🔧 Proper way to re-installing a particular script from install-scripts directory
-- CD into Debian-Hyprland DIrectory and then ran the below command. 
+
+- CD into Debian-Hyprland directory and then ran the below command.
 - i.e. `./install-scripts/gtk-themes.sh` - to reinstall GTK Themes or
 - `./install-scripts/sddm.sh` - to reinstall sddm
+
 > [!IMPORTANT]
 > DO NOT CD into install-scripts directory as script as it will fail. Scripts are designed to ran outside install-scripts directory for installation logging purposes.
 
-#### 🎞️ AGS Overview DEMO
-- in case you wonder, here is a short demo of AGS overview [Youtube LINK](https://youtu.be/zY5SLNPBJTs)
+#### 🛣️ Roadmap
 
-#### 🛣️ Roadmap:
 - [ ] possibly adding gruvbox themes, cursors, icons
 
-### ⁉️ KNOWN ISSUE
-- [ ] hypridle wont build (Feb 2025)
-
 #### ❗ some known issues for nvidia
+
 - reports from members of my discord, states that some users of nvidia are getting stuck on sddm login. credit  to @Kenni Fix stated was
+
 ```  
  while in sddm press ctrl+alt+F2 or F3
 log into your account
@@ -247,74 +228,84 @@ log into your account
 `ls -l /dev/dri/by-path` to check where the symlink points to 
 )
 ```
+
 - add "env = WLR_DRM_DEVICES,/dev/dri/cardX" to the ENVvariables config `~/.config/hypr/UserConfigs/ENVariables.conf`  ; X being where the symlink of the gpu points to
 
 - more info from the hyprland wiki [`Hyprland Wiki Link`](https://wiki.hyprland.org/FAQ/#my-external-monitor-is-blank--doesnt-render--receives-no-signal-laptop)
 
-
 - reports from a member of discord for Nvidia for additional env's
 - remove # from the following env's on
+
 ```
 env = GBM_BACKEND,nvidia-drm
 env = WLR_RENDERER_ALLOW_SOFTWARE,1
 ```
 
 #### 🫥 Improving performance for Older Nvidia Cards using driver 470
+
 - [`SEE HERE`](https://github.com/JaKooLit/Hyprland-Dots/discussions/123#discussion-6035205)
   
 #### ❗ other known issues
 
 > [!NOTE]
 > Auto start of Hyprland after login (no SDDM or GDM or any login managers)
+
 - This was disabled a few days ago. (19 May 2024). This was because some users, after they used the Distro-Hyprland scripts with other DE (gnome-wayland or plasma-wayland), if they choose to login into gnome-wayland for example, Hyprland is starting.
 - to avoid this, I disabled it. You can re-enable again by editing `~/.zprofile` . Remove all the # on the first lines
 - [ ] ROFI issues (scaling, unexplained scaling etc). This is most likely to experience if you are installing on a system where rofi is currently installed. To fix it uninstall rofi and install rofi-wayland . `sudo apt autoremove rofi` .
 - Install rofi-wayland with
+
 ```bash
 cd ~/Debian-Hyprland
 ./install-scripts/rofi-wayland.sh
 ```
+
 - [ ] Rofi-wayland is compatible with x11 so no need to worry.
 
 - [ ] Does not work in Debian Bookworm
 - [ ] sddm blackscreen when log-out
 - [ ] Installing SDDM if or any other Login Manager installed. See [`Issue 2 - SDDM`](https://github.com/JaKooLit/Debian-Hyprland/issues/2)
 - [ ] network is down or become unmanaged [`This`](https://askubuntu.com/questions/71159/network-manager-says-device-not-managed) might help
-- [ ] pyprland is a hit and miss. Drop down not working, zooming is hit and miss
-
 
 #### 📒 Final Notes
-- join my discord channel [`Discord`](https://discord.com/invite/9JEgZsfhex)
+
+- join my discord channel [`Discord`](https://discord.com/invite/kool-tech-world)
 - Feel free to copy, re-distribute, and use this script however you want. Would appreciate if you give me some loves by crediting my work :)
 
+#### ✍️ Contributing
 
-#### ⏩ Contributing
 - As stated above, these script does not contain actual config files. These are only the installer of packages
-- The development branch of this script is pulling the latest "stable" releases of the Hyprland-Dotfiles.
 - If you want to contribute and/or test the Hyprland-Dotfiles (development branch), [`Hyprland-Dots-Development`](https://github.com/JaKooLit/Hyprland-Dots/tree/development)
+- Want to contribute on KooL-Hyprland-Dots Click [`HERE`](https://github.com/JaKooLit/Hyprland-Dots/blob/main/CONTRIBUTING.md) for a guide how to contribute
+- Want to contribute on This Installer? Click [`HERE`](https://github.com/JaKooLit/Debian-Hyprland/blob/main/CONTRIBUTING.md) for a guide how to contribute
 
+#### 👍👍👍 Thanks and Credits
 
-#### 👍👍👍 Thanks and Credits!
 - [`Hyprland`](https://hyprland.org/) Of course to Hyprland and @vaxerski for this awesome Dynamic Tiling Manager.
 
-
 ### 💖 Support
+
 - a Star on my Github repos would be nice 🌟
 
 - Subscribe to my Youtube Channel [YouTube](https://www.youtube.com/@Ja.KooLit)
 
-- You can also buy me Coffee Through ko-fi.com or Coffee.com 🤩
+- you can also give support through coffee's or btc 😊
 
-<a href='https://ko-fi.com/jakoolit' target='_blank'><img height='35' style='border:0px;height:46px;' src='https://az743702.vo.msecnd.net/cdn/kofi3.png?v=0' border='0' alt='Buy Me a Coffee at ko-fi.com' />
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/jakoolit)
+
+or
 
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/JaKooLit)
 
+Or you can donate cryto on my btc wallet :)  
+> 1N3MeV2dsX6gQB42HXU6MF2hAix1mqjo8i
+
+![Bitcoin](https://github.com/user-attachments/assets/7ed32f8f-c499-46f0-a53c-3f6fbd343699)
+
 #### 📹 Youtube videos (Click to view and watch the playlist) 📹
+
 [![Youtube Playlist Thumbnail](https://raw.githubusercontent.com/JaKooLit/screenshots/main/Youtube.png)](https://youtube.com/playlist?list=PLDtGd5Fw5_GjXCznR0BzCJJDIQSZJRbxx&si=iaNjLulFdsZ6AV-t)
 
-
-                        
 ## 🥰🥰 💖💖 👍👍👍
+
 [![Stargazers over time](https://starchart.cc/JaKooLit/Debian-Hyprland.svg?variant=adaptive)](https://starchart.cc/JaKooLit/Debian-Hyprland)
-
-                    

assets/.zshrc

@@ -22,8 +22,10 @@ source $ZSH/oh-my-zsh.sh
 # fastfetch. Will be disabled if above colorscript was chosen to install
 fastfetch -c $HOME/.config/fastfetch/config-compact.jsonc
 
-# Set-up icons for files/folders in terminal using eza
-alias ls='eza -a --icons'
-alias ll='eza -al --icons'
-alias lt='eza -a --tree --level=1 --icons'
+# Set-up icons for files/directories in terminal using lsd
+alias ls='lsd'
+alias l='ls -l'
+alias la='ls -a'
+alias lla='ls -la'
+alias lt='ls --tree'
 

assets/0001-fix-hyprland-compile-issue.patch

@@ -0,0 +1,26 @@
+diff --git a/hyprctl/main.cpp b/hyprctl/main.cpp
+index daf8d4a8..62ab8578 100644
+--- a/hyprctl/main.cpp
++++ b/hyprctl/main.cpp
+@@ -268,7 +268,7 @@ int requestIPC(std::string_view filename, std::string_view arg) {
+     sockaddr_un serverAddress = {0};
+     serverAddress.sun_family  = AF_UNIX;
+ 
+-    std::string socketPath = getRuntimeDir() + "/" + instanceSignature + "/" + filename;
++    std::string socketPath = getRuntimeDir() + "/" + std::string(instanceSignature) + "/" + std::string(filename);
+ 
+     strncpy(serverAddress.sun_path, socketPath.c_str(), sizeof(serverAddress.sun_path) - 1);
+ 
+diff --git a/src/helpers/Monitor.cpp b/src/helpers/Monitor.cpp
+index 4e5c4080..1944f22e 100644
+--- a/src/helpers/Monitor.cpp
++++ b/src/helpers/Monitor.cpp
+@@ -549,7 +549,7 @@ bool CMonitor::applyMonitorRule(SMonitorRule* pMonitorRule, bool force) {
+         std::ranges::sort(sortedModes, sortFunc);
+         if (sortedModes.size() > 3)
+             sortedModes.erase(sortedModes.begin() + 3, sortedModes.end());
+-        requestedModes.insert_range(requestedModes.end(), sortedModes | std::views::reverse);
++        requestedModes.insert(requestedModes.end(), sortedModes.rbegin(), sortedModes.rend());
+     };
+ 
+     // last fallback is always preferred mode

assets/hyprland.desktop

@@ -1,5 +0,0 @@
-[Desktop Entry]
-Name=Hyprland
-Comment=An intelligent dynamic tiling Wayland compositor
-Exec=Hyprland
-Type=Application

auto-install.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+# https://github.com/JaKooLit
+
+# Set some colors for output messages
+OK="$(tput setaf 2)[OK]$(tput sgr0)"
+ERROR="$(tput setaf 1)[ERROR]$(tput sgr0)"
+NOTE="$(tput setaf 3)[NOTE]$(tput sgr0)"
+INFO="$(tput setaf 4)[INFO]$(tput sgr0)"
+WARN="$(tput setaf 1)[WARN]$(tput sgr0)"
+CAT="$(tput setaf 6)[ACTION]$(tput sgr0)"
+MAGENTA="$(tput setaf 5)"
+ORANGE="$(tput setaf 214)"
+WARNING="$(tput setaf 1)"
+YELLOW="$(tput setaf 3)"
+GREEN="$(tput setaf 2)"
+BLUE="$(tput setaf 4)"
+SKY_BLUE="$(tput setaf 6)"
+RESET="$(tput sgr0)"
+
+# Variables
+Distro="Debian-Hyprland"
+Github_URL="https://github.com/JaKooLit/$Distro.git"
+Distro_DIR="$HOME/$Distro"
+
+printf "\n%.0s" {1..1}
+
+if ! command -v git &> /dev/null
+then
+    echo "${INFO} Git not found! ${SKY_BLUE}Installing Git...${RESET}"
+    if ! sudo apt install -y git; then
+        echo "${ERROR} Failed to install Git. Exiting."
+        exit 1
+    fi
+fi
+
+printf "\n%.0s" {1..1}
+
+if [ -d "$Distro_DIR" ]; then
+    echo "${YELLOW}$Distro_DIR exists. Updating the repository... ${RESET}"
+    cd "$Distro_DIR"
+    git stash && git pull
+    chmod +x install.sh
+    ./install.sh
+else
+    echo "${MAGENTA}$Distro_DIR does not exist. Cloning the repository...${RESET}"
+    git clone --depth=1 "$Github_URL" "$Distro_DIR"
+    cd "$Distro_DIR"
+    chmod +x install.sh
+    ./install.sh
+fi

dry-run-build.sh

@@ -0,0 +1,151 @@
+#!/usr/bin/env bash
+# Dry-run orchestrator for Hyprland and companion modules
+# - Compiles components but skips installation (uses DRY_RUN=1)
+# - Summarizes PASS/FAIL per module to Install-Logs/
+#
+# Usage:
+#   chmod +x ./dry-run-build.sh
+#   ./dry-run-build.sh                  # run full stack dry-run
+#   ./dry-run-build.sh --with-deps      # install dependencies first, then dry-run build
+#   ./dry-run-build.sh --only hyprland  # run a subset (comma-separated allowed)
+#   ./dry-run-build.sh --skip qtutils   # skip one or more (comma-separated)
+#
+# Notes:
+# - Run from the repository root. Do not cd into install-scripts/.
+# - You can also call modules directly, e.g., DRY_RUN=1 ./install-scripts/hyprland.sh
+
+set -u
+set -o pipefail
+
+REPO_ROOT=$(pwd)
+LOG_DIR="$REPO_ROOT/Install-Logs"
+mkdir -p "$LOG_DIR"
+TS=$(date +%F-%H%M%S)
+SUMMARY_LOG="$LOG_DIR/build-dry-run-$TS.log"
+
+# Default module order (core first, then Hyprland)
+DEFAULT_MODULES=(
+  hyprutils
+  hyprlang
+  wayland-protocols-src
+  aquamarine
+  hyprgraphics
+  hyprwayland-scanner
+  hyprland-protocols
+  hyprland-qt-support
+  hyprland-qtutils
+  hyprland
+)
+
+WITH_DEPS=0
+ONLY_LIST=""
+SKIP_LIST=""
+
+usage() {
+  grep '^# ' "$0" | sed 's/^# \{0,1\}//'
+}
+
+# Parse args
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    --with-deps)
+      WITH_DEPS=1
+      shift
+      ;;
+    --only)
+      ONLY_LIST=${2:-}
+      shift 2
+      ;;
+    --skip)
+      SKIP_LIST=${2:-}
+      shift 2
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      exit 2
+      ;;
+  esac
+done
+
+# Build module list based on --only/--skip
+MODULES=()
+if [[ -n "$ONLY_LIST" ]]; then
+  IFS=',' read -r -a MODULES <<< "$ONLY_LIST"
+else
+  MODULES=("${DEFAULT_MODULES[@]}")
+fi
+
+if [[ -n "$SKIP_LIST" ]]; then
+  IFS=',' read -r -a _SKIPS <<< "$SKIP_LIST"
+  FILTERED=()
+  for m in "${MODULES[@]}"; do
+    skip_it=0
+    for s in "${_SKIPS[@]}"; do
+      if [[ "$m" == "$s" ]]; then
+        skip_it=1
+        break
+      fi
+    done
+    if [[ $skip_it -eq 0 ]]; then
+      FILTERED+=("$m")
+    fi
+  done
+  MODULES=("${FILTERED[@]}")
+fi
+
+# Optionally install dependencies (not a dry-run)
+if [[ $WITH_DEPS -eq 1 ]]; then
+  echo "[INFO] Installing dependencies via 00-dependencies.sh" | tee -a "$SUMMARY_LOG"
+  if ! "$REPO_ROOT/install-scripts/00-dependencies.sh"; then
+    echo "[ERROR] Dependencies installation failed. See logs under Install-Logs/." | tee -a "$SUMMARY_LOG"
+    exit 1
+  fi
+fi
+
+# Run each module with DRY_RUN=1 and capture exit codes
+declare -A RESULTS
+
+echo "[INFO] Starting dry-run build at $TS" | tee -a "$SUMMARY_LOG"
+
+for mod in "${MODULES[@]}"; do
+  script_path="$REPO_ROOT/install-scripts/$mod.sh"
+  echo "\n=== $mod (DRY RUN) ===" | tee -a "$SUMMARY_LOG"
+  if [[ ! -x "$script_path" ]]; then
+    # Try to make executable if it exists
+    if [[ -f "$script_path" ]]; then
+      chmod +x "$script_path" || true
+    fi
+  fi
+  if [[ ! -f "$script_path" ]]; then
+    echo "[WARN] Missing script: $script_path" | tee -a "$SUMMARY_LOG"
+    RESULTS[$mod]="MISSING"
+    continue
+  fi
+  if DRY_RUN=1 "$script_path"; then
+    RESULTS[$mod]="PASS"
+  else
+    RESULTS[$mod]="FAIL"
+  fi
+done
+
+# Summary
+{
+  echo "\nSummary (dry-run):"
+  for mod in "${MODULES[@]}"; do
+    printf "%-24s %s\n" "$mod" "${RESULTS[$mod]:-SKIPPED}"
+  done
+  echo "\nLogs: individual module logs are under Install-Logs/. This summary: $SUMMARY_LOG"
+} | tee -a "$SUMMARY_LOG"
+
+# Exit non-zero if any FAIL occurred
+failed=0
+for mod in "${MODULES[@]}"; do
+  if [[ "${RESULTS[$mod]:-}" == "FAIL" ]]; then
+    failed=1
+  fi
+done
+exit $failed

hypr-tags.env

@@ -0,0 +1,15 @@
+# Central tag overrides for the Hyprland stack
+# You can edit these values or let update-hyprland.sh manage them.
+# Each module script reads its TAG from these environment variables if set.
+
+HYPRLAND_TAG=v0.52.2
+AQUAMARINE_TAG=v0.10.0
+HYPRUTILS_TAG=v0.10.4
+HYPRLANG_TAG=v0.6.7
+HYPRGRAPHICS_TAG=v0.4.0
+HYPRTOOLKIT_TAG=v0.4.1
+HYPRWAYLAND_SCANNER_TAG=v0.4.5
+HYPRLAND_PROTOCOLS_TAG=v0.7.0
+HYPRLAND_QT_SUPPORT_TAG=v0.1.0
+HYPRLAND_GUIUTILS_TAG=v0.2.0
+WAYLAND_PROTOCOLS_TAG=1.46

install-scripts/00-dependencies.sh

@@ -1,6 +1,7 @@
 #!/bin/bash
 # 💫 https://github.com/JaKooLit 💫 #
 # main dependencies #
+# 22 Aug 2024 - NOTE will trim this more down
 
 # packages neeeded
 dependencies=(
@@ -8,39 +9,80 @@ dependencies=(
     cmake
     cmake-extras
     curl
+    findutils
     gawk
     gettext
+    gir1.2-graphene-1.0
     git
     glslang-tools
     gobject-introspection
     golang
     hwdata
     jq
-    libmpdclient-dev
-    libnl-3-dev
-    libasound2-dev
-    libstartup-notification0-dev
-    libwayland-client++1
-    libwayland-dev
-    libcairo-5c-dev
+    libavcodec-dev
+    libavformat-dev
+    libavutil-dev
     libcairo2-dev
-    libsdbus-c++-bin    
+    libdeflate-dev
+    libdisplay-info-dev
+    libdrm-dev
     libegl-dev
     libegl1-mesa-dev
-    libpango1.0-dev
+    libgbm-dev
     libgdk-pixbuf-2.0-dev
-    libxcb-keysyms1-dev
-    libwayland-client0
-    libxcb-ewmh-dev
+    libgdk-pixbuf2.0-bin
+    libgirepository1.0-dev
+    libgl1-mesa-dev
+    libgraphene-1.0-0
+    libgraphene-1.0-dev
+    libgtk-3-dev
+    libgulkan-0.15-0t64
+    libgulkan-dev
+    libinih-dev
+    libiniparser-dev
+    libinput-dev
+    libjbig-dev
+    libjpeg-dev
+    libjpeg62-turbo-dev
+    liblerc-dev
+    libliftoff-dev
+    liblzma-dev
+    libnotify-bin
+    libpam0g-dev
+    libpango1.0-dev
+    libpipewire-0.3-dev
+    libqt6svg6
+    libsdbus-c++-dev
+    libseat-dev
+    libstartup-notification0-dev
+    libswresample-dev
+    libsystemd-dev
+    libtiff-dev
+    libtiffxx6
+    libtomlplusplus-dev
+    libudev-dev
+    libvkfft-dev
+    libvulkan-dev
+    libvulkan-volk-dev
+    libwayland-dev
+    libwebp-dev
+    libxcb-composite0-dev
     libxcb-cursor-dev
+    libxcb-dri3-dev
+    libxcb-ewmh-dev
     libxcb-icccm4-dev
-    libxcb-randr0-dev
+    libxcb-present-dev
     libxcb-render-util0-dev
+    libxcb-res0-dev
     libxcb-util-dev
-    libxcb-xkb-dev
     libxcb-xinerama0-dev
+    libxcb-xinput-dev
+    libxcb-xkb-dev
     libxkbcommon-dev
     libxkbcommon-x11-dev
+    libxkbregistry-dev
+    libxml2-dev
+    libxxhash-dev
     meson
     ninja-build
     openssl
@@ -48,16 +90,45 @@ dependencies=(
     python3-mako
     python3-markdown
     python3-markupsafe
-    python3-yaml
     python3-pyquery
+    python3-yaml
     qt6-base-dev
+    scdoc
+    seatd
     spirv-tools
-    #vulkan-validationlayers
+    unzip
     vulkan-utility-libraries-dev
+    vulkan-validationlayers
     wayland-protocols
     xdg-desktop-portal
     xwayland
+)
+
+# hyprland dependencies
+hyprland_dep=(
     bc
+    binutils
+    libc6
+    libcairo2-dev
+    libdisplay-info3
+    libdrm2
+    libjpeg-dev
+    libjxl-dev
+    libmagic-dev
+    libpixman-1-dev
+    libpugixml-dev
+    libre2-dev
+    librsvg2-dev
+    libspng-dev
+    libtomlplusplus-dev
+    libwebp-dev
+    libzip-dev
+    libpam0g-dev
+    libxcursor-dev
+    qt6-declarative-dev
+    qt6-base-private-dev
+    qt6-wayland-dev
+    qt6-wayland-private-dev
 )
 
 build_dep=(
@@ -65,14 +136,20 @@ build_dep=(
 )
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || {
+    echo "${ERROR} Failed to change directory to $PARENT_DIR"
+    exit 1
+}
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+    echo "Failed to source Global_functions.sh"
+    exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_dependencies.log"
@@ -80,9 +157,8 @@ LOG="Install-Logs/install-$(date +%d-%H%M%S)_dependencies.log"
 # Installation of main dependencies
 printf "\n%s - Installing ${SKY_BLUE}main dependencies....${RESET} \n" "${NOTE}"
 
-
-for PKG in "${dependencies[@]}"; do
-  install_package "$PKG" "$LOG"
+for PKG1 in "${dependencies[@]}" "${hyprland_dep[@]}"; do
+    install_package "$PKG1" "$LOG"
 done
 
 printf "\n%.0s" {1..1}

install-scripts/01-hypr-pkgs.sh

@@ -10,7 +10,7 @@ Extra=(
 
 )
 
-# packages neeeded
+# packages needed
 hypr_package=(
     cliphist
     grim
@@ -23,17 +23,16 @@ hypr_package=(
     pavucontrol
     playerctl
     polkit-kde-agent-1
-  pkexec
     python3-requests
     python3-pip
     qt5ct
     qt5-style-kvantum
-  qt5-style-kvantum-themes
+    qt-style-kvantum-themes
     qt6ct
     slurp
-  sway-notification-center
     swappy
-  unzip # required later
+    sway-notification-center
+    unzip
     waybar
     wget
     wl-clipboard
@@ -48,18 +47,23 @@ hypr_package_2=(
     brightnessctl
     btop
     cava
-  loupe
-  nwg-look
-  nwg-displays
     fastfetch
+    loupe
     gnome-system-monitor
     mousepad
     mpv
     mpv-mpris
+    nwg-look
+    nwg-displays
     nvtop
     pamixer
     qalculate-gtk
-  vim
+)
+
+# packages to force reinstall
+force=(
+    imagemagick
+    wayland-protocols
 )
 
 # List of packages to uninstall as it conflicts with swaync or causing swaync to not function properly
@@ -70,20 +74,21 @@ uninstall=(
     cargo
 )
 
-# List packages to force reinstall
-force=(
-  yad
-)
-
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || {
+    echo "${ERROR} Failed to change directory to $PARENT_DIR"
+    exit 1
+}
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+    echo "Failed to source Global_functions.sh"
+    exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_hypr-pkgs.log"
@@ -104,7 +109,6 @@ fi
 
 printf "\n%.0s" {1..1}
 
-
 # Installation of main components
 printf "\n%s - Installing ${SKY_BLUE}KooL's hyprland necessary packages${RESET} .... \n" "${NOTE}"
 
@@ -112,12 +116,13 @@ for PKG1 in "${hypr_package[@]}" "${hypr_package_2[@]}" "${Extra[@]}"; do
     install_package "$PKG1" "$LOG"
 done
 
+printf "\n%.0s" {1..1}
+
 for PKG2 in "${force[@]}"; do
     re_install_package "$PKG2" "$LOG"
 done
 
 printf "\n%.0s" {1..1}
-
 # install YAD from assets. NOTE This is downloaded from SID repo and sometimes
 # Trixie is removing YAD for some strange reasons
 # Check if yad is installed
@@ -139,3 +144,4 @@ source "$HOME/.cargo/env"
 sudo chmod +s $(which brightnessctl) 2>&1 | tee -a "$LOG" || true
 
 printf "\n%.0s" {1..2}
+

install-scripts/02-pre-cleanup.sh

@@ -3,16 +3,12 @@
 # This script is cleaning up previous manual installation files / directories
 
 # 22 Aug 2024
-# Files to be removed rom /usr/local/bin
+# Files to be removed from /usr/local/bin
 
 TARGET_DIR="/usr/local/bin"
 
 # Define packages to manually remove (was manually installed previously)
 PACKAGES=(
-  hyprctl
-  hyprpm
-  hyprland
-  Hyprland
   cliphist
   pypr
   swappy
@@ -20,15 +16,32 @@ PACKAGES=(
   magick
 )
 
+# List of packages installed from Debian-Hyprland repo
+uninstall=(
+  hyprland
+  xdg-desktop-portal-hyprland
+  libhhyprland-dev
+  libhyprutils-dev
+  libhyprutils0
+  hyprwayland-scanner
+  hyprland-protocols
+  hyprctl
+  hyprpm
+  Hyprland
+)
+
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_pre-clean-up.log"
@@ -43,7 +56,24 @@ for PKG_NAME in "${PACKAGES[@]}"; do
     # Delete the file
     sudo rm "$FILE_PATH"
     echo "Deleted: $FILE_PATH" 2>&1 | tee -a "$LOG"
+  else
+    echo "File not found: $FILE_PATH" 2>&1 | tee -a "$LOG"
   fi
 done
 
-printf "\n%.0s" {1..2}
+
+# packages removal installed from Debian-Hyprland repo
+overall_failed=0
+printf "\n%s - ${SKY_BLUE}Removing some packages${RESET} installed from Debian Hyprland official repo \n" "${NOTE}"
+for PKG in "${uninstall[@]}"; do
+  uninstall_package "$PKG" 2>&1 | tee -a "$LOG"
+  if [ $? -ne 0 ]; then
+    overall_failed=1
+  fi
+done
+
+if [ $overall_failed -ne 0 ]; then
+  echo -e "${ERROR} Some packages failed to uninstall. Please check the log."
+fi
+
+printf "\n%.0s" {1..1}

install-scripts/03-Final-Check.sh

@@ -11,11 +11,11 @@ packages=(
   cliphist
   wlogout
   kitty
-  hyprland
 )
 
 # Local packages that should be in /usr/local/bin/
 local_pkgs_installed=(
+  hyprland
   rofi
   hypridle
   hyprlock
@@ -27,14 +27,17 @@ local_pkgs_installed_2=(
 )
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/00_CHECK-$(date +%d-%H%M%S)_installed.log"
@@ -74,7 +77,7 @@ done
 
 # Log missing packages
 if [ ${#missing[@]} -eq 0 ] && [ ${#local_missing[@]} -eq 0 ] && [ ${#local_missing_2[@]} -eq 0 ]; then
-    echo "${OK} All essential packages are installed." | tee -a "$LOG"
+    echo "${OK} GREAT! All ${YELLOW}essential packages${RESET} have been successfully installed." | tee -a "$LOG"
 else
     if [ ${#missing[@]} -ne 0 ]; then
         echo "${WARN} The following packages are not installed and will be logged:"

install-scripts/Global_functions.sh

@@ -71,7 +71,17 @@ install_package() {
 build_dep() { 
   echo -e "${INFO} building dependencies for ${MAGENTA}$1${RESET} "
     (
-      stdbuf -oL sudo build-dep -y "$1" 2>&1
+      stdbuf -oL sudo apt build-dep -y "$1" 2>&1
+    ) >> "$LOG" 2>&1 &
+    PID=$!
+    show_progress $PID "$1" 
+}
+
+# Function for cargo install with a progress bar
+cargo_install() { 
+  echo -e "${INFO} installing ${MAGENTA}$1${RESET} using cargo..."
+    (
+      stdbuf -oL cargo install "$1" 2>&1
     ) >> "$LOG" 2>&1 &
     PID=$!
     show_progress $PID "$1" 

install-scripts/InputGroup.sh

@@ -3,14 +3,17 @@
 # Adding users into input group #
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_input.log"

install-scripts/ags.sh

@@ -8,12 +8,20 @@ ags=(
     meson 
     libgjs-dev 
     gjs 
+    gobject-introspection
+    libgirepository1.0-dev
+    gir1.2-gtk-4.0
+    gir1.2-gtklayershell-0.1
     libgtk-layer-shell-dev 
     libgtk-3-dev
+    libadwaita-1-dev
     libpam0g-dev 
     libpulse-dev 
     libdbusmenu-gtk3-dev 
     libsoup-3.0-dev
+    ninja-build
+    build-essential
+    pkg-config
 )
 
 f_ags=(
@@ -28,14 +36,17 @@ build_dep=(
 ags_tag="v1.9.0"
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_ags.log"
@@ -45,8 +56,18 @@ MLOG="install-$(date +%d-%H%M%S)_ags2.log"
 if command -v ags &>/dev/null; then
     AGS_VERSION=$(ags -v | awk '{print $NF}')
     if [[ "$AGS_VERSION" == "1.9.0" ]]; then
-        printf "${INFO} ${MAGENTA}Aylur's GTK Shell v1.9.0${RESET} is already installed. Skipping installation."
+        printf "${INFO} ${MAGENTA}Aylur's GTK Shell v1.9.0${RESET} is already installed.\n"
+        read -r -p "Reinstall v1.9.0 anyway? [y/N]: " REPLY
+        case "$REPLY" in
+          [yY]|[yY][eE][sS])
+            printf "${NOTE} Reinstalling Aylur's GTK Shell v1.9.0...\n"
+            ;;
+          *)
+            printf "Skipping reinstallation.\n"
+            printf "\n%.0s" {1..2}
             exit 0
+            ;;
+        esac
     fi
 fi
 
@@ -71,32 +92,121 @@ done
 #install typescript by npm
 sudo npm install --global typescript 2>&1 | tee -a "$LOG"
 
-# ags
-printf "${INFO} Install and Compiling ${SKY_BLUE}Aylur's GTK shell $ags_tag${RESET} .. \n"
+# ags v1
+printf "${NOTE} Install and Compiling ${SKY_BLUE}Aylur's GTK shell $ags_tag${RESET}..\n"
 
-# Check if folder exists and remove it
-if [ -d "ags" ]; then
-    printf "${NOTE} Removing existing ags folder...\n"
-    rm -rf "ags"
+# Remove previous sources (both legacy "ags" and tagged "ags_v1.9.0")
+for SRC_DIR in "ags" "ags_v1.9.0"; do
+    if [ -d "$SRC_DIR" ]; then
+        printf "${NOTE} Removing existing %s directory...\\n" "$SRC_DIR"
+        rm -rf "$SRC_DIR"
     fi
+done
 
-# Clone nwg-look repository with the specified tag
-if git clone --recursive -b "$ags_tag" --depth 1 https://github.com/Aylur/ags.git; then
-    cd ags || exit 1
-    # Build and install ags
+printf "\n%.0s" {1..1}
+printf "${INFO} Kindly Standby...cloning and compiling ${SKY_BLUE}Aylur's GTK shell $ags_tag${RESET}...\n"
+printf "\n%.0s" {1..1}
+# Clone repository with the specified tag and capture git output into MLOG
+if git clone --depth=1 https://github.com/JaKooLit/ags_v1.9.0.git; then
+    cd ags_v1.9.0 || exit 1
     npm install
     meson setup build
    if sudo meson install -C build 2>&1 | tee -a "$MLOG"; then
-        printf "${OK} ${YELLOW}Aylur's GTK shell $ags_tag${RESET} installed successfully.\n" 2>&1 | tee -a "$MLOG"
-    else
-        echo -e "${ERROR} Installation failed for ${YELLOW}Aylur's GTK shell $ags_tag${RESET}" 2>&1 | tee -a "$MLOG"
+    printf "\n${OK} ${YELLOW}Aylur's GTK shell $ags_tag${RESET} installed successfully.\n" 2>&1 | tee -a "$MLOG"
+
+    # Patch installed AGS launchers to ensure GI typelibs in /usr/local/lib are discoverable in GJS ESM
+    printf "${NOTE} Applying AGS launcher patch for GI typelibs search path...\n"
+
+    patch_ags_launcher() {
+      local target="$1"
+      if ! sudo test -f "$target"; then
+        return 1
       fi
 
+      # 1) Remove deprecated GIR Repository path tweaks and GIRepository import (harmless if absent)
+      sudo sed -i \
+        -e '/Repository\.prepend_search_path/d' \
+        -e '/Repository\.prepend_library_path/d' \
+        -e '/gi:\/\/GIRepository/d' \
+        "$target"
+
+      # 2) Ensure GLib import exists (insert after first import line, or at top if none)
+      if ! sudo grep -q '^import GLib from "gi://GLib";' "$target"; then
+        TMPF=$(sudo mktemp)
+        sudo awk 'BEGIN{added=0} {
+          if (!added && $0 ~ /^import /) { print; print "import GLib from \"gi://GLib\";"; added=1; next }
+          print
+        } END { if (!added) print "import GLib from \"gi://GLib\";" }' "$target" | sudo tee "$TMPF" >/dev/null
+        sudo mv "$TMPF" "$target"
+      fi
+
+      # 3) Inject GI_TYPELIB_PATH export right after the GLib import (once)
+      if ! sudo grep -q 'GLib.setenv("GI_TYPELIB_PATH"' "$target"; then
+        TMPF=$(sudo mktemp)
+        sudo awk '{print} $0 ~ /^import GLib from "gi:\/\/GLib";$/ {print "const __old = GLib.getenv(\"GI_TYPELIB_PATH\");"; print "GLib.setenv(\"GI_TYPELIB_PATH\", \"/usr/local/lib/x86_64-linux-gnu:/usr/local/lib64:/usr/local/lib:/usr/local/lib64/girepository-1.0:/usr/local/lib/girepository-1.0:/usr/local/lib/x86_64-linux-gnu/girepository-1.0:/usr/lib/x86_64-linux-gnu/girepository-1.0:/usr/lib/girepository-1.0:/usr/lib/ags:/usr/local/lib/ags:/usr/lib64/ags\" + (__old ? \":\" + __old : \"\"), true);"; print "const __oldld = GLib.getenv(\"LD_LIBRARY_PATH\");"; print "GLib.setenv(\"LD_LIBRARY_PATH\", \"/usr/local/lib/x86_64-linux-gnu:/usr/local/lib64:/usr/local/lib\" + (__oldld ? \":\" + __oldld : \"\"), true);"}' "$target" | sudo tee "$TMPF" >/dev/null
+        sudo mv "$TMPF" "$target"
+      fi
+
+      # 4) Ensure LD_LIBRARY_PATH export exists even if GI_TYPELIB_PATH was already present
+      if ! sudo grep -q 'GLib.setenv("LD_LIBRARY_PATH"' "$target"; then
+        TMPF=$(sudo mktemp)
+        sudo awk '{print} $0 ~ /^import GLib from "gi:\/\/GLib";$/ {print "const __oldld = GLib.getenv(\"LD_LIBRARY_PATH\");"; print "GLib.setenv(\"LD_LIBRARY_PATH\", \"/usr/local/lib64:/usr/local/lib\" + (__oldld ? \":\" + __oldld : \"\"), true);"}' "$target" | sudo tee "$TMPF" >/dev/null
+        sudo mv "$TMPF" "$target"
+      fi
+
+      # Restore executable bit for bin wrappers (mv from mktemp resets mode to 0600)
+      case "$target" in
+        */bin/ags)
+          sudo chmod 0755 "$target" || true
+          ;;
+      esac
+
+      printf "${OK} Patched: %s\n" "$target"
+      return 0
+    }
+
+    # Try common locations
+    for CAND in \
+      "/usr/local/share/com.github.Aylur.ags/com.github.Aylur.ags" \
+      "/usr/share/com.github.Aylur.ags/com.github.Aylur.ags" \
+      "/usr/local/bin/ags" \
+      "/usr/bin/ags"; do
+      patch_ags_launcher "$CAND" || true
+    done
+
+    # Create an env-setting wrapper for AGS to ensure GI typelibs/libs are discoverable
+    printf "${NOTE} Creating env wrapper /usr/local/bin/ags...\n"
+    sudo tee /usr/local/bin/ags >/dev/null <<'WRAP'
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$HOME" 2>/dev/null || true
+# Locate AGS ESM entry
+MAIN_JS="/usr/local/share/com.github.Aylur.ags/com.github.Aylur.ags"
+if [ ! -f "$MAIN_JS" ]; then
+  MAIN_JS="/usr/share/com.github.Aylur.ags/com.github.Aylur.ags"
+fi
+if [ ! -f "$MAIN_JS" ]; then
+  echo "Unable to find AGS entry script (com.github.Aylur.ags) in /usr/local/share or /usr/share" >&2
+  exit 1
+fi
+# Ensure GI typelibs and native libs are discoverable before gjs ESM loads
+export GI_TYPELIB_PATH="/usr/local/lib/x86_64-linux-gnu:/usr/local/lib64:/usr/local/lib:/usr/local/lib64/girepository-1.0:/usr/local/lib/girepository-1.0:/usr/local/lib/x86_64-linux-gnu/girepository-1.0:/usr/lib/x86_64-linux-gnu/girepository-1.0:/usr/lib/girepository-1.0:/usr/lib64/girepository-1.0:/usr/lib/ags:/usr/local/lib/ags:/usr/lib64/ags:${GI_TYPELIB_PATH-}"
+export LD_LIBRARY_PATH="/usr/local/lib/x86_64-linux-gnu:/usr/local/lib64:/usr/local/lib:${LD_LIBRARY_PATH-}"
+exec /usr/bin/gjs -m "$MAIN_JS" "$@"
+WRAP
+    sudo chmod 0755 /usr/local/bin/ags
+    # Ensure ESM entry is readable by gjs
+    sudo chmod 0644 /usr/local/share/com.github.Aylur.ags/com.github.Aylur.ags 2>/dev/null || true
+    sudo chmod 0644 /usr/share/com.github.Aylur.ags/com.github.Aylur.ags 2>/dev/null || true
+    printf "${OK} AGS wrapper installed at /usr/local/bin/ags\n"
+  else
+    echo -e "\n${ERROR} ${YELLOW}Aylur's GTK shell $ags_tag${RESET} Installation failed\n " 2>&1 | tee -a "$MLOG"
+   fi
     # Move logs to Install-Logs directory
     mv "$MLOG" ../Install-Logs/ || true
     cd ..
 else
-    echo -e "${ERROR} Failed to download ${YELLOW}Aylur's GTK shell $ags_tag${RESET} . Please check your connection" 2>&1 | tee -a "$LOG"
+    echo -e "\n${ERROR} Failed to download ${YELLOW}Aylur's GTK shell $ags_tag${RESET} Please check your connection\n" 2>&1 | tee -a "$LOG"
     mv "$MLOG" ../Install-Logs/ || true
     exit 1
 fi

install-scripts/aquamarine.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# Hypr Ecosystem #
+# aquamarine #
+
+
+#specific branch or release
+tag="v0.10.0"
+# Allow environment override
+if [ -n "${AQUAMARINE_TAG:-}" ]; then tag="$AQUAMARINE_TAG"; fi
+
+# Dry-run support
+DO_INSTALL=1
+if [ "$1" = "--dry-run" ] || [ "${DRY_RUN}" = "1" ] || [ "${DRY_RUN}" = "true" ]; then
+    DO_INSTALL=0
+    echo "${NOTE} DRY RUN: install step will be skipped."
+fi
+
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_aquamarine.log"
+MLOG="install-$(date +%d-%H%M%S)_aquamarine.log"
+
+# Installation of dependencies
+printf "\n%s - Installing ${YELLOW}aquamarine dependencies${RESET} .... \n" "${INFO}"
+
+# Check if aquamarinedirectory exists and remove it
+if [ -d "aquamarine" ]; then
+    rm -rf "aquamarine"
+fi
+
+# Clone and build 
+printf "${INFO} Installing ${YELLOW}aquamarine $tag${RESET} ...\n"
+if git clone --recursive -b $tag https://github.com/hyprwm/aquamarine.git; then
+    cd aquamarine || exit 1
+	cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr/local -S . -B ./build
+	cmake --build ./build --config Release --target all -j`nproc 2>/dev/null || getconf NPROCESSORS_CONF`
+    if [ $DO_INSTALL -eq 1 ]; then
+        if sudo cmake --install ./build 2>&1 | tee -a "$MLOG" ; then
+            printf "${OK} ${MAGENTA}aquamarine $tag${RESET} installed successfully.\n" 2>&1 | tee -a "$MLOG"
+        else
+            echo -e "${ERROR} Installation failed for ${YELLOW}aquamarine $tag${RESET}" 2>&1 | tee -a "$MLOG"
+        fi
+    else
+        echo "${NOTE} DRY RUN: Skipping installation of aquamarine $tag."
+    fi
+    #moving the addional logs to Install-Logs directory
+    [ -f "$MLOG" ] && mv "$MLOG" ../Install-Logs/
+    cd ..
+else
+    echo -e "${ERROR} Download failed for ${YELLOW}aquamarine $tag${RESET}" 2>&1 | tee -a "$LOG"
+fi
+
+printf "\n%.0s" {1..2}

install-scripts/bluetooth.sh

@@ -8,14 +8,17 @@ blue=(
 )
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_bluetooth.log"

install-scripts/dotfiles-branch.sh

@@ -3,11 +3,23 @@
 # Hyprland-Dots to download from main #
 
 #specific branch or release
-dots_tag="Deb-Untu-Dots"
+dots_tag="main"
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || {
+    echo "${ERROR} Failed to change directory to $PARENT_DIR"
+    exit 1
+}
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+    echo "Failed to source Global_functions.sh"
+    exit 1
+fi
 
 # Check if Hyprland-Dots exists
 printf "${NOTE} Cloning and Installing ${SKY_BLUE}KooL's Hyprland Dots for Debian${RESET}....\n"
@@ -15,13 +27,11 @@ printf "${NOTE} Cloning and Installing ${SKY_BLUE}KooL's Hyprland Dots for Debia
 # Check if Hyprland-Dots exists
 if [ -d Hyprland-Dots-Debian ]; then
     cd Hyprland-Dots-Debian
-  git stash
-  git pull
-  git stash apply
+    git stash && git pull
     chmod +x copy.sh
     ./copy.sh
 else
-  if git clone --depth 1 -b $dots_tag https://github.com/JaKooLit/Hyprland-Dots Hyprland-Dots-Debian; then
+    if git clone --depth=1 https://github.com/JaKooLit/Hyprland-Dots Hyprland-Dots-Debian; then
         cd Hyprland-Dots-Debian || exit 1
         chmod +x copy.sh
         ./copy.sh

install-scripts/dotfiles.sh

@@ -3,7 +3,8 @@
 # Hyprland-Dots to download a specific release #
 
 # Define the specific release version to download
-specific_version="v2.3.3-Deb-Untu-Hyprland-0.41.2"
+specific_version="v2.3.16"
+#specific_version="v2.3.3-Deb-Untu-Hyprland-0.41.2"
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
 
@@ -56,7 +57,7 @@ if curl -L "$tarball_url" -o "Hyprland-Dots-${specific_version}.tar.gz"; then
     chmod +x copy.sh
     ./copy.sh
 
-  echo -e "${OK} Hyprland-Dots-${specific_version} release downloaded, extracted, and processed successfully. Check JaKooLit-Hyprland-Dots folder for more detailed install logs" 2>&1 | tee -a "../Install-Logs/install-$(date +'%d-%H%M%S')_dotfiles.log"
+    echo -e "${OK} Hyprland-Dots-${specific_version} release downloaded, extracted, and processed successfully. Check JaKooLit-Hyprland-Dots directory for more detailed install logs" 2>&1 | tee -a "../Install-Logs/install-$(date +'%d-%H%M%S')_dotfiles.log"
 else
     echo -e "${ERROR} Failed to download Hyprland-Dots-${specific_version} release." 2>&1 | tee -a "../Install-Logs/install-$(date +'%d-%H%M%S')_dotfiles.log"
     exit 1

install-scripts/fonts.sh

@@ -11,14 +11,17 @@ fonts=(
 )
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_fonts.log"
@@ -43,13 +46,13 @@ for ((ATTEMPT = 1; ATTEMPT <= MAX_ATTEMPTS; ATTEMPT++)); do
     sleep 2
 done
 
-# Check if the JetBrainsMono folder exists and delete it if it does
+# Check if the JetBrainsMono directory exists and delete it if it does
 if [ -d ~/.local/share/fonts/JetBrainsMonoNerd ]; then
     rm -rf ~/.local/share/fonts/JetBrainsMonoNerd 2>&1 | tee -a "$LOG"
 fi
 
 mkdir -p ~/.local/share/fonts/JetBrainsMonoNerd 2>&1 | tee -a "$LOG"
-# Extract the new files into the JetBrainsMono folder and log the output
+# Extract the new files into the JetBrainsMono directory and log the output
 tar -xJkf JetBrainsMono.tar.xz -C ~/.local/share/fonts/JetBrainsMonoNerd 2>&1 | tee -a "$LOG"
 
 # Fantasque Mono Nerd Font

install-scripts/gtk_themes.sh

@@ -8,15 +8,17 @@ engine=(
 )
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_themes.log"
@@ -29,17 +31,17 @@ done
 
 # Check if the directory exists and delete it if present
 if [ -d "GTK-themes-icons" ]; then
-    echo "$NOTE GTK themes and Icons folder exist..deleting..." 2>&1 | tee -a "$LOG"
+    echo "$NOTE GTK themes and Icons directory exist..deleting..." 2>&1 | tee -a "$LOG"
     rm -rf "GTK-themes-icons" 2>&1 | tee -a "$LOG"
 fi
 
 echo "$NOTE Cloning ${SKY_BLUE}GTK themes and Icons${RESET} repository..." 2>&1 | tee -a "$LOG"
-if git clone --depth 1 https://github.com/JaKooLit/GTK-themes-icons.git ; then
+if git clone --depth=1 https://github.com/JaKooLit/GTK-themes-icons.git ; then
     cd GTK-themes-icons
     chmod +x auto-extract.sh
     ./auto-extract.sh
     cd ..
-    echo "$OK Extracted GTK Themes & Icons to ~/.icons & ~/.themes folders" 2>&1 | tee -a "$LOG"
+    echo "$OK Extracted GTK Themes & Icons to ~/.icons & ~/.themes directories" 2>&1 | tee -a "$LOG"
 else
     echo "$ERROR Download failed for GTK themes and Icons.." 2>&1 | tee -a "$LOG"
 fi

install-scripts/hyprcursor.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# Hypr Ecosystem #
+# hyprcursor #
+
+cursor=(
+libzip-dev
+librsvg2-dev
+)
+
+#specific branch or release
+tag="v0.1.13"
+
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_hyprcursor.log"
+MLOG="install-$(date +%d-%H%M%S)_hyprcursor.log"
+
+# Installation of dependencies
+printf "\n%s - Installing hyprcursor dependencies.... \n" "${NOTE}"
+
+for PKG1 in "${cursor[@]}"; do
+  install_package "$PKG1" 2>&1 | tee -a "$LOG"
+  if [ $? -ne 0 ]; then
+    echo -e "\e[1A\e[K${ERROR} - $PKG1 Package installation failed, Please check the installation logs"
+    exit 1
+  fi
+done
+
+# Check if hyprcursor folder exists and remove it
+if [ -d "hyprcursor" ]; then
+    printf "${NOTE} Removing existing hyprcursor folder...\n"
+    rm -rf "hyprcursor"
+fi
+
+# Clone and build 
+printf "${NOTE} Installing hyprcursor...\n"
+if git clone --recursive -b $tag https://github.com/hyprwm/hyprcursor.git; then
+    cd hyprcursor || exit 1
+	cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr -S . -B ./build
+	cmake --build ./build --config Release --target all -j`nproc 2>/dev/null || getconf NPROCESSORS_CONF`
+    if sudo cmake --install ./build 2>&1 | tee -a "$MLOG" ; then
+        printf "${OK} hyprcursor installed successfully.\n" 2>&1 | tee -a "$MLOG"
+    else
+        echo -e "${ERROR} Installation failed for hyprcursor." 2>&1 | tee -a "$MLOG"
+    fi
+    #moving the addional logs to Install-Logs directory
+    mv $MLOG ../Install-Logs/ || true 
+    cd ..
+else
+    echo -e "${ERROR} Download failed for hyprcursor." 2>&1 | tee -a "$LOG"
+fi
+
+printf "\n%.0s" {1..2}
+
+

install-scripts/hyprgraphics.sh

@@ -0,0 +1,78 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# Hypr Ecosystem #
+# hyprgraphics #
+
+hyprgraphics=(
+	libmagic
+)
+
+#specific branch or release
+tag="v0.4.0"
+# Allow environment override
+if [ -n "${HYPRGRAPHICS_TAG:-}" ]; then tag="$HYPRGRAPHICS_TAG"; fi
+
+# Dry-run support
+DO_INSTALL=1
+if [ "$1" = "--dry-run" ] || [ "${DRY_RUN}" = "1" ] || [ "${DRY_RUN}" = "true" ]; then
+    DO_INSTALL=0
+    echo "${NOTE} DRY RUN: install step will be skipped."
+fi
+
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_hyprgraphics.log"
+MLOG="install-$(date +%d-%H%M%S)_hyprgraphics2.log"
+
+# Installation of dependencies
+printf "\n%s - Installing ${YELLOW}hyprgraphics dependencies${RESET} .... \n" "${INFO}"
+
+for PKG1 in "${hyprgraphics[@]}"; do
+  re_install_package "$PKG1" 2>&1 | tee -a "$LOG"
+  if [ $? -ne 0 ]; then
+    echo -e "\e[1A\e[K${ERROR} - $PKG1 Package installation failed, Please check the installation logs"
+    exit 1
+  fi
+done
+printf "\n%.0s" {1..1}
+
+# Check if hyprgraphics directory exists and remove it
+if [ -d "hyprgraphics" ]; then
+    rm -rf "hyprgraphics"
+fi
+
+# Clone and build 
+printf "${INFO} Installing ${YELLOW}hyprgraphics $tag${RESET} ...\n"
+if git clone --recursive -b $tag https://github.com/hyprwm/hyprgraphics.git; then
+    cd hyprgraphics || exit 1
+	cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr -S . -B ./build
+	cmake --build ./build --config Release --target hyprgraphics -j`nproc 2>/dev/null || getconf _NPROCESSORS_CONF`
+    if [ $DO_INSTALL -eq 1 ]; then
+        if sudo cmake --install ./build 2>&1 | tee -a "$MLOG" ; then
+            printf "${OK} ${MAGENTA}hyprgraphics $tag${RESET} installed successfully.\n" 2>&1 | tee -a "$MLOG"
+        else
+            echo -e "${ERROR} Installation failed for ${YELLOW}hyprgraphics $graphics${RESET}" 2>&1 | tee -a "$MLOG"
+        fi
+    else
+        echo "${NOTE} DRY RUN: Skipping installation of hyprgraphics $tag."
+    fi
+    #moving the addional logs to Install-Logs directory
+    [ -f "$MLOG" ] && mv "$MLOG" ../Install-Logs/
+    cd ..
+else
+    echo -e "${ERROR} Download failed for ${YELLOW}hyprgraphics $graphics${RESET}" 2>&1 | tee -a "$LOG"
+fi
+
+printf "\n%.0s" {1..2}

install-scripts/hypridle.sh

@@ -4,21 +4,23 @@
 
 idle=(
     libsdbus-c++-dev
-    libhyprlang-dev
 )
 
 #specific branch or release
-idle_tag="v0.1.2"
+tag="v0.1.6"
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_hypridle.log"
@@ -35,27 +37,27 @@ for PKG1 in "${idle[@]}"; do
   fi
 done
 
-# Check if hypridle folder exists and remove it
+# Check if hypridle directory exists and remove it
 if [ -d "hypridle" ]; then
     rm -rf "hypridle"
 fi
 
 # Clone and build 
-printf "${INFO} Installing ${YELLOW}hypridle $idle_tag${RESET} ...\n"
-if git clone --recursive -b $idle_tag https://github.com/hyprwm/hypridle.git; then
+printf "${INFO} Installing ${YELLOW}hypridle $tag${RESET} ...\n"
+if git clone --recursive -b $tag https://github.com/hyprwm/hypridle.git; then
     cd hypridle || exit 1
 	cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -S . -B ./build
 	cmake --build ./build --config Release --target hypridle -j`nproc 2>/dev/null || getconf NPROCESSORS_CONF`
     if sudo cmake --install ./build 2>&1 | tee -a "$MLOG" ; then
-        printf "${OK} ${MAGENTA}hypridle $idle_tag${RESET} installed successfully.\n" 2>&1 | tee -a "$MLOG"
+        printf "${OK} ${MAGENTA}hypridle $tag${RESET} installed successfully.\n" 2>&1 | tee -a "$MLOG"
     else
-        echo -e "${ERROR} Installation failed for ${YELLOW}hypridle $idle_tag${RESET}" 2>&1 | tee -a "$MLOG"
+        echo -e "${ERROR} Installation failed for ${YELLOW}hypridle $tag${RESET}" 2>&1 | tee -a "$MLOG"
     fi
     #moving the addional logs to Install-Logs directory
     mv $MLOG ../Install-Logs/ || true 
     cd ..
 else
-    echo -e "${ERROR} Download failed for ${YELLOW}hypridle $idle_tag${RESET}" 2>&1 | tee -a "$LOG"
+    echo -e "${ERROR} Download failed for ${YELLOW}hypridle $tag${RESET}" 2>&1 | tee -a "$LOG"
 fi
 
 printf "\n%.0s" {1..2}

install-scripts/hyprland-guiutils.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# Hypr Ecosystem #
+# hypland-guiutils #
+
+guiutils=(
+	libqt6core5compat6
+    qt6-base-dev
+	qt6-wayland-dev
+    qt6-wayland
+	qt6-declarative-dev
+	qml6-module-qtcore
+	qt6-3d-dev
+	qt6-5compat-dev
+    libqt6waylandclient6
+    qml6-module-qtwayland-client-texturesharing
+)
+
+#specific branch or release
+tag="v0.2.0"
+# Allow environment override
+if [ -n "${HYPRLAND_GUIUTILS_TAG:-}" ]; then tag="$HYPRLAND_GUIUTILS_TAG"; fi
+
+# Dry-run support
+DO_INSTALL=1
+if [ "$1" = "--dry-run" ] || [ "${DRY_RUN}" = "1" ] || [ "${DRY_RUN}" = "true" ]; then
+    DO_INSTALL=0
+    echo "${NOTE} DRY RUN: install step will be skipped."
+fi
+
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_hyprland-guiutils.log"
+MLOG="install-$(date +%d-%H%M%S)_hyprland-guiutils2.log"
+
+# Installation of dependencies
+printf "\n%s - Installing ${YELLOW}hyprland-guiutils dependencies${RESET} .... \n" "${INFO}"
+
+for PKG1 in "${guiutils[@]}"; do
+  re_install_package "$PKG1" 2>&1 | tee -a "$LOG"
+  if [ $? -ne 0 ]; then
+    echo -e "\e[1A\e[K${ERROR} - ${YELLOW}$PKG1${RESET} Package installation failed, Please check the installation logs"
+    exit 1
+  fi
+done
+
+printf "\n%.0s" {1..1}
+
+# Check if hyprland-guiutils directory exists and remove it
+if [ -d "hyprland-guiutils" ]; then
+    rm -rf "hyprland-guiutils"
+fi
+
+# Clone and build 
+printf "${INFO} Installing ${YELLOW}hyprland-guiutils $tag${RESET} ...\n"
+if git clone --recursive -b $tag https://github.com/hyprwm/hyprland-guiutils.git; then
+    cd hyprland-guiutils || exit 1
+	cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr -S . -B ./build
+	cmake --build ./build --config Release --target all -j`nproc 2>/dev/null || getconf NPROCESSORS_CONF`
+    if [ $DO_INSTALL -eq 1 ]; then
+        if sudo cmake --install ./build 2>&1 | tee -a "$MLOG" ; then
+            printf "${OK} ${MAGENTA}hyprland-guiutils $tag${RESET} installed successfully.\n" 2>&1 | tee -a "$MLOG"
+        else
+            echo -e "${ERROR} Installation failed for ${YELLOW}hyprland-guiutils $tag${RESET}" 2>&1 | tee -a "$MLOG"
+        fi
+    else
+        echo "${NOTE} DRY RUN: Skipping installation of hyprland-guiutils $tag."
+    fi
+    #moving the addional logs to Install-Logs directory
+    [ -f "$MLOG" ] && mv "$MLOG" ../Install-Logs/
+    cd ..
+else
+    echo -e "${ERROR} Download failed for ${YELLOW}hyprland-guiutils $tag${RESET}" 2>&1 | tee -a "$LOG"
+fi
+
+printf "\n%.0s" {1..2}

install-scripts/hyprland-protocols.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# Hypr Ecosystem #
+# hypland-protocols #
+
+
+#specific branch or release
+tag="v0.7.0"
+# Allow environment override
+if [ -n "${HYPRLAND_PROTOCOLS_TAG:-}" ]; then tag="$HYPRLAND_PROTOCOLS_TAG"; fi
+
+# Dry-run support
+DO_INSTALL=1
+if [ "$1" = "--dry-run" ] || [ "${DRY_RUN}" = "1" ] || [ "${DRY_RUN}" = "true" ]; then
+    DO_INSTALL=0
+    echo "${NOTE} DRY RUN: install step will be skipped."
+fi
+
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_protocols.log"
+MLOG="install-$(date +%d-%H%M%S)_protocols2.log"
+
+# Installation of dependencies
+printf "\n%s - Installing ${YELLOW}hyprland-protocols dependencies${RESET} .... \n" "${INFO}"
+
+# Check if hyprland-protocols directory exists and remove it
+if [ -d "hyprland-protocols" ]; then
+    rm -rf "hyprland-protocols"
+fi
+
+# Clone and build 
+printf "${INFO} Installing ${YELLOW}hyprland-protocols $tag${RESET} ...\n"
+if git clone --recursive -b $tag https://github.com/hyprwm/hyprland-protocols.git; then
+    cd hyprland-protocols || exit 1
+	meson setup build
+    if [ $DO_INSTALL -eq 1 ]; then
+        if sudo meson install -C build 2>&1 | tee -a "$MLOG" ; then
+            printf "${OK} ${MAGENTA}hyprland-protocols $tag${RESET} installed successfully.\n" 2>&1 | tee -a "$MLOG"
+        else
+            echo -e "${ERROR} Installation failed for ${YELLOW}hyprland-protocols $tag${RESET}" 2>&1 | tee -a "$MLOG"
+        fi
+    else
+        echo "${NOTE} DRY RUN: Skipping installation of hyprland-protocols $tag."
+    fi
+    #moving the addional logs to Install-Logs directory
+    [ -f "$MLOG" ] && mv "$MLOG" ../Install-Logs/
+    cd ..
+else
+    echo -e "${ERROR} Download failed for ${YELLOW}hyprland-protocols tag${RESET}" 2>&1 | tee -a "$LOG"
+fi
+
+printf "\n%.0s" {1..2}

install-scripts/hyprland-qt-support.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# Hypr Ecosystem #
+# hypland-qt-support #
+
+qt_support=(
+    qt6-base-dev
+    qt6-wayland
+    qt6-declarative-dev
+    qml6-module-qtcore
+    qml6-module-qtquick-layouts
+    qt6-tools-dev
+    qt6-tools-dev-tools
+    qt6-charts-dev
+)
+
+#specific branch or release
+tag="v0.1.0"
+# Allow environment override
+if [ -n "${HYPRLAND_QT_SUPPORT_TAG:-}" ]; then tag="$HYPRLAND_QT_SUPPORT_TAG"; fi
+
+# Dry-run support
+DO_INSTALL=1
+if [ "$1" = "--dry-run" ] || [ "${DRY_RUN}" = "1" ] || [ "${DRY_RUN}" = "true" ]; then
+    DO_INSTALL=0
+    echo "${NOTE} DRY RUN: install step will be skipped."
+fi
+
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_hyprland-qt-support.log"
+MLOG="install-$(date +%d-%H%M%S)_hyprland-qt-support2.log"
+
+# Installation of dependencies
+printf "\n%s - Installing ${YELLOW}hyprland-qt-support dependencies${RESET} .... \n" "${INFO}"
+
+for PKG1 in "${qt_support[@]}"; do
+  re_install_package "$PKG1" 2>&1 | tee -a "$LOG"
+  if [ $? -ne 0 ]; then
+    echo -e "\e[1A\e[K${ERROR} - ${YELLOW}$PKG1${RESET} Package installation failed, Please check the installation logs"
+    exit 1
+  fi
+done
+
+printf "\n%.0s" {1..1}
+
+# Check if hyprland-qt-support directory exists and remove it
+if [ -d "hyprland-qt-support" ]; then
+    rm -rf "hyprland-qt-support"
+fi
+
+# Clone and build 
+printf "${INFO} Installing ${YELLOW}hyprland-qt-support $tag${RESET} ...\n"
+if git clone --recursive -b $tag https://github.com/hyprwm/hyprland-qt-support.git; then
+    cd hyprland-qt-support || exit 1
+	cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr -S . -B ./build
+	cmake --build ./build --config Release --target all -j`nproc 2>/dev/null || getconf NPROCESSORS_CONF`
+    if [ $DO_INSTALL -eq 1 ]; then
+        if sudo cmake --install ./build 2>&1 | tee -a "$MLOG" ; then
+            printf "${OK} ${MAGENTA}hyprland-qt-support $tag${RESET} installed successfully.\n" 2>&1 | tee -a "$MLOG"
+        else
+            echo -e "${ERROR} Installation failed for ${YELLOW}hyprland-qt-support $tag${RESET}" 2>&1 | tee -a "$MLOG"
+        fi
+    else
+        echo "${NOTE} DRY RUN: Skipping installation of hyprland-qt-support $tag."
+    fi
+    #moving the addional logs to Install-Logs directory
+    [ -f "$MLOG" ] && mv "$MLOG" ../Install-Logs/
+    cd ..
+else
+    echo -e "${ERROR} Download failed for ${YELLOW}hyprland-qt-support $tag${RESET}" 2>&1 | tee -a "$LOG"
+fi
+
+printf "\n%.0s" {1..2}

install-scripts/hyprland.sh

@@ -2,20 +2,29 @@
 # 💫 https://github.com/JaKooLit 💫 #
 # Main Hyprland Package#
 
-hypr=(
-  libhyprutils0
-  libhyprlang-dev
-  hyprwayland-scanner
-  hyprland-protocols
-)
+#specific branch or release
+tag="v0.52.2"
+# Allow environment override
+if [ -n "${HYPRLAND_TAG:-}" ]; then tag="$HYPRLAND_TAG"; fi
 
-# forcing to reinstall. Had experience it says hyprland is already installed
-f_hypr=(
-  hyprland
+# Dry-run support
+DO_INSTALL=1
+if [ "$1" = "--dry-run" ] || [ "${DRY_RUN}" = "1" ] || [ "${DRY_RUN}" = "true" ]; then
+    DO_INSTALL=0
+    echo "${NOTE} DRY RUN: install step will be skipped."
+fi
+
+hyprland=(
+  clang
+  llvm
+  libxcb-errors-dev
+  libre2-dev
+  libglaze-dev
+  libudis86-dev
+  libinotify-ocaml-dev
 )
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-
 # Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
@@ -23,21 +32,102 @@ SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 PARENT_DIR="$SCRIPT_DIR/.."
 cd "$PARENT_DIR" || exit 1
 
-# Set the name of the log file to include the current date and time
-LOG="Install-Logs/install-$(date +%d-%H%M%S)_hyprland.log"
-
 source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
 
-# Hyprland
-printf "${NOTE} Installing ${SKY_BLUE}Hyprland packages${RESET} .......\n"
- for HYPR in "${hypr[@]}"; do
-   install_package "$HYPR" "$LOG"
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_hyprland.log"
+MLOG="install-$(date +%d-%H%M%S)_hyprland2.log"
+
+# Installation of dependencies
+printf "\n%s - Installing hyprland additional dependencies.... \n" "${NOTE}"
+
+for PKG1 in "${hyprland[@]}"; do
+  install_package "$PKG1" 2>&1 | tee -a "$LOG"
+  if [ $? -ne 0 ]; then
+    echo -e "\e[1A\e[K${ERROR} - $PKG1 Package installation failed, Please check the installation logs"
+    exit 1
+  fi
 done
 
-# force
-printf "${NOTE} Reinstalling ${SKY_BLUE}Hyprland packages${RESET}  .......\n"
- for HYPR1 in "${f_hypr[@]}"; do
-   re_install_package "$HYPR1" "$LOG"
-done
+printf "\n%.0s" {1..1}
+
+# Installation of dependencies (glaze)
+printf "\n%s - Installing Hyprland additional dependencies (glaze).... \n" "${NOTE}"
+
+# Check if /usr/include/glaze exists
+if [ ! -d /usr/include/glaze ]; then
+    echo "${INFO} ${YELLOW}Glaze${RESET} is not installed. Installing ${YELLOW}glaze from assets${RESET} ..."
+    sudo dpkg -i assets/libglaze-dev_4.4.3-1_all.deb 2>&1 | tee -a "$LOG"
+    sudo apt-get install -f -y 2>&1 | tee -a "$LOG"
+    echo "${INFO} ${YELLOW}libglaze-dev from assets${RESET} installed."
+fi
+
+
+printf "\n%.0s" {1..1}
+
+# Clone, build, and install Hyprland using Cmake
+printf "${NOTE} Cloning and Installing ${YELLOW}Hyprland $tag${RESET} ...\n"
+
+# Check if Hyprland folder exists and remove it
+if [ -d "Hyprland" ]; then
+  printf "${NOTE} Removing existing Hyprland folder...\n"
+  rm -rf "Hyprland" 2>&1 | tee -a "$LOG"
+fi
+
+if git clone --recursive -b $tag "https://github.com/hyprwm/Hyprland"; then
+  cd "Hyprland" || exit 1
+  # Apply patch only if it applies cleanly; otherwise skip
+  if [ -f ../assets/0001-fix-hyprland-compile-issue.patch ]; then
+    if patch -p1 --dry-run < ../assets/0001-fix-hyprland-compile-issue.patch >/dev/null 2>&1; then
+      patch -p1 < ../assets/0001-fix-hyprland-compile-issue.patch
+    else
+      echo "${NOTE} Hyprland compile patch does not apply on $tag; skipping."
+    fi
+  fi
+  # By default, build Hyprland with bundled hyprutils/hyprlang to avoid version mismatches
+  # You can force system libs by exporting USE_SYSTEM_HYPRLIBS=1 before running this script.
+USE_SYSTEM=${USE_SYSTEM_HYPRLIBS:-1}
+  if [ "$USE_SYSTEM" = "1" ]; then
+    export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:/usr/local/share/pkgconfig:${PKG_CONFIG_PATH:-}"
+    export CMAKE_PREFIX_PATH="/usr/local:${CMAKE_PREFIX_PATH:-}"
+    SYSTEM_FLAGS=("-DUSE_SYSTEM_HYPRUTILS=ON" "-DUSE_SYSTEM_HYPRLANG=ON")
+  else
+    # Ensure we do not accidentally pick up mismatched system headers
+    unset PKG_CONFIG_PATH || true
+    SYSTEM_FLAGS=("-DUSE_SYSTEM_HYPRUTILS=OFF" "-DUSE_SYSTEM_HYPRLANG=OFF")
+  fi
+
+  # Make sure submodules are present when building bundled deps
+  git submodule update --init --recursive || true
+
+  # Force Clang toolchain to support required language features and flags
+  export CC="${CC:-clang}"
+  export CXX="${CXX:-clang++}"
+  CONFIG_FLAGS=(
+    -DCMAKE_BUILD_TYPE=Release
+    -DCMAKE_C_COMPILER="${CC}"
+    -DCMAKE_CXX_COMPILER="${CXX}"
+    -DCMAKE_CXX_STANDARD=26
+    -DCMAKE_CXX_STANDARD_REQUIRED=ON
+    -DCMAKE_CXX_EXTENSIONS=ON
+    "${SYSTEM_FLAGS[@]}"
+  )
+  cmake -S . -B build "${CONFIG_FLAGS[@]}"
+  cmake --build build -j "$(nproc 2>/dev/null || getconf _NPROCESSORS_CONF)"
+
+  if [ $DO_INSTALL -eq 1 ]; then
+    if sudo cmake --install build 2>&1 | tee -a "$MLOG"; then
+      printf "${OK} ${MAGENTA}Hyprland tag${RESET}  installed successfully.\n" 2>&1 | tee -a "$MLOG"
+    else
+      echo -e "${ERROR} Installation failed for ${YELLOW}Hyprland $tag${RESET}" 2>&1 | tee -a "$MLOG"
+    fi
+  else
+    echo "${NOTE} DRY RUN: Skipping installation of Hyprland $tag."
+  fi
+  [ -f "$MLOG" ] && mv "$MLOG" ../Install-Logs/
+  cd ..
+else
+  echo -e "${ERROR} Download failed for ${YELLOW}Hyprland $tag${RESET}" 2>&1 | tee -a "$LOG"
+fi
 
 printf "\n%.0s" {1..2}

install-scripts/hyprlang.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# Hypr Ecosystem #
+# hyplang #
+
+
+#specific branch or release
+tag="v0.6.7"
+# Allow environment override
+if [ -n "${HYPRLANG_TAG:-}" ]; then tag="$HYPRLANG_TAG"; fi
+
+# Dry-run support
+DO_INSTALL=1
+if [ "$1" = "--dry-run" ] || [ "${DRY_RUN}" = "1" ] || [ "${DRY_RUN}" = "true" ]; then
+    DO_INSTALL=0
+    echo "${NOTE} DRY RUN: install step will be skipped."
+fi
+
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_hyprlang.log"
+MLOG="install-$(date +%d-%H%M%S)_hyprlang2.log"
+
+# Installation of dependencies
+printf "\n%s - Installing ${YELLOW}hyprlang dependencies${RESET} .... \n" "${INFO}"
+
+# Check if hyprlang directory exists and remove it
+if [ -d "hyprlang" ]; then
+    rm -rf "hyprlang"
+fi
+
+# Clone and build 
+printf "${INFO} Installing ${YELLOW}hyprlang $tag${RESET} ...\n"
+if git clone --recursive -b $tag https://github.com/hyprwm/hyprlang.git; then
+    cd hyprlang || exit 1
+	cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr/local -S . -B ./build
+	cmake --build ./build --config Release --target hyprlang -j`nproc 2>/dev/null || getconf _NPROCESSORS_CONF`
+    if [ $DO_INSTALL -eq 1 ]; then
+        if sudo cmake --install ./build 2>&1 | tee -a "$MLOG" ; then
+            printf "${OK} ${MAGENTA}hyprlang tag${RESET} installed successfully.\n" 2>&1 | tee -a "$MLOG"
+        else
+            echo -e "${ERROR} Installation failed for ${YELLOW}hyprlang $tag${RESET}" 2>&1 | tee -a "$MLOG"
+        fi
+    else
+        echo "${NOTE} DRY RUN: Skipping installation of hyprlang $tag."
+    fi
+    #moving the addional logs to Install-Logs directory
+    [ -f "$MLOG" ] && mv "$MLOG" ../Install-Logs/
+    cd ..
+else
+    echo -e "${ERROR} Download failed for ${YELLOW}hyprlang $tag${RESET}" 2>&1 | tee -a "$LOG"
+fi
+
+printf "\n%.0s" {1..2}

install-scripts/hyprlock.sh

@@ -7,22 +7,29 @@ lock=(
 	libgbm-dev
 	libdrm-dev
     libmagic-dev
-    libhyprlang-dev
-    libhyprutils-dev
+    libaudit-dev
+    libsdbus-c++-dev
+)
+
+build_dep=(
+    pam
 )
 
 #specific branch or release
-lock_tag="v0.4.0"
+tag="v0.9.1"
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_hyprlock.log"
@@ -35,27 +42,31 @@ for PKG1 in "${lock[@]}"; do
   re_install_package "$PKG1" "$LOG"
 done
 
-# Check if hyprlock folder exists and remove it
+for PKG1 in "${build_dep[@]}"; do
+  build_dep "$PKG1" "$LOG"
+done
+
+# Check if hyprlock directory exists and remove it
 if [ -d "hyprlock" ]; then
     rm -rf "hyprlock"
 fi
 
 # Clone and build hyprlock
-printf "${INFO} Installing ${YELLOW}hyprlock $lock_tag${RESET} ...\n"
-if git clone --recursive -b $lock_tag https://github.com/hyprwm/hyprlock.git; then
+printf "${INFO} Installing ${YELLOW}hyprlock $tag${RESET} ...\n"
+if git clone --recursive -b $tag https://github.com/hyprwm/hyprlock.git; then
     cd hyprlock || exit 1
 	cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -S . -B ./build
 	cmake --build ./build --config Release --target hyprlock -j`nproc 2>/dev/null || getconf _NPROCESSORS_CONF`
     if sudo cmake --install build 2>&1 | tee -a "$MLOG" ; then
-        printf "${OK} ${YELLOW}hyprlock $lock_tag${RESET} installed successfully.\n" 2>&1 | tee -a "$MLOG"
+        printf "${OK} ${YELLOW}hyprlock $tag${RESET} installed successfully.\n" 2>&1 | tee -a "$MLOG"
     else
-        echo -e "${ERROR} Installation failed for ${YELLOW}hyprlock $lock_tag${RESET}" 2>&1 | tee -a "$MLOG"
+        echo -e "${ERROR} Installation failed for ${YELLOW}hyprlock $tag${RESET}" 2>&1 | tee -a "$MLOG"
     fi
     #moving the addional logs to Install-Logs directory
     mv $MLOG ../Install-Logs/ || true 
     cd ..
 else
-    echo -e "${ERROR} Download failed for ${YELLOW}hyprlock $lock_tag${RESET}" 2>&1 | tee -a "$LOG"
+    echo -e "${ERROR} Download failed for ${YELLOW}hyprlock $tag${RESET}" 2>&1 | tee -a "$LOG"
 fi
 
 printf "\n%.0s" {1..2}

install-scripts/hyprpolkitagent.sh

@@ -0,0 +1,72 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# Hypr Ecosystem #
+# hyprpolkitagent #
+
+polkitagent=(
+	libpolkit-agent-1-dev
+	libpolkit-qt6-1-dev
+  qml6-module-qtquick-layouts
+  qt6-tools-dev
+  qt6-tools-dev-tools
+  qt6-charts-dev
+)
+
+#specific branch or release
+tag="v0.1.3"
+
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_hyprpolkitagent.log"
+MLOG="install-$(date +%d-%H%M%S)_hyprpolkitagent.log"
+
+# Installation of dependencies
+printf "\n%s - Installing hyprpolkitagent dependencies.... \n" "${NOTE}"
+
+for PKG1 in "${polkitagent[@]}"; do
+  re_install_package "$PKG1" 2>&1 | tee -a "$LOG"
+  if [ $? -ne 0 ]; then
+    echo -e "\e[1A\e[K${ERROR} - $PKG1 Package installation failed, Please check the installation logs"
+    exit 1
+  fi
+done
+
+# Check if hyprpolkitagent folder exists and remove it
+if [ -d "hyprpolkitagent" ]; then
+    printf "${NOTE} Removing existing hyprpolkitagent folder...\n"
+    rm -rf "hyprpolkitagent"
+fi
+
+# Clone and build 
+printf "${NOTE} Installing hyprpolkitagent...\n"
+if git clone --recursive -b $tag https://github.com/hyprwm/hyprpolkitagent.git; then
+    cd hyprpolkitagent || exit 1
+	cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr -S . -B ./build
+	cmake --build ./build --config Release --target all -j`nproc 2>/dev/null || getconf NPROCESSORS_CONF`
+    if sudo cmake --install ./build 2>&1 | tee -a "$MLOG" ; then
+        printf "${OK} hyprpolkitagent installed successfully.\n" 2>&1 | tee -a "$MLOG"
+    else
+        echo -e "${ERROR} Installation failed for hyprpolkitagent." 2>&1 | tee -a "$MLOG"
+    fi
+    #moving the addional logs to Install-Logs directory
+    mv $MLOG ../Install-Logs/ || true 
+    cd ..
+else
+    echo -e "${ERROR} Download failed for hyprpolkitagent." 2>&1 | tee -a "$LOG"
+fi
+
+printf "\n%.0s" {1..2}
+
+

install-scripts/hyprtoolkit.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# Hypr Ecosystem #
+# hyprtoolkit #
+
+#specific branch or release
+tag="v0.4.1"
+# Allow environment override
+if [ -n "${HYPRTOOLKIT_TAG:-}" ]; then tag="$HYPRTOOLKIT_TAG"; fi
+
+# Dry-run support
+DO_INSTALL=1
+if [ "$1" = "--dry-run" ] || [ "${DRY_RUN}" = "1" ] || [ "${DRY_RUN}" = "true" ]; then
+    DO_INSTALL=0
+    echo "${NOTE} DRY RUN: install step will be skipped."
+fi
+
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_hyprtoolkit.log"
+MLOG="install-$(date +%d-%H%M%S)_hyprtoolkit2.log"
+
+# Clone, build, and install using Cmake
+printf "${NOTE} Cloning hyprtoolkit...\n"
+
+# Check if hyprtoolkit folder exists and remove it
+if [ -d "hyprtoolkit" ]; then
+  printf "${NOTE} Removing existing hyprtoolkit folder...\n"
+  rm -rf "hyprtoolkit" 2>&1 | tee -a "$LOG"
+fi
+
+if git clone -b $tag "https://github.com/hyprwm/hyprtoolkit.git"; then
+  cd "hyprtoolkit" || exit 1
+  cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr/local -S . -B ./build
+  cmake --build ./build --config Release --target all -j`nproc 2>/dev/null || getconf _NPROCESSORS_CONF`
+  if [ $DO_INSTALL -eq 1 ]; then
+    if sudo cmake --install build 2>&1 | tee -a "$MLOG"; then
+      printf "${OK} hyprtoolkit installed successfully.\n" 2>&1 | tee -a "$MLOG"
+    else
+      echo -e "${ERROR} Installation failed for hyprtoolkit." 2>&1 | tee -a "$MLOG"
+    fi
+  else
+    echo "${NOTE} DRY RUN: Skipping installation of hyprtoolkit $tag."
+  fi
+  [ -f "$MLOG" ] && mv "$MLOG" ../Install-Logs/
+  cd ..
+else
+  echo -e "${ERROR} Download failed for hyprtoolkit" 2>&1 | tee -a "$LOG"
+fi
+
+printf "\n%.0s" {1..2}
+
+

install-scripts/hyprutils.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# Hypr Ecosystem #
+# hyprutils #
+
+#specific branch or release
+tag="v0.10.4"
+# Allow environment override
+if [ -n "${HYPRUTILS_TAG:-}" ]; then tag="$HYPRUTILS_TAG"; fi
+
+# Dry-run support
+DO_INSTALL=1
+if [ "$1" = "--dry-run" ] || [ "${DRY_RUN}" = "1" ] || [ "${DRY_RUN}" = "true" ]; then
+    DO_INSTALL=0
+    echo "${NOTE} DRY RUN: install step will be skipped."
+fi
+
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_hyprutils.log"
+MLOG="install-$(date +%d-%H%M%S)_hyprutils2.log"
+
+# Clone, build, and install using Cmake
+printf "${NOTE} Cloning hyprutils...\n"
+
+# Check if hyprutils folder exists and remove it
+if [ -d "hyprutils" ]; then
+  printf "${NOTE} Removing existing hyprutils folder...\n"
+  rm -rf "hyprutils" 2>&1 | tee -a "$LOG"
+fi
+
+if git clone -b $tag "https://github.com/hyprwm/hyprutils.git"; then
+  cd "hyprutils" || exit 1
+  cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr/local -S . -B ./build
+  cmake --build ./build --config Release --target all -j`nproc 2>/dev/null || getconf _NPROCESSORS_CONF`
+  if [ $DO_INSTALL -eq 1 ]; then
+    if sudo cmake --install build 2>&1 | tee -a "$MLOG"; then
+      printf "${OK} hyprutils installed successfully.\n" 2>&1 | tee -a "$MLOG"
+    else
+      echo -e "${ERROR} Installation failed for hyprutils." 2>&1 | tee -a "$MLOG"
+    fi
+  else
+    echo "${NOTE} DRY RUN: Skipping installation of hyprutils $tag."
+  fi
+  [ -f "$MLOG" ] && mv "$MLOG" ../Install-Logs/
+  cd ..
+else
+  echo -e "${ERROR} Download failed for hyprutils" 2>&1 | tee -a "$LOG"
+fi
+
+printf "\n%.0s" {1..2}
+
+

install-scripts/hyprwayland-scanner.sh

@@ -0,0 +1,82 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# Hypr Ecosystem #
+# hyprwayland-scanner #
+
+scan_depend=(
+    libpugixml-dev
+)
+
+#specific branch or release
+tag="v0.4.5"
+# Allow environment override
+if [ -n "${HYPRWAYLAND_SCANNER_TAG:-}" ]; then tag="$HYPRWAYLAND_SCANNER_TAG"; fi
+
+# Dry-run support
+DO_INSTALL=1
+if [ "$1" = "--dry-run" ] || [ "${DRY_RUN}" = "1" ] || [ "${DRY_RUN}" = "true" ]; then
+    DO_INSTALL=0
+    echo "${NOTE} DRY RUN: install step will be skipped."
+fi
+
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_hyprwayland-scanner.log"
+MLOG="install-$(date +%d-%H%M%S)_hyprwayland-scanner2.log"
+
+##
+# Installation of dependencies
+printf "\n%s - Installing hyprwayland-scanner dependencies.... \n" "${NOTE}"
+
+for PKG1 in "${scan_depend[@]}"; do
+  install_package "$PKG1" 2>&1 | tee -a "$LOG"
+  if [ $? -ne 0 ]; then
+    echo -e "\e[1A\e[K${ERROR} - $PKG1 Package installation failed, Please check the installation logs"
+    exit 1
+  fi
+done
+
+printf "${NOTE} Installing hyprwayland-scanner...\n"  
+
+# Check if hyprwayland-scanner folder exists and remove it
+if [ -d "hyprwayland-scanner" ]; then
+    printf "${NOTE} Removing existing hyprwayland-scanner folder...\n"
+    rm -rf "hyprwayland-scanner"
+fi
+
+# Clone and build hyprlang
+printf "${NOTE} Installing hyprwayland-scanner...\n"
+if git clone --recursive -b $tag https://github.com/hyprwm/hyprwayland-scanner.git; then
+    cd hyprwayland-scanner || exit 1
+	cmake -DCMAKE_INSTALL_PREFIX=/usr -B build
+	cmake --build build -j `nproc`
+    if [ $DO_INSTALL -eq 1 ]; then
+        if sudo cmake --install build 2>&1 | tee -a "$MLOG" ; then
+            printf "${OK} hyprwayland-scanner installed successfully.\n" 2>&1 | tee -a "$MLOG"
+        else
+            echo -e "${ERROR} Installation failed for hyprwayland-scanner." 2>&1 | tee -a "$MLOG"
+        fi
+    else
+        echo "${NOTE} DRY RUN: Skipping installation of hyprwayland-scanner $tag."
+    fi
+    #moving the addional logs to Install-Logs directory
+    [ -f "$MLOG" ] && mv "$MLOG" ../Install-Logs/
+    cd ..
+else
+    echo -e "${ERROR} Download failed for hyprwayland-scanner. Please check log." 2>&1 | tee -a "$LOG"
+fi
+
+printf "\n%.0s" {1..2}
+

install-scripts/nvidia.sh

@@ -14,18 +14,18 @@ nvidia_pkg=(
   nvidia-vaapi-driver
 )
 
-# for ubuntu-nvidia owners! just delete #
-# sudo ubuntu-drivers install
-
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_nvidia.log"

install-scripts/rofi-wayland.sh

@@ -8,6 +8,7 @@ rofi=(
   pandoc
   doxygen
   cppcheck
+  imagemagick
   libmpdclient-dev
   libnl-3-dev
   libasound2-dev
@@ -34,16 +35,23 @@ rofi=(
   wget
 )
 
-rofi_tag="1.7.8+wayland1"
+# variables 
+rofi_tag="1.7.9+wayland1"
+release_url="https://github.com/lbonn/rofi/releases/download/1.7.9%2Bwayland1/rofi-1.7.9+wayland1.tar.gz"
+
+
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_rofi_wayland.log"
@@ -58,16 +66,16 @@ printf "\n%s - Re-installing ${SKY_BLUE}rofi-wayland dependencies${RESET}.... \n
 
 printf "\n%.0s" {1..2}
 # Clone and build rofi - wayland
-printf "${NOTE} Installing ${SKY_BLUE}rofi-wayland${RESET}...\n"
+printf "${NOTE} Building and Installing ${SKY_BLUE}rofi-wayland${RESET} $rofi_tag ...\n"
 
-# Check if rofi folder exists
+# Check if rofi directory exists
 if [ -d "rofi-$rofi_tag" ]; then
   rm -rf "rofi-$rofi_tag"
 fi
 
 # cloning rofi-wayland
 printf "${NOTE} Downloading ${YELLOW}rofi-wayland $rofi_tag${RESET} from releases...\n"
-wget https://github.com/lbonn/rofi/releases/download/1.7.8%2Bwayland1/rofi-1.7.8+wayland1.tar.gz
+wget $release_url
 
 if [ -f "rofi-$rofi_tag.tar.gz" ]; then
   printf "${OK} ${YELLOW}rofi-wayland $rofi_tag${RESET} downloaded successfully.\n" 2>&1 | tee -a "$LOG"

install-scripts/rog.sh

@@ -7,14 +7,17 @@ asus=(
 )
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="install-$(date +%d-%H%M%S)_rog.log"

install-scripts/sddm.sh

@@ -8,9 +8,13 @@ sddm1=(
 )
 
 sddm2=(
-  qml6-module-qt5compat-graphicaleffects
+  libqt6svg6
   qt6-declarative-dev
   qt6-svg-dev
+  qt6-virtualkeyboard-plugin
+  libqt6multimedia6
+  qml6-module-qtquick-controls
+  qml6-module-qtquick-effects
 )
 
 # login managers to attempt to disable
@@ -23,14 +27,17 @@ login=(
 )
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_sddm.log"
@@ -49,28 +56,29 @@ done
 
 # Check if other login managers are installed and disable their service before enabling SDDM
 for login_manager in "${login[@]}"; do
-  if sudo apt list --installed "$login_manager" > /dev/null; then
+  if dpkg -l | grep -q "^ii  $login_manager"; then
     echo "Disabling $login_manager..."
-    sudo systemctl disable "$login_manager.service" >> "$LOG" 2>&1
+    sudo systemctl disable "$login_manager.service" >> "$LOG" 2>&1 || echo "Failed to disable $login_manager" >> "$LOG"
     echo "$login_manager disabled."
   fi
 done
 
 # Double check with systemctl
 for manager in "${login[@]}"; do
-  if systemctl is-active --quiet "$manager" > /dev/null 2>&1; then
-    echo "$manager is active, disabling it..." >> "$LOG" 2>&1
-    sudo systemctl disable "$manager" --now >> "$LOG" 2>&1
+  if systemctl is-active --quiet "$manager.service" > /dev/null 2>&1; then
+    echo "$manager.service is active, disabling it..." >> "$LOG" 2>&1
+    sudo systemctl disable "$manager.service" --now >> "$LOG" 2>&1 || echo "Failed to disable $manager.service" >> "$LOG"
+  else
+    echo "$manager.service is not active" >> "$LOG" 2>&1
   fi
 done
 
 printf "\n%.0s" {1..1}
 printf "${INFO} Activating sddm service........\n"
-sudo systemctl enable sddm
+sudo systemctl set-default graphical.target 2>&1 | tee -a "$LOG"
+sudo systemctl enable sddm.service 2>&1 | tee -a "$LOG"
 
 wayland_sessions_dir=/usr/share/wayland-sessions
 [ ! -d "$wayland_sessions_dir" ] && { printf "$CAT - $wayland_sessions_dir not found, creating...\n"; sudo mkdir -p "$wayland_sessions_dir" 2>&1 | tee -a "$LOG"; }
-sudo cp assets/hyprland.desktop "$wayland_sessions_dir/" 2>&1 | tee -a "$LOG"
 
 printf "\n%.0s" {1..2}
-    

install-scripts/sddm_theme.sh

@@ -2,18 +2,22 @@
 # 💫 https://github.com/JaKooLit 💫 #
 # SDDM themes #
 
-source_theme="https://codeberg.org/JaKooLit/sddm-sequoia"
-theme_name="sequoia_2"
+source_theme="https://github.com/JaKooLit/simple-sddm-2.git"
+theme_name="simple_sddm_2"
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_sddm_theme.log"
@@ -34,7 +38,7 @@ if [ -d "$theme_name" ]; then
 fi
 
 # Clone the repository
-if git clone --depth 1 "$source_theme" "$theme_name"; then
+if git clone --depth=1 "$source_theme" "$theme_name"; then
   if [ ! -d "$theme_name" ]; then
     echo "${ERROR} Failed to clone the repository." | tee -a "$LOG"
   fi
@@ -49,50 +53,56 @@ if git clone --depth 1 "$source_theme" "$theme_name"; then
   sudo mv "$theme_name" "/usr/share/sddm/themes/$theme_name" 2>&1 | tee -a "$LOG"
 
   # setting up SDDM theme
-  sddm_conf_dir="/etc/sddm.conf.d"
+  sddm_conf="/etc/sddm.conf"
   BACKUP_SUFFIX=".bak"
 
   echo -e "${NOTE} Setting up the login screen." | tee -a "$LOG"
 
-  if [ -d "$sddm_conf_dir" ]; then
-    echo "Backing up files in $sddm_conf_dir" | tee -a "$LOG"
-    for file in "$sddm_conf_dir"/*; do
-      if [ -f "$file" ]; then
-        if [[ "$file" == *$BACKUP_SUFFIX ]]; then
-          echo "Skipping backup file: $file" | tee -a "$LOG"
-          continue
-        fi
-        # Backup each original file
-        sudo cp "$file" "$file$BACKUP_SUFFIX" 2>&1 | tee -a "$LOG"
-        echo "Backup created for $file" | tee -a "$LOG"
-        
-        # Edit existing "Current=" 
-        if grep -q '^[[:space:]]*Current=' "$file"; then
-          sudo sed -i "s/^[[:space:]]*Current=.*/Current=$theme_name/" "$file" 2>&1 | tee -a "$LOG"
-          echo "Updated theme in $file" | tee -a "$LOG"
-        fi
-      fi
-    done
+  # Backup the sddm.conf file if it exists
+  if [ -f "$sddm_conf" ]; then
+    echo "Backing up $sddm_conf" | tee -a "$LOG"
+    sudo cp "$sddm_conf" "$sddm_conf$BACKUP_SUFFIX" 2>&1 | tee -a "$LOG"
   else
-    echo "$CAT - $sddm_conf_dir not found, creating..." | tee -a "$LOG"
-    sudo mkdir -p "$sddm_conf_dir" 2>&1 | tee -a "$LOG"
+    echo "$sddm_conf does not exist, creating a new one." | tee -a "$LOG"
+    sudo touch "$sddm_conf" 2>&1 | tee -a "$LOG"
   fi
 
-  if [ ! -f "$sddm_conf_dir/theme.conf.user" ]; then
-    echo -e "[Theme]\nCurrent = $theme_name" | sudo tee "$sddm_conf_dir/theme.conf.user" > /dev/null
+  # Check if the [Theme] section exists
+  if grep -q '^\[Theme\]' "$sddm_conf"; then
+    # Update the Current= line under [Theme]
+    sudo sed -i "/^\[Theme\]/,/^\[/{s/^\s*Current=.*/Current=$theme_name/}" "$sddm_conf" 2>&1 | tee -a "$LOG"
     
-    if [ -f "$sddm_conf_dir/theme.conf.user" ]; then
-      echo "Created and configured $sddm_conf_dir/theme.conf.user with theme $theme_name" | tee -a "$LOG"
+    # If no Current= line was found and replaced, append it after the [Theme] section
+    if ! grep -q '^\s*Current=' "$sddm_conf"; then
+      sudo sed -i "/^\[Theme\]/a Current=$theme_name" "$sddm_conf" 2>&1 | tee -a "$LOG"
+      echo "Appended Current=$theme_name under [Theme] in $sddm_conf" | tee -a "$LOG"
     else
-      echo "Failed to create $sddm_conf_dir/theme.conf.user" | tee -a "$LOG"
+      echo "Updated Current=$theme_name in $sddm_conf" | tee -a "$LOG"
     fi
   else
-    echo "$sddm_conf_dir/theme.conf.user already exists, skipping creation." | tee -a "$LOG"
+    # Append the [Theme] section at the end if it doesn't exist
+    echo -e "\n[Theme]\nCurrent=$theme_name" | sudo tee -a "$sddm_conf" > /dev/null
+    echo "Added [Theme] section with Current=$theme_name in $sddm_conf" | tee -a "$LOG"
+  fi
+
+  # Add [General] section with InputMethod=qtvirtualkeyboard if it doesn't exist
+  if ! grep -q '^\[General\]' "$sddm_conf"; then
+    echo -e "\n[General]\nInputMethod=qtvirtualkeyboard" | sudo tee -a "$sddm_conf" > /dev/null
+    echo "Added [General] section with InputMethod=qtvirtualkeyboard in $sddm_conf" | tee -a "$LOG"
+  else
+    # Update InputMethod line if section exists
+    if grep -q '^\s*InputMethod=' "$sddm_conf"; then
+      sudo sed -i '/^\[General\]/,/^\[/{s/^\s*InputMethod=.*/InputMethod=qtvirtualkeyboard/}' "$sddm_conf" 2>&1 | tee -a "$LOG"
+      echo "Updated InputMethod to qtvirtualkeyboard in $sddm_conf" | tee -a "$LOG"
+    else
+      sudo sed -i '/^\[General\]/a InputMethod=qtvirtualkeyboard' "$sddm_conf" 2>&1 | tee -a "$LOG"
+      echo "Appended InputMethod=qtvirtualkeyboard under [General] in $sddm_conf" | tee -a "$LOG"
+    fi
   fi
 
   # Replace current background from assets
-  sudo cp -r assets/sddm.png "/usr/share/sddm/themes/$theme_name/backgrounds/default" 2>&1 | tee -a "$LOG"
-  sudo sed -i 's|^wallpaper=".*"|wallpaper="backgrounds/default"|' "/usr/share/sddm/themes/$theme_name/theme.conf" 2>&1 | tee -a "$LOG"
+  sudo cp -r assets/sddm.png "/usr/share/sddm/themes/$theme_name/Backgrounds/default" 2>&1 | tee -a "$LOG"
+  sudo sed -i 's|^wallpaper=".*"|wallpaper="Backgrounds/default"|' "/usr/share/sddm/themes/$theme_name/theme.conf" 2>&1 | tee -a "$LOG"
   
   printf "\n%.0s" {1..1}
   printf "${NOTE} copying ${YELLOW}JetBrains Mono Nerd Font${RESET} to ${YELLOW}/usr/local/share/fonts${RESET} .......\n"
@@ -112,12 +122,11 @@ if git clone --depth 1 "$source_theme" "$theme_name"; then
 
   printf "\n%.0s" {1..1}
 
-  echo "${OK} - ${MAGENTA}Additional SDDM Theme${RESET} successfully installed." | tee -a "$LOG"
+  echo "${OK} - ${MAGENTA}Additional ${YELLOW}$theme_name SDDM Theme${RESET} successfully installed." | tee -a "$LOG"
 
 else
 
   echo "${ERROR} - Failed to clone the sddm theme repository. Please check your internet connection." | tee -a "$LOG" >&2
 fi
 
-
 printf "\n%.0s" {1..2}

install-scripts/swww.sh

@@ -2,34 +2,39 @@
 # 💫 https://github.com/JaKooLit 💫 #
 # SWWW - Wallpaper Utility #
 
+# specific branch or release
+swww_tag="v0.11.2"
+
 # Check if 'swww' is installed
 if command -v swww &>/dev/null; then
     SWWW_VERSION=$(swww -V | awk '{print $NF}')
-    if [[ "$SWWW_VERSION" == "0.9.5" ]]; then
-        echo -e "${OK} ${MAGENTA}swww v0.9.5${RESET} is already installed. Skipping installation."
+    if [[ "$SWWW_VERSION" == "$swww_tag" ]]; then
+        echo -e "${OK} ${MAGENTA}swww ${swww_tag}${RESET} is already installed. Skipping installation."
         exit 0
     fi
 else
     echo -e "${NOTE} ${MAGENTA}swww${RESET} is not installed. Proceeding with installation."
 fi
 
-
 swww=(
     liblz4-dev
 )
 
-# specific branch or release
-swww_tag="v0.9.5"
-
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || {
+    echo "${ERROR} Failed to change directory to $PARENT_DIR"
+    exit 1
+}
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+    echo "Failed to source Global_functions.sh"
+    exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_swww.log"
@@ -44,7 +49,7 @@ done
 
 printf "\n%.0s" {1..2}
 
-# Check if swww folder exists
+# Check if swww directory exists
 if [ -d "swww" ]; then
     cd swww || exit 1
     git pull origin main 2>&1 | tee -a "$MLOG"

install-scripts/thunar.sh

@@ -12,15 +12,17 @@ thunar=(
 )
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_thunar.log"

install-scripts/thunar_default.sh

@@ -4,14 +4,17 @@
 
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_thunar-default.log"

install-scripts/wallust.sh

@@ -2,15 +2,21 @@
 # 💫 https://github.com/JaKooLit 💫 #
 # wallust - pywal colors replacement #
 
-# Determine the directory where the script is located
+wallust=(
+  wallust
+)
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-# Source external functions, adjust path as necessary
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_wallust.log"
@@ -34,16 +40,24 @@ fi
 printf "\n%.0s" {1..2} 
 
 # Install Wallust using Cargo
-echo "${INFO} Installing ${SKY_BLUE}Wallust using Cargo${RESET} ..." | tee -a "$LOG"
-if cargo install wallust 2>&1 | tee -a "$LOG" ; then
+for WALL in "${wallust[@]}"; do
+    cargo_install "$WALL" "$LOG"
+    if [ $? -eq 0 ]; then  
         echo "${OK} ${MAGENTA}Wallust${RESET} installed successfully." | tee -a "$LOG"
-
+    else
+        echo "${ERROR} Installation of ${MAGENTA}$WALL${RESET} failed. Check the log file $LOG for details." | tee -a "$LOG"
+        exit 1
+    fi
+done
+printf "\n%.0s" {1..1} 
 # Move the newly compiled binary to /usr/local/bin
 echo "Moving Wallust binary to /usr/local/bin..." | tee -a "$LOG"
-    sudo mv "$HOME/.cargo/bin/wallust" /usr/local/bin 2>&1 | tee -a "$LOG"
+if sudo mv "$HOME/.cargo/bin/wallust" /usr/local/bin 2>&1 | tee -a "$LOG"; then
+    echo "${OK} Wallust binary moved successfully to /usr/local/bin." | tee -a "$LOG"
 else
-    echo "${ERROR} Wallust installation failed. Check the log file $LOG for details." | tee -a "$LOG"
+    echo "${ERROR} Failed to move Wallust binary. Check the log file $LOG for details." | tee -a "$LOG"
     exit 1
 fi
 
+
 printf "\n%.0s" {1..2}

install-scripts/wayland-protocols-src.sh

@@ -0,0 +1,83 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# Build and install wayland-protocols from source
+# Provides a newer wayland-protocols.pc for pkg-config when distro version is too old
+
+#specific tag or release (e.g., 1.45, 1.46)
+tag="1.45"
+# Allow environment override
+if [ -n "${WAYLAND_PROTOCOLS_TAG:-}" ]; then tag="$WAYLAND_PROTOCOLS_TAG"; fi
+
+# Dry-run support
+DO_INSTALL=1
+if [ "$1" = "--dry-run" ] || [ "${DRY_RUN}" = "1" ] || [ "${DRY_RUN}" = "true" ]; then
+    DO_INSTALL=0
+    echo "${NOTE} DRY RUN: install step will be skipped."
+fi
+
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_wayland-protocols.log"
+MLOG="install-$(date +%d-%H%M%S)_wayland-protocols2.log"
+
+printf "\n%s - Installing ${YELLOW}wayland-protocols (from source)${RESET} .... \n" "${INFO}"
+
+# Clean previous clone
+if [ -d "wayland-protocols" ]; then
+    rm -rf "wayland-protocols"
+fi
+
+# Clone and build (meson)
+# Upstream: https://gitlab.freedesktop.org/wayland/wayland-protocols.git
+printf "${INFO} Installing ${YELLOW}wayland-protocols $tag${RESET} ...\n"
+repo_url="https://gitlab.freedesktop.org/wayland/wayland-protocols.git"
+if git clone --depth=1 --filter=blob:none "$repo_url" wayland-protocols; then
+    cd wayland-protocols || exit 1
+    # Fetch tags and attempt to checkout the requested tag, trying both raw and v-prefixed
+    git fetch --tags --depth=1 >/dev/null 2>&1 || true
+    checked_out=0
+    for candidate in "$tag" "v$tag"; do
+        if git rev-parse -q --verify "refs/tags/$candidate" >/dev/null; then
+            git checkout -q "refs/tags/$candidate"
+            checked_out=1
+            break
+        fi
+    done
+    if [ "$checked_out" -ne 1 ]; then
+        echo "${ERROR} Tag $tag not found in $repo_url" | tee -a "$LOG"
+        echo "${NOTE} Available tags (truncated):" | tee -a "$LOG"
+        git tag --list | tail -n 20 | tee -a "$LOG" || true
+        exit 1
+    fi
+    # Install to /usr/local so pkg-config can prefer it over distro /usr
+    meson setup build --prefix=/usr/local
+    meson compile -C build -j"$(nproc 2>/dev/null || getconf _NPROCESSORS_CONF)"
+    if [ $DO_INSTALL -eq 1 ]; then
+        if sudo meson install -C build 2>&1 | tee -a "$MLOG" ; then
+            printf "${OK} ${MAGENTA}wayland-protocols $tag${RESET} installed successfully.\n" 2>&1 | tee -a "$MLOG"
+        else
+            echo -e "${ERROR} Installation failed for ${YELLOW}wayland-protocols $tag${RESET}" 2>&1 | tee -a "$MLOG"
+        fi
+    else
+        echo "${NOTE} DRY RUN: Skipping installation of wayland-protocols $tag."
+    fi
+    # Move additional logs to Install-Logs directory if they exist
+    [ -f "$MLOG" ] && mv "$MLOG" ../Install-Logs/ || true
+    cd ..
+else
+    echo -e "${ERROR} Download failed for ${YELLOW}wayland-protocols $tag${RESET}" 2>&1 | tee -a "$LOG"
+fi
+
+printf "\n%.0s" {1..2}

install-scripts/xdph.sh

@@ -3,25 +3,69 @@
 # XDG-Desktop-Portals for hyprland #
 
 xdg=(
+  libdrm-dev
+  libpipewire-0.3-dev
+  libspa-0.2-dev
+  libsdbus-c++-dev
+  libwayland-client0
+  wayland-protocols
   xdg-desktop-portal-gtk
-    xdg-desktop-portal-hyprland
 )
 
+#specific branch or release
+tag="v1.3.10"
+
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
-PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_xdph.log"
 
 # Check if the file exists and remove it
 [[ -f "/usr/lib/xdg-desktop-portal-hyprland" ]] && sudo rm "/usr/lib/xdg-desktop-portal-hyprland"
 
 # XDG-DESKTOP-PORTAL-HYPRLAND
-printf "${NOTE} Installing ${SKY_BLUE}xdg-desktop-portal-hyprland${RESET}\n\n" 
-for xdgs in "${xdg[@]}"; do
-  install_package "$xdgs" "$LOG"
+printf "${NOTE} Installing ${SKY_BLUE}xdg-desktop-portal-hyprland dependencies${RESET}\n\n" 
+
+for PKG1 in "${xdg[@]}"; do
+  re_install_package "$PKG1" 2>&1 | tee -a "$LOG"
+  if [ $? -ne 0 ]; then
+    echo -e "\e[1A\e[K${ERROR} - $PKG1 Package installation failed, Please check the installation logs"
+    exit 1
+  fi
 done
 
+# Clone, build, and install XDPH
+printf "${NOTE} Cloning and Installing ${YELLOW}XDG Desktop Portal Hyprland $tag${RESET} ...\n"
+
+# Check if xdg-desktop-portal-hyprland folder exists and remove it
+if [ -d "xdg-desktop-portal-hyprland" ]; then
+  printf "${NOTE} Removing existing xdg-desktop-portal-hyprland folder...\n"
+  rm -rf "xdg-desktop-portal-hyprland" 2>&1 | tee -a "$LOG"
+fi
+
+if git clone --recursive -b $tag "https://github.com/hyprwm/xdg-desktop-portal-hyprland.git"; then
+  cd "xdg-desktop-portal-hyprland" || exit 1
+  cmake -DCMAKE_INSTALL_LIBEXECDIR=/usr/lib -DCMAKE_INSTALL_PREFIX=/usr -B build
+  cmake --build build
+  if sudo cmake --install build 2>&1 | tee -a "$MLOG"; then
+    printf "${OK} ${MAGENTA}xdph $tag${RESET}  installed successfully.\n" 2>&1 | tee -a "$MLOG"
+  else
+    echo -e "${ERROR} Installation failed for ${YELLOW}xdph $tag${RESET}" 2>&1 | tee -a "$MLOG"
+  fi
+  mv $MLOG ../Install-Logs/ || true   
+  cd ..
+else
+  echo -e "${ERROR} Download failed for ${YELLOW}xdph $tag${RESET}" 2>&1 | tee -a "$LOG"
+fi
+
 printf "\n%.0s" {1..2}

install-scripts/xkbcommon.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# Hypr Ecosystem #
+# xkbcommon #
+
+xkbcommon=(
+bison
+libzip-dev
+librsvg2-dev
+)
+
+#specific branch or release
+tag="xkbcommon-1.13.1"
+
+## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Change the working directory to the parent directory of the script
+PARENT_DIR="$SCRIPT_DIR/.."
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
+
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/install-$(date +%d-%H%M%S)_xkbcommon.log"
+MLOG="install-$(date +%d-%H%M%S)_xkbcommon.log"
+
+# Installation of dependencies
+printf "\n%s - Installing xkbcommon dependencies.... \n" "${NOTE}"
+
+for PKG1 in "${xkbcommon[@]}"; do
+  install_package "$PKG1" 2>&1 | tee -a "$LOG"
+  if [ $? -ne 0 ]; then
+    echo -e "\e[1A\e[K${ERROR} - $PKG1 Package installation failed, Please check the installation logs"
+    exit 1
+  fi
+done
+
+# Check if xkbcommon folder exists and remove it
+if [ -d "libxkbcommon" ]; then
+    printf "${NOTE} Removing existing libxkbcommon folder...\n"
+    rm -rf "libxkbcommon"
+fi
+
+# Clone and build 
+printf "${NOTE} Installing xkbcommon...\n"
+if git clone --recursive -b $tag https://github.com/xkbcommon/libxkbcommon.git; then
+    cd libxkbcommon || exit 1
+    meson setup build --libdir=/usr/local/lib
+    meson compile -C build
+    if sudo meson install -C build 2>&1 | tee -a "$MLOG" ; then
+        printf "${OK} xkbcommon installed successfully.\n" 2>&1 | tee -a "$MLOG"
+    else
+        echo -e "${ERROR} Installation failed for xkbcommon." 2>&1 | tee -a "$MLOG"
+    fi
+    #moving the addional logs to Install-Logs directory
+    mv $MLOG ../Install-Logs/ || true 
+    cd ..
+else
+    echo -e "${ERROR} Download failed for xkbcommon." 2>&1 | tee -a "$LOG"
+fi
+
+printf "\n%.0s" {1..2}
+
+

install-scripts/zsh.sh

@@ -3,21 +3,24 @@
 # Zsh and Oh my Zsh + Optional Pokemon ColorScripts#
 
 zsh=(
-    eza
-    mercurial
+  lsd
   zsh
+  mercurial
   zplug
 )
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_zsh.log"
@@ -73,11 +76,13 @@ if command -v zsh >/dev/null; then
   cp -r 'assets/.zprofile' ~/
 
   # Check if the current shell is zsh
-  if [[ "$SHELL" != *"zsh"* ]]; then
+  current_shell=$(basename "$SHELL")
+  if [ "$current_shell" != "zsh" ]; then
     printf "${NOTE} Changing default shell to ${MAGENTA}zsh${RESET}..."
     printf "\n%.0s" {1..2}
 
-    while ! chsh -s $(which zsh); do
+    # Loop to ensure the chsh command succeeds
+    while ! chsh -s "$(command -v zsh)"; do
       echo "${ERROR} Authentication failed. Please enter the correct password." 2>&1 | tee -a "$LOG"
       sleep 1
     done

install-scripts/zsh_pokemon.sh

@@ -3,25 +3,27 @@
 # pokemon-color-scripts#
 
 ## WARNING: DO NOT EDIT BEYOND THIS LINE IF YOU DON'T KNOW WHAT YOU ARE DOING! ##
-# Determine the directory where the script is located
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 
 # Change the working directory to the parent directory of the script
 PARENT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR" || exit 1
+cd "$PARENT_DIR" || { echo "${ERROR} Failed to change directory to $PARENT_DIR"; exit 1; }
 
-source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"
+# Source the global functions script
+if ! source "$(dirname "$(readlink -f "$0")")/Global_functions.sh"; then
+  echo "Failed to source Global_functions.sh"
+  exit 1
+fi
 
 # Set the name of the log file to include the current date and time
 LOG="Install-Logs/install-$(date +%d-%H%M%S)_zsh_pokemon.log"
 
-
 printf "${INFO} Installing ${SKY_BLUE}Pokemon color scripts${RESET} ..."
 
 if [ -d "pokemon-colorscripts" ]; then
     cd pokemon-colorscripts && git pull && sudo ./install.sh && cd ..
     else
-    git clone --depth 1 https://gitlab.com/phoneybadger/pokemon-colorscripts.git &&
+    git clone --depth=1 https://gitlab.com/phoneybadger/pokemon-colorscripts.git &&
     cd pokemon-colorscripts && sudo ./install.sh && cd ..
 fi
 
@@ -33,5 +35,4 @@ else
     echo "$HOME/.zshrc not found. Cant enable ${YELLOW}Pokemon color scripts${RESET}" >> "$LOG" 2>&1
 fi
   
-
 printf "\n%.0s" {1..2}

install.sh

@@ -19,10 +19,69 @@ BLUE="$(tput setaf 4)"
 SKY_BLUE="$(tput setaf 6)"
 RESET="$(tput sgr0)"
 
+# Function to print colorful text
+print_color() {
+    printf "%b%s%b\n" "$1" "$2" "$RESET"
+}
+
+# Warning: End of Life Support
+printf "\n%.0s" {1..2}
+print_color $YELLOW "
+        █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
+              KooL's Debian - Hyprland October 2025 Update
+              
+            Most Hyprland packages are built from Source
+
+                                NOTICE
+        █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
+
+    All Hyprland and associated packages set to install using this script are downloaded and built from source (github)
+    
+    However, do note that it is downloaded from each individual releases. You can set versions by editing the scripts
+    located install-scripts directory.
+
+    These packages are NOT updated automatically. 
+
+    See the HOWTO documentation on how to get next release of Hyprland installed 
+    
+    BE WARNED!!!!!  Installation will take longer!!
+
+
+        █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
+              
+                                NOTE:
+                    Hyprland and Dependencies versions              
+
+        █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
+
+    
+    Thank you!
+"
+printf "\n%.0s" {1..2}
+
+# Prompt user to continue or exit
+read -rp "Do you want to continue with the installation? [y/N]: " confirm
+case "$confirm" in
+[yY][eE][sS] | [yY])
+    echo -e "${OK} Continuing with installation..."
+    ;;
+*)
+    echo -e "${NOTE} You chose not to continue. Exiting..."
+    exit 1
+    ;;
+esac
+
+# Create Directory for Install Logs
+if [ ! -d Install-Logs ]; then
+    mkdir Install-Logs
+fi
+
+# Set the name of the log file to include the current date and time
+LOG="Install-Logs/01-Hyprland-Install-Scripts-$(date +%d-%H%M%S).log"
 
 # Check if running as root. If root, script will exit
 if [[ $EUID -eq 0 ]]; then
-    echo "${ERROR}  This script should ${WARNING}NOT${RESET} be executed as root!! Exiting......."
+    echo "${ERROR}  This script should ${WARNING}NOT${RESET} be executed as root!! Exiting......." | tee -a "$LOG"
     printf "\n%.0s" {1..2}
     exit 1
 fi
@@ -38,126 +97,56 @@ is_ubuntu() {
 
 # Check if the system is Ubuntu
 if is_ubuntu; then
-    echo "${WARN}This script is ${WARNING}NOT intended for Ubuntu / Ubuntu Based${RESET}. Refer to ${YELLOW}README for the correct link for Ubuntu-Hyprland project${RESET} "
+    echo "${WARN}This script is ${WARNING}NOT intended for Ubuntu / Ubuntu Based${RESET}. Refer to ${YELLOW}README for the correct link for Ubuntu-Hyprland project${RESET}" | tee -a "$LOG"
     exit 1
 fi
 
-# Check if --preset argument is provided
-if [[ "$1" == "--preset" ]]; then
-    
-    # nvidia
-    if [[ "$2" == "--nvidia" ]]; then
-        sed -i 's/^nvidia=".*"/nvidia="Y"/' preset.sh
-    fi
-    
-    source ./preset.sh
+# install whiptails if detected not installed. Necessary for this version
+if ! command -v whiptail >/dev/null; then
+    echo "${NOTE} - whiptail is not installed. Installing..." | tee -a "$LOG"
+    sudo apt install -y whiptail
+    printf "\n%.0s" {1..1}
 fi
 
 printf "\n%.0s" {1..2}
 echo -e "\e[35m
 	╦╔═┌─┐┌─┐╦    ╦ ╦┬ ┬┌─┐┬─┐┬  ┌─┐┌┐┌┌┬┐
-	╠╩╗│ ││ │║    ╠═╣└┬┘├─┘├┬┘│  ├─┤│││ ││ 2025
-	╩ ╩└─┘└─┘╩═╝  ╩ ╩ ┴ ┴  ┴└─┴─┘┴ ┴┘└┘─┴┘ 
+	╠╩╗│ ││ │║    ╠═╣└┬┘├─┘├┬┘│  ├─┤│││ ││ July 2025
+	╩ ╩└─┘└─┘╩═╝  ╩ ╩ ┴ ┴  ┴└─┴─┘┴ ┴┘└┘─┴┘ Debian Trixie / SiD
 \e[0m"
 printf "\n%.0s" {1..1}
 
-# Welcome message
-echo "${SKY_BLUE}Welcome to JaKooLit's Debian Trixie/SID Hyprland (2025) Install Script!${RESET}"
-echo
-echo "${WARNING}ATTENTION: Run a full system update and Reboot first!! (Highly Recommended) ${RESET}"
-echo
-echo "${YELLOW}NOTE: You will be required to answer some questions during the installation! ${RESET}"
-echo
-echo "${YELLOW}NOTE: If you are installing on a VM, ensure to enable 3D acceleration else Hyprland wont start! ${RESET}"
-echo
+# 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\
+ATTENTION: Run a full system update and Reboot first !!! (Highly Recommended)\n\n\
+NOTE: If you are installing on a VM, ensure to enable 3D acceleration otherwise Hyprland may NOT start!" \
+    15 80
 
-# Prompt user to proceed
-read -p "$(tput setaf 6)Would you like to proceed? (y/n): $(tput sgr0)" proceed
-
-if [ "$proceed" != "y" ]; then
-    printf "\n%.0s" {1..2}
-    echo "${INFO} Installation aborted. ${SKY_BLUE}No changes in your system.${RESET} ${YELLOW}Goodbye!${RESET}"
-    printf "\n%.0s" {1..2}
+# Ask if the user wants to proceed
+if ! whiptail --title "Proceed with Installation?" \
+    --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"
     exit 1
 fi
 
-printf "\n%.0s" {1..1}
-
-echo "${NOTE} Ensure to uncomment the ${YELLOW}deb-src's${RESET} in ${YELLOW}/etc/apt/sources.list${RESET}"
-read -p "${CAT} ${YELLOW}Very Important else script will likely fail${RESET}. OK to proceed? (y/n): ${RESET}" proceed2
-
-if [ "$proceed2" != "y" ]; then
-    printf "\n%.0s" {1..2}
-    echo "Installation aborted! Kindly edit your ${YELLOW}sources.list${RESET} first. Refer to readme."
-    printf "\n%.0s" {1..2}
-    exit 1
-fi
-
-# Create Directory for Install Logs
-if [ ! -d Install-Logs ]; then
-    mkdir Install-Logs
-fi
+echo "👌 ${OK} 🇵🇭 ${MAGENTA}KooL..${RESET} ${SKY_BLUE}lets continue with the installation...${RESET}" | tee -a "$LOG"
 
+sleep 1
 printf "\n%.0s" {1..1}
 
 # install pciutils if detected not installed. Necessary for detecting GPU
 if ! dpkg -l | grep -w pciutils >/dev/null; then
-    echo "pciutils is not installed. Installing..."
+    echo "pciutils is not installed. Installing..." | tee -a "$LOG"
     sudo apt install -y pciutils
     printf "\n%.0s" {1..1}
 fi
 
-# Function to colorize prompts
-colorize_prompt() {
-    local color="$1"
-    local message="$2"
-    echo -n "${color}${message}$(tput sgr0)"
-}
-
-# Set the name of the log file to include the current date and time
-LOG="install-$(date +%d-%H%M%S).log"
-
-# Define the directory where your scripts are located
+# Path to the install-scripts directory
 script_directory=install-scripts
 
-# Function to ask a yes/no question and set the response in a variable
-ask_yes_no() {
-  if [[ ! -z "${!2}" ]]; then
-    echo "$(colorize_prompt "$CAT"  "$1 (Preset): ${!2}")" 
-    if [[ "${!2}" = [Yy] ]]; then
-      return 0
-    else
-      return 1
-    fi
-  else
-    eval "$2=''" 
-  fi
-    while true; do
-        read -p "$(colorize_prompt "$CAT"  "$1 (y/n): ")" choice
-        case "$choice" in
-            [Yy]* ) eval "$2='Y'"; return 0;;
-            [Nn]* ) eval "$2='N'"; return 1;;
-            * ) echo "Please answer with y or n.";;
-        esac
-    done
-}
-
-# Function to ask a custom question with specific options and set the response in a variable
-ask_custom_option() {
-    local prompt="$1"
-    local valid_options="$2"
-    local response_var="$3"
-
-    while true; do
-        read -p "$(colorize_prompt "$CAT"  "$prompt ($valid_options): ")" choice
-        if [[ " $valid_options " == *" $choice "* ]]; then
-            eval "$response_var='$choice'"
-            return 0
-        else
-            echo "Please choose one of the provided options: $valid_options"
-        fi
-    done
-}
 # Function to execute a script if it exists and make it executable
 execute_script() {
     local script="$1"
@@ -165,174 +154,365 @@ execute_script() {
     if [ -f "$script_path" ]; then
         chmod +x "$script_path"
         if [ -x "$script_path" ]; then
-            env USE_PRESET=$use_preset  "$script_path"
+            env "$script_path"
         else
-            echo "Failed to make script '$script' executable."
+            echo "Failed to make script '$script' executable." | tee -a "$LOG"
         fi
     else
-        echo "Script '$script' not found in '$script_directory'."
+        echo "Script '$script' not found in '$script_directory'." | tee -a "$LOG"
     fi
 }
 
-# Collect user responses to all questions
-# Check if nvidia is present
-if lspci | grep -i "nvidia" &> /dev/null; then
-    printf "\n"
-    printf "${INFO} ${YELLOW}NVIDIA GPU${RESET} detected in your system \n"
-    ask_yes_no "-Do you want script to configure ${YELLOW}NVIDIA${RESET} for you?" nvidia
+# Load centralized Hyprland stack tags if present and export for child scripts
+if [ -f "./hypr-tags.env" ]; then
+    # shellcheck disable=SC1091
+    source "./hypr-tags.env"
+    # If core tags are set to auto/latest, refresh to resolve concrete versions
+    if [ "${HYPRUTILS_TAG:-}" = "auto" ] || [ "${HYPRUTILS_TAG:-}" = "latest" ] || [ -z "${HYPRUTILS_TAG:-}" ] ||
+        [ "${HYPRLANG_TAG:-}" = "auto" ] || [ "${HYPRLANG_TAG:-}" = "latest" ] || [ -z "${HYPRLANG_TAG:-}" ]; then
+        if [ -f ./refresh-hypr-tags.sh ]; then
+            chmod +x ./refresh-hypr-tags.sh || true
+            ./refresh-hypr-tags.sh
+            # reload after refresh
+            # shellcheck disable=SC1091
+            source "./hypr-tags.env"
+        fi
+    fi
+    export HYPRLAND_TAG AQUAMARINE_TAG HYPRUTILS_TAG HYPRLANG_TAG HYPRGRAPHICS_TAG HYPRWAYLAND_SCANNER_TAG HYPRLAND_PROTOCOLS_TAG HYPRLAND_QT_SUPPORT_TAG HYPRLAND_QTUTILS_TAG WAYLAND_PROTOCOLS_TAG
 fi
 
-printf "\n"
-ask_yes_no "-Install ${YELLOW}GTK themes${RESET} (required for Dark/Light function)?" gtk_themes
+#################
+## Default values for the options (will be overwritten by preset file if available)
+gtk_themes="OFF"
+bluetooth="OFF"
+thunar="OFF"
+ags="OFF"
+sddm="OFF"
+sddm_theme="OFF"
+xdph="OFF"
+zsh="OFF"
+pokemon="OFF"
+rog="OFF"
+dots="OFF"
+input_group="OFF"
+nvidia="OFF"
 
-printf "\n"
-ask_yes_no "-Do you want to configure ${YELLOW}Bluetooth${RESET}?" bluetooth
+# Function to load preset file
+load_preset() {
+    if [ -f "$1" ]; then
+        echo "✅ Loading preset: $1"
+        source "$1"
+    else
+        echo "⚠️ Preset file not found: $1. Using default values."
+    fi
+}
 
-printf "\n"
-ask_yes_no "-Do you want to install ${YELLOW}Thunar file manager${RESET}?" thunar
-
-if [[ "$thunar" == "Y" ]]; then
-    ask_yes_no "-Set ${YELLOW}Thunar${RESET} as the default file manager?" thunar_choice
+# Check if --preset argument is passed
+if [[ "$1" == "--preset" && -n "$2" ]]; then
+    load_preset "$2"
 fi
 
-# Input group
-printf "\n"
-if ! groups "$(whoami)" | grep -q '\binput\b'; then
-    printf "${NOTE} adding to ${YELLOW}input${RESET} group might be necessary for ${YELLOW}waybar keyboard-state functionality${RESET} \n"
-    ask_yes_no "-Would you like to be added to the ${YELLOW}input${RESET} group?" input_group
-fi
-
-printf "\n"
-printf "${NOTE} ${YELLOW}AGS Desktop Overview DEMO link${RESET} on README\n"
-ask_yes_no "-Install ${YELLOW}AGS (aylur's GTK shell) v1${RESET} for Desktop-Like Overview?" ags
-
-printf "\n"
-ask_yes_no "-Install & configure ${YELLOW}SDDM${RESET} as login manager?" sddm
-# check if any known login managers are active when users choose to install sddm
-if [ "$sddm" == "y" ] || [ "$sddm" == "Y" ]; then
-    # List of services to check
+# List of services to check for active login managers
 services=("gdm.service" "gdm3.service" "lightdm.service" "lxdm.service")
 
-    # Loop through each service
+# Function to check if any login services are active
+check_services_running() {
+    active_services=() # Array to store active services
     for svc in "${services[@]}"; do
         if systemctl is-active --quiet "$svc"; then
-            echo "${ERROR} ${MAGENTA}$svc${RESET} is active.  stop or disable it first or ${YELLOW}DO NOT choose SDDM${RESET} to install."
-            echo "${NOTE} If you have GDM, no need to install SDDM. GDM will work fine as Login Manager for Hyprland."
-            printf "\n%.0s" {1..2}            
-            exit 1  
+            active_services+=("$svc")
         fi
     done
+
+    if [ ${#active_services[@]} -gt 0 ]; then
+        return 0
+    else
+        return 1
     fi
-if [[ "$sddm" == "Y" ]]; then
-    ask_yes_no "-Download and Install ${YELLOW}SDDM Theme?${RESET} " sddm_theme
+}
+
+if check_services_running; then
+    active_list=$(printf "%s\n" "${active_services[@]}")
+
+    # Display the active login manager(s) in the whiptail message box
+    whiptail --title "Active non-SDDM login manager(s) detected" \
+        --msgbox "The following login manager(s) are active:\n\n$active_list\n\nIf you want to install SDDM and SDDM theme, stop and disable first the active services above, and reboot before running this script\nRefer to README on switching to SDDM if you really want SDDM\n\nNOTE: Your option to install SDDM and SDDM theme has now been removed\n\n- Ja " 28 80
 fi
 
-printf "\n"
-ask_yes_no "-Install ${YELLOW}XDG-DESKTOP-PORTAL-HYPRLAND?${RESET} (For proper Screen Share, e.g., OBS)" xdph
-
-printf "\n"
-ask_yes_no "-Install ${YELLOW}zsh${RESET} with ${YELLOW}oh-my-zsh?${RESET}" zsh
-
-if [[ "$zsh" == "Y" ]]; then
-    ask_yes_no "-Add ${YELLOW}Pokemon color scripts?${RESET} in your terminal?" pokemon_choice
+# Check if NVIDIA GPU is detected
+nvidia_detected=false
+if lspci | grep -i "nvidia" &>/dev/null; then
+    nvidia_detected=true
+    whiptail --title "NVIDIA GPU Detected" --msgbox "NVIDIA GPU detected in your system.\n\nNOTE: The script will install nvidia-dkms, nvidia-utils, and nvidia-settings if you choose to configure." 12 60
 fi
 
-printf "\n"
-ask_yes_no "-Installing on ${YELLOW}Asus ROG laptops?${RESET}" rog
+# Initialize the options array for whiptail checklist
+options_command=(
+    whiptail --title "Select Options" --checklist "Choose options to install or configure\nNOTE: 'SPACEBAR' to select & 'TAB' key to change selection" 28 85 20
+)
 
-printf "\n"
-ask_yes_no "-Do you want to add pre-configured ${YELLOW}KooL's Hyprland dotfiles?${RESET}" dots
+# Add NVIDIA options if detected
+if [ "$nvidia_detected" == "true" ]; then
+    options_command+=(
+        "nvidia" "Do you want script to configure NVIDIA GPU?" "OFF"
+    )
+fi
 
-printf "\n"
+# Check if user is already in the 'input' group
+input_group_detected=false
+if ! groups "$(whoami)" | grep -q '\binput\b'; then
+    input_group_detected=true
+    whiptail --title "Input Group" --msgbox "You are not currently in the input group.\n\nAdding you to the input group might be necessary for the Waybar keyboard-state functionality." 12 60
+fi
 
-# Ensuring all in the scripts folder are made executable
-chmod +x install-scripts/*
-sleep 1
+# Add 'input_group' option if user is not in input group
+if [ "$input_group_detected" == "true" ]; then
+    options_command+=(
+        "input_group" "Add your USER to input group for some waybar functionality?" "OFF"
+    )
+fi
 
+# Conditionally add SDDM and SDDM theme options if no active login manager is found
+if ! check_services_running; then
+    options_command+=(
+        "sddm" "Install & configure SDDM login manager?" "OFF"
+        "sddm_theme" "Download & Install Additional SDDM theme?" "OFF"
+    )
+fi
+
+# Add the remaining static options
+options_command+=(
+    "gtk_themes" "Install GTK themes (required for Dark/Light function)" "OFF"
+    "bluetooth" "Do you want script to configure Bluetooth?" "OFF"
+    "thunar" "Do you want Thunar file manager to be installed?" "OFF"
+    "ags" "Install AGS v1 for Desktop-Like Overview" "OFF"
+    "xdph" "Install XDG-DESKTOP-PORTAL-HYPRLAND (for screen share)?" "OFF"
+    "zsh" "Install zsh shell with Oh-My-Zsh?" "OFF"
+    "pokemon" "Add Pokemon color scripts to your terminal?" "OFF"
+    "rog" "Are you installing on Asus ROG laptops?" "OFF"
+    "dots" "Download and install pre-configured KooL Hyprland dotfiles?" "OFF"
+)
+
+# Capture the selected options before the while loop starts
+while true; do
+    selected_options=$("${options_command[@]}" 3>&1 1>&2 2>&3)
+
+    # Check if the user pressed Cancel (exit status 1)
+    if [ $? -ne 0 ]; then
+        echo -e "\n"
+        echo "❌ ${INFO} You 🫵 cancelled the selection. ${YELLOW}Goodbye!${RESET}" | tee -a "$LOG"
+        exit 0 # Exit the script if Cancel is pressed
+    fi
+
+    # If no option was selected, notify and restart the selection
+    if [ -z "$selected_options" ]; then
+        whiptail --title "Warning" --msgbox "No options were selected. Please select at least one option." 10 60
+        continue # Return to selection if no options selected
+    fi
+
+    # Strip the quotes and trim spaces if necessary (sanitize the input)
+    selected_options=$(echo "$selected_options" | tr -d '"' | tr -s ' ')
+
+    # Convert selected options into an array (preserving spaces in values)
+    IFS=' ' read -r -a options <<<"$selected_options"
+
+    # Check if the "dots" option was selected
+    dots_selected="OFF"
+    for option in "${options[@]}"; do
+        if [[ "$option" == "dots" ]]; then
+            dots_selected="ON"
+            break
+        fi
+    done
+
+    # If "dots" is not selected, show a note and ask the user to proceed or return to choices
+    if [[ "$dots_selected" == "OFF" ]]; then
+        # Show a note about not selecting the "dots" option
+        if ! whiptail --title "KooL Hyprland Dot Files" --yesno \
+            "You have not selected to install the pre-configured KooL Hyprland dotfiles.\n\nKindly NOTE that if you proceed without Dots, Hyprland will start with default vanilla Hyprland configuration and I won't be able to give you support.\n\nWould you like to continue install without KooL Hyprland Dots or return to choices/options?" \
+            --yes-button "Continue" --no-button "Return" 15 90; then
+            echo "🔙 Returning to options..." | tee -a "$LOG"
+            continue
+        else
+            # User chose to continue
+            echo "${INFO} ⚠️ Continuing WITHOUT the dotfiles installation..." | tee -a "$LOG"
+            printf "\n%.0s" {1..1}
+        fi
+    fi
+
+    # Prepare the confirmation message
+    confirm_message="You have selected the following options:\n\n"
+    for option in "${options[@]}"; do
+        confirm_message+=" - $option\n"
+    done
+    confirm_message+="\nAre you happy with these choices?"
+
+    # Confirmation prompt
+    if ! whiptail --title "Confirm Your Choices" --yesno "$(printf "%s" "$confirm_message")" 25 80; then
+        echo -e "\n"
+        echo "❌ ${SKY_BLUE}You're not 🫵 happy${RESET}. ${YELLOW}Returning to options...${RESET}" | tee -a "$LOG"
+        continue
+    fi
+
+    echo "👌 ${OK} You confirmed your choices. Proceeding with ${SKY_BLUE}KooL 🇵🇭 Hyprland Installation...${RESET}" | tee -a "$LOG"
+    break
+done
+
+printf "\n%.0s" {1..1}
+
+echo "${INFO} Running a ${SKY_BLUE}full system update...${RESET}" | tee -a "$LOG"
 sudo apt update
 
+sleep 1
 # execute pre clean up
 execute_script "02-pre-cleanup.sh"
 
-# Install hyprland packages
+echo "${INFO} Installing ${SKY_BLUE}necessary dependencies...${RESET}" | tee -a "$LOG"
+sleep 1
 execute_script "00-dependencies.sh"
-execute_script "01-hypr-pkgs.sh"
+
+echo "${INFO} Installing ${SKY_BLUE}necessary fonts...${RESET}" | tee -a "$LOG"
+sleep 1
 execute_script "fonts.sh"
-execute_script "wallust.sh"
 
-#execute_script "imagemagick.sh" #this is for compiling from source. 07 Sep 2024
-
-execute_script "swww.sh"
-execute_script "rofi-wayland.sh"
+# 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...${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
 
+sleep 1
+# Clean up the selected options (remove quotes and trim spaces)
+selected_options=$(echo "$selected_options" | tr -d '"' | tr -s ' ')
 
-if [ "$nvidia" == "Y" ]; then
-    execute_script "nvidia.sh"
-fi
+# Convert selected options into an array (splitting by spaces)
+IFS=' ' read -r -a options <<<"$selected_options"
 
-if [ "$gtk_themes" == "Y" ]; then
-    execute_script "gtk_themes.sh"
-fi
-
-if [ "$bluetooth" == "Y" ]; then
-    execute_script "bluetooth.sh"
-fi
-
-if [ "$thunar" == "Y" ]; then
-    execute_script "thunar.sh"
-fi
-if [ "$thunar_choice" == "Y" ]; then
-    execute_script "thunar_default.sh"
-fi
-
-if [ "$ags" == "Y" ]; then
-    execute_script "ags.sh"
-fi
-
-if [ "$sddm" == "Y" ]; then
+# Loop through selected options
+for option in "${options[@]}"; do
+    case "$option" in
+    sddm)
+        if check_services_running; then
+            active_list=$(printf "%s\n" "${active_services[@]}")
+            whiptail --title "Error" --msgbox "One of the following login services is running:\n$active_list\n\nPlease stop & disable it or DO not choose SDDM." 12 60
+            exec "$0"
+        else
+            echo "${INFO} Installing and configuring ${SKY_BLUE}SDDM...${RESET}" | tee -a "$LOG"
             execute_script "sddm.sh"
         fi
-if [ "$sddm_theme" == "Y" ]; then
-    execute_script "sddm_theme.sh"
-fi
-
-if [ "$xdph" == "Y" ]; then
-    execute_script "xdph.sh"
-fi
-
-
-if [ "$zsh" == "Y" ]; then
-    execute_script "zsh.sh"
-fi
-if [ "$pokemon_choice" == "Y" ]; then
-    execute_script "zsh_pokemon.sh"
-fi
-
-if [ "$input_group" == "Y" ]; then
+        ;;
+    nvidia)
+        echo "${INFO} Configuring ${SKY_BLUE}nvidia stuff${RESET}" | tee -a "$LOG"
+        execute_script "nvidia.sh"
+        ;;
+    gtk_themes)
+        echo "${INFO} Installing ${SKY_BLUE}GTK themes...${RESET}" | tee -a "$LOG"
+        execute_script "gtk_themes.sh"
+        ;;
+    input_group)
+        echo "${INFO} Adding user into ${SKY_BLUE}input group...${RESET}" | tee -a "$LOG"
         execute_script "InputGroup.sh"
-fi
-
-if [ "$rog" == "Y" ]; then
+        ;;
+    ags)
+        echo "${INFO} Installing ${SKY_BLUE}AGS v1 for Desktop Overview...${RESET}" | tee -a "$LOG"
+        execute_script "ags.sh"
+        ;;
+    xdph)
+        echo "${INFO} Installing ${SKY_BLUE}xdg-desktop-portal-hyprland...${RESET}" | tee -a "$LOG"
+        execute_script "xdph.sh"
+        ;;
+    bluetooth)
+        echo "${INFO} Configuring ${SKY_BLUE}Bluetooth...${RESET}" | tee -a "$LOG"
+        execute_script "bluetooth.sh"
+        ;;
+    thunar)
+        echo "${INFO} Installing ${SKY_BLUE}Thunar file manager...${RESET}" | tee -a "$LOG"
+        execute_script "thunar.sh"
+        execute_script "thunar_default.sh"
+        ;;
+    sddm_theme)
+        echo "${INFO} Downloading & Installing ${SKY_BLUE}Additional SDDM theme...${RESET}" | tee -a "$LOG"
+        execute_script "sddm_theme.sh"
+        ;;
+    zsh)
+        echo "${INFO} Installing ${SKY_BLUE}zsh with Oh-My-Zsh...${RESET}" | tee -a "$LOG"
+        execute_script "zsh.sh"
+        ;;
+    pokemon)
+        echo "${INFO} Adding ${SKY_BLUE}Pokemon color scripts to terminal...${RESET}" | tee -a "$LOG"
+        execute_script "zsh_pokemon.sh"
+        ;;
+    rog)
+        echo "${INFO} Installing ${SKY_BLUE}ROG laptop packages...${RESET}" | tee -a "$LOG"
         execute_script "rog.sh"
-fi
-
-if [ "$dots" == "Y" ]; then
+        ;;
+    dots)
+        echo "${INFO} Installing pre-configured ${SKY_BLUE}KooL Hyprland dotfiles...${RESET}" | tee -a "$LOG"
         execute_script "dotfiles-branch.sh"
-fi
+        ;;
+    *)
+        echo "Unknown option: $option" | tee -a "$LOG"
+        ;;
+    esac
+done
 
-# Clean up
-printf "\n${OK} performing some clean up.\n"
-if [ -e "JetBrainsMono.tar.xz" ]; then
-    echo "JetBrainsMono.tar.xz found. Deleting..."
-    rm JetBrainsMono.tar.xz
-    echo "JetBrainsMono.tar.xz deleted successfully."
+# Perform cleanup
+printf "\n${OK} Performing some clean up.\n"
+files_to_delete=("JetBrainsMono.tar.xz" "VictorMonoAll.zip" "FantasqueSansMono.zip")
+for file in "${files_to_delete[@]}"; do
+    if [ -e "$file" ]; then
+        echo "$file found. Deleting..." | tee -a "$LOG"
+        rm "$file"
+        echo "$file deleted successfully." | tee -a "$LOG"
     fi
+done
 
 clear
 
@@ -347,38 +527,41 @@ execute_script "03-Final-Check.sh"
 
 printf "\n%.0s" {1..1}
 
-# Check if either hyprland or hyprland-git is installed
-if dpkg -l | grep -qw hyprland; then
-    printf "\n${OK} Hyprland is installed. However, some essential packages may not be installed. Please see above!"
+# Check if either hyprland or Hyprland files exist in /usr/local/bin/
+if [ -e /usr/local/bin/hyprland ] || [ -f /usr/local/bin/Hyprland ]; then
+    printf "\n ${OK} 👌 Hyprland is installed. However, some essential packages may not be installed. Please see above!"
     printf "\n${CAT} Ignore this message if it states ${YELLOW}All essential packages${RESET} are installed as per above\n"
     sleep 2
     printf "\n%.0s" {1..2}
 
-    printf "${SKY_BLUE}Thank you${RESET} for using ${MAGENTA}KooL's Hyprland Dots${RESET}. ${YELLOW}Enjoy and Have a good day!${RESET}"
+    printf "${SKY_BLUE}Thank you${RESET} 🫰 for using 🇵🇭 ${MAGENTA}KooL's Hyprland Dots${RESET}. ${YELLOW}Enjoy and Have a good day!${RESET}"
     printf "\n%.0s" {1..2}
 
     printf "\n${NOTE} You can start Hyprland by typing ${SKY_BLUE}Hyprland${RESET} (IF SDDM is not installed) (note the capital H!).\n"
     printf "\n${NOTE} However, it is ${YELLOW}highly recommended to reboot${RESET} your system.\n\n"
 
-    read -rp "${CAT} Would you like to reboot now? (y/n): " HYP
-
+    while true; do
+        echo -n "${CAT} Would you like to reboot now? (y/n): "
+        read HYP
         HYP=$(echo "$HYP" | tr '[:upper:]' '[:lower:]')
 
         if [[ "$HYP" == "y" || "$HYP" == "yes" ]]; then
             echo "${INFO} Rebooting now..."
             systemctl reboot
+            break
         elif [[ "$HYP" == "n" || "$HYP" == "no" ]]; then
-        echo "${OK} You choose NOT to reboot"
+            echo "👌 ${OK} You chose NOT to reboot"
             printf "\n%.0s" {1..1}
             # Check if NVIDIA GPU is present
             if lspci | grep -i "nvidia" &>/dev/null; then
                 echo "${INFO} HOWEVER ${YELLOW}NVIDIA GPU${RESET} detected. Reminder that you must REBOOT your SYSTEM..."
                 printf "\n%.0s" {1..1}
             fi
+            break
         else
-        echo "${WARN} Invalid response. Please answer with 'y' or 'n'. Exiting."
-        exit 1
+            echo "${WARN} Invalid response. Please answer with 'y' or 'n'."
         fi
+    done
 else
     # Print error message if neither package is installed
     printf "\n${WARN} Hyprland is NOT installed. Please check 00_CHECK-time_installed.log and other files in the Install-Logs/ directory..."
@@ -387,4 +570,3 @@ else
 fi
 
 printf "\n%.0s" {1..2}
-

preset.sh

@@ -1,49 +1,46 @@
 # 💫 https://github.com/JaKooLit 💫 #
 
-## -- Make sure you use the right answer or install script will fail ###
-# Use only Y for Yes and N for No . If you put other letter, the script will fail
-
+# Define the options you want to preselect (either ON or OFF)
+# IMPORTANT: answer should be inside ""
 
+### Script will install nvidia-dkms nvidia-utils & nvidia-settings
 ###-Would you like script to Configure NVIDIA for you?
-nvidia="N"
+nvidia="OFF"
 
 ###-Install GTK themes (required for Dark/Light function)?
-gtk_themes="Y"
+gtk_themes="ON"
 
 ###-Do you want to configure Bluetooth?
-bluetooth="Y"
+bluetooth="ON"
 
 ###-Do you want to install Thunar file manager?
-thunar="Y"
-### Do you want to set Thunar as the default file manager? 
-thunar_choice="Y"
-
+thunar="ON"
 
 ### Adding user to the 'input' group might be necessary for waybar keyboard-state functionality
-input_group="Y"
+input_group="ON"
 
+### Desktop overview Demo Link in README
 ### Desktop overview Demo Link in README
 ### Install AGS (aylur's GTK shell) v1 for Desktop-Like Overview?" 
-ags="Y"
+ags="ON"
 
 ###-Install & configure SDDM log-in Manager
-sddm="Y"
+sddm="ON"
 ### install and download SDDM themes
-sddm_theme="Y"
+sddm_theme="ON"
 
 ###-Install XDG-DESKTOP-PORTAL-HYPRLAND? (For proper Screen Share ie OBS)
-xdph="Y"
+xdph="ON"
 
 ### Shell extension. Bash alternative
 ###-Install zsh, oh-my-zsh
-zsh="Y"
-
+zsh="ON"
 ### add Pokemon color scripts to terminal 
-pokemon_choice="Y"
+pokemon="ON"
 
 ### This will install ASUSCTL & SUPERGFXCTL
 ###-Installing on Asus ROG Laptops?
-rog="N"
+rog="OFF"
 
-###-Do you want to add pre-configured KooL's Hyprland dotfiles?
-dots="Y"
+###-Download and Add pre-configured Hyprland dotfiles?
+dots="ON"

refresh-hypr-tags.sh

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+# Refresh hypr-tags.env with latest release tags from upstream
+# Safe to run multiple times; creates timestamped backups
+
+set -euo pipefail
+
+REPO_ROOT=$(pwd)
+TAGS_FILE="$REPO_ROOT/hypr-tags.env"
+LOG_DIR="$REPO_ROOT/Install-Logs"
+mkdir -p "$LOG_DIR"
+TS=$(date +%F-%H%M%S)
+SUMMARY_LOG="$LOG_DIR/refresh-tags-$TS.log"
+
+# Ensure tags file exists
+if [[ ! -f "$TAGS_FILE" ]]; then
+  cat > "$TAGS_FILE" <<'EOF'
+HYPRLAND_TAG=v0.51.1
+AQUAMARINE_TAG=v0.9.3
+HYPRUTILS_TAG=v0.8.2
+HYPRLANG_TAG=v0.6.4
+HYPRGRAPHICS_TAG=v0.1.5
+HYPRWAYLAND_SCANNER_TAG=v0.4.5
+HYPRLAND_PROTOCOLS_TAG=v0.6.4
+HYPRLAND_QT_SUPPORT_TAG=v0.1.0
+HYPRLAND_QTUTILS_TAG=v0.1.4
+WAYLAND_PROTOCOLS_TAG=1.45
+EOF
+fi
+
+# Backup
+cp "$TAGS_FILE" "$TAGS_FILE.bak-$TS"
+echo "[INFO] Backed up $TAGS_FILE to $TAGS_FILE.bak-$TS" | tee -a "$SUMMARY_LOG"
+
+if ! command -v curl >/dev/null 2>&1; then
+  echo "[ERROR] curl is required to refresh tags" | tee -a "$SUMMARY_LOG"
+  exit 1
+fi
+
+# Map of env var -> repo
+declare -A repos=(
+  [HYPRLAND_TAG]="hyprwm/Hyprland"
+  [AQUAMARINE_TAG]="hyprwm/aquamarine"
+  [HYPRUTILS_TAG]="hyprwm/hyprutils"
+  [HYPRLANG_TAG]="hyprwm/hyprlang"
+  [HYPRGRAPHICS_TAG]="hyprwm/hyprgraphics"
+  [HYPRWAYLAND_SCANNER_TAG]="hyprwm/hyprwayland-scanner"
+  [HYPRLAND_PROTOCOLS_TAG]="hyprwm/hyprland-protocols"
+  [HYPRLAND_QT_SUPPORT_TAG]="hyprwm/hyprland-qt-support"
+  [HYPRLAND_QTUTILS_TAG]="hyprwm/hyprland-qtutils"
+)
+
+# Read existing
+declare -A cur
+while IFS='=' read -r k v; do
+  [[ -z "${k:-}" || "$k" =~ ^# ]] && continue
+  cur[$k]="$v"
+edone < "$TAGS_FILE"
+
+# Fetch latest, but only update keys set to 'auto' or 'latest' unless forced
+FORCE=${FORCE:-0}
+for key in "${!repos[@]}"; do
+  repo="${repos[$key]}"
+  url="https://api.github.com/repos/$repo/releases/latest"
+  echo "[INFO] Checking latest tag for $repo" | tee -a "$SUMMARY_LOG"
+  body=$(curl -fsSL "$url" || true)
+  [[ -z "$body" ]] && { echo "[WARN] Empty response for $repo" | tee -a "$SUMMARY_LOG"; continue; }
+  if command -v jq >/dev/null 2>&1; then
+    tag=$(printf '%s' "$body" | jq -r '.tag_name // empty')
+  else
+    tag=$(printf '%s' "$body" | grep -m1 '"tag_name"' | sed -E 's/.*"tag_name"\s*:\s*"([^"]+)".*/\1/')
+  fi
+  if [[ -z "$tag" ]]; then
+    echo "[WARN] Could not parse tag for $repo" | tee -a "$SUMMARY_LOG"
+    continue
+  fi
+  existing="${cur[$key]:-}"
+  if [[ $FORCE -eq 1 ]] || [[ "$existing" =~ ^(auto|latest)$ ]] || [[ -z "$existing" ]]; then
+    cur[$key]="$tag"
+    echo "[OK] $key := $tag" | tee -a "$SUMMARY_LOG"
+  else
+    echo "[SKIP] $key pinned ($existing), not overriding" | tee -a "$SUMMARY_LOG"
+  fi
+done
+
+# Write back
+{
+  for k in "${!cur[@]}"; do
+    echo "$k=${cur[$k]}"
+  done | sort
+} > "$TAGS_FILE"
+
+echo "[OK] Refreshed tags written to $TAGS_FILE" | tee -a "$SUMMARY_LOG"

uninstall.sh

@@ -0,0 +1,255 @@
+#!/bin/bash
+# 💫 https://github.com/JaKooLit 💫 #
+# KooL Debian-Hyprland uninstall script #
+
+clear
+
+# Set some colors for output messages
+OK="$(tput setaf 2)[OK]$(tput sgr0)"
+ERROR="$(tput setaf 1)[ERROR]$(tput sgr0)"
+NOTE="$(tput setaf 3)[NOTE]$(tput sgr0)"
+INFO="$(tput setaf 4)[INFO]$(tput sgr0)"
+WARN="$(tput setaf 1)[WARN]$(tput sgr0)"
+CAT="$(tput setaf 6)[ACTION]$(tput sgr0)"
+MAGENTA="$(tput setaf 5)"
+ORANGE="$(tput setaf 214)"
+WARNING="$(tput setaf 1)"
+YELLOW="$(tput setaf 3)"
+GREEN="$(tput setaf 2)"
+BLUE="$(tput setaf 4)"
+SKY_BLUE="$(tput setaf 6)"
+RESET="$(tput sgr0)"
+
+printf "\n%.0s" {1..2}
+echo -e "\e[35m
+	╦╔═┌─┐┌─┐╦    ╦ ╦┬ ┬┌─┐┬─┐┬  ┌─┐┌┐┌┌┬┐
+	╠╩╗│ ││ │║    ╠═╣└┬┘├─┘├┬┘│  ├─┤│││ ││ UNINSTALL
+	╩ ╩└─┘└─┘╩═╝  ╩ ╩ ┴ ┴  ┴└─┴─┘┴ ┴┘└┘─┴┘ Debian
+\e[0m"
+printf "\n%.0s" {1..1}
+
+# Show welcome message using whiptail with Yes/No options
+whiptail --title "Debian-Hyprland KooL Dots Uninstall Script" --yesno \
+"Hello! This script will uninstall KooL Hyprland packages and configs.
+
+You can choose packages and directories you want to remove.
+NOTE: This will remove configs from ~/.config
+
+WARNING: After uninstallation, your system may become unstable.
+
+Shall we Proceed?" 20 80
+
+if [ $? -eq 1 ]; then
+    echo "$INFO uninstall process canceled."
+    exit 0
+fi
+
+# Function to remove selected packages on Debian/Ubuntu
+remove_packages() {
+    local selected_packages_file=$1
+    while read -r package; do
+        # Check if the package is installed using dpkg (apt's underlying tool)
+        if dpkg -l | grep -q "^ii  $package "; then
+            echo "Removing package: $package"
+            if ! sudo apt remove -y "$package"; then
+                echo "$ERROR Failed to remove package: $package"
+            else
+                echo "$OK Successfully removed package: $package"
+            fi
+        else
+            echo "$INFO Package ${YELLOW}$package${RESET} not found. Skipping."
+        fi
+    done < "$selected_packages_file"
+}
+
+# Function to remove selected directories
+remove_directories() {
+    local selected_dirs_file=$1
+    while read -r dir; do
+        pattern="$HOME/.config/$dir*"        
+        # Loop through directories matching the pattern
+        for dir_to_remove in $pattern; do
+            if [ -d "$dir_to_remove" ]; then
+                echo "Removing directory: $dir_to_remove"
+                if ! rm -rf "$dir_to_remove"; then
+                    echo "$ERROR Failed to remove directory: $dir_to_remove"
+                else
+                    echo "$OK Successfully removed directory: $dir_to_remove"
+                fi
+            else
+                echo "$INFO Directory ${YELLOW}$dir_to_remove${RESET} not found. Skipping."
+            fi
+        done
+    done < "$selected_dirs_file"
+}
+
+# Define the list of packages to choose from (with options_command tags)
+packages=(
+    "btop" "resource monitor" "off"
+    "brightnessctl" "brightnessctl" "off"
+    "cava" "Cross-platform Audio Visualizer" "off"
+    "cliphist" "clipboard manager" "off"
+    "fastfetch" "fastfetch" "off"
+    "ffmpegthumbnailer" "FFmpeg Thumbnailer" "off"
+    "grim" "screenshot tool" "off"
+    "polkit-kde-agent-1" "polkit agent" "off"
+    "imagemagick" "Image manipulation tool" "off"
+    "kitty" "kitty-terminal" "off"
+    "qt5-style-kvantum" "QT apps theming" "off"
+    "qt5-style-kvantum-themes" "QT apps theming" "off"
+    "mousepad" "simple text editor" "off"
+    "mpv" "multi-media player" "off"
+    "mpv-mpris" "mpv-plugin" "off"
+    "nvtop" "gpu resource monitor" "off"
+    "nwg-displays" "display monitor configuration app" "off"
+    "nwg-look" "gtk settings app" "off"
+    "pamixer" "pamixer" "off"
+    "pavucontrol" "pavucontrol" "off"
+    "playerctl" "playerctl" "off"
+    "qalculate-gtk" "calculater - QT" "off"
+    "qt5ct" "qt5ct" "off"
+    "qt6-svg" "qt6-svg" "off"
+    "qt6ct" "qt6ct" "off"
+    "slurp" "screenshot tool" "off"
+    "swappy" "screenshot tool" "off"
+    "sway-notification-center" "notification agent" "off"
+    "swww" "wallpaper engine" "off"
+    "thunar" "File Manager" "off"
+    "thunar-archive-plugin" "Archive Plugin" "off"
+    "thunar-volman" "Volume Management" "off"
+    "tumbler" "Thumbnail Service" "off"
+    "wallust" "color pallete generator" "off"
+    "waybar" "wayland bar" "off"
+    "wl-clipboard" "clipboard manager" "off"
+    "wlogout" "logout menu" "off"
+    "xdg-desktop-portal-hyprland" "hyprland file picker" "off"
+    "yad" "dialog box" "off"
+    "yt-dlp" "video downloader" "off"
+    "xarchiver" "Archive Manager" "off"
+    "hyprland" "hyprland main package" "off"
+)
+
+# Define the list of directories to choose from (with options_command tags)
+directories=(
+    "ags" "AGS desktop overview configuration" "off"
+    "btop" "btop configuration" "off"
+    "cava" "cava configuration" "off"
+    "fastfetch" "fastfetch configuration" "off"
+    "hypr" "main hyprland configuration" "off"
+    "kitty" "kitty terminal configuration" "off"
+    "Kvantum" "Kvantum-manager configuration" "off"
+    "qt5ct" "qt5ct configuration" "off"
+    "qt6ct" "qt6ct configuration" "off"
+    "rofi" "rofi configuration" "off"
+    "swappy" "swappy (screenshot tool) configuration" "off"
+    "swaync" "swaync (notification agent) configuration" "off"
+    "Thunar" "Thunar file manager configuration" "off"
+    "wallust" "wallust (color pallete) configuration" "off"
+    "waybar" "waybar configuration" "off"
+    "wlogout" "wlogout (logout menu) configuration" "off"    
+)
+
+# Loop for package selection until user selects something or cancels
+while true; do
+    package_choices=$(whiptail --title "Select Packages to Uninstall" --checklist \
+    "Select the packages you want to remove\nNOTE: 'SPACEBAR' to select & 'TAB' key to change selection" 35 90 25 \
+    "${packages[@]}" 3>&1 1>&2 2>&3)
+
+    # Check if the user canceled the operation
+    if [ $? -eq 1 ]; then
+        echo "$INFO uninstall process canceled."
+        exit 0
+    fi
+
+    # If no packages are selected, ask again
+    if [[ -z "$package_choices" ]]; then
+        echo "$NOTE No packages selected. Please select at least one package."
+    else
+        echo "$package_choices" | tr -d '"' | tr ' ' '\n' > /tmp/selected_packages.txt
+        echo "Packages to remove: $package_choices"
+        break
+    fi
+done
+
+# Loop for directory selection until user selects something or cancels
+while true; do
+    dir_choices=$(whiptail --title "Select Directories to Remove" --checklist \
+    "Select the directories you want to remove\nNOTE: This will remove configs from ~/.config\n\nNOTE: 'SPACEBAR' to select & 'TAB' key to change selection" 28 90 18 \
+    "${directories[@]}" 3>&1 1>&2 2>&3)
+
+    # Check if the user canceled the operation
+    if [ $? -eq 1 ]; then
+        echo "$INFO uninstall process canceled."
+        exit 0
+    fi
+
+    # If no directories are selected, ask again
+    if [[ -z "$dir_choices" ]]; then
+        echo "$NOTE No directories selected. Please select at least one directory."
+    else
+        # Save each selected directory to a new line in the temporary file
+        echo "$dir_choices" | tr -d '"' | tr ' ' '\n' > /tmp/selected_directories.txt
+        echo "Directories to remove: $dir_choices"
+        break
+    fi
+done
+
+# First confirmation - Warning about potential instability
+if ! whiptail --title "Warning" --yesno \
+"Warning: Removing these packages and directories may cause your system to become unstable and you may not be able to recover it.\n\nAre you sure you want to proceed?" \
+10 80; then
+    echo "$INFO uninstall process canceled."
+    exit 0
+fi
+
+# Second confirmation - Final confirmation to proceed
+if ! whiptail --title "Final Confirmation" --yesno \
+"Are you absolutely sure you want to remove the selected packages and directories?\n\nWARNING! This action is irreversible." \
+10 80; then
+    echo "$INFO uninstall process canceled."
+    exit 0
+fi
+
+printf "\n%.0s" {1..1}
+printf "\n%s${SKY_BLUE}Attempting to remove selected packages${RESET}\n" "${NOTE}"
+MAX_ATTEMPTS=2
+ATTEMPT=0
+
+while [ $ATTEMPT -lt $MAX_ATTEMPTS ]; do
+    # Remove packages
+    remove_packages /tmp/selected_packages.txt
+
+    # Check if any packages still need to be removed, retry if needed
+    MISSING_PACKAGE_COUNT=0
+    while read -r package; do
+        if dpkg -l | grep -q "^ii  $package "; then
+            MISSING_PACKAGE_COUNT=$((MISSING_PACKAGE_COUNT + 1))
+        fi
+    done < /tmp/selected_packages.txt
+
+    if [ $MISSING_PACKAGE_COUNT -gt 0 ]; then
+        ATTEMPT=$((ATTEMPT + 1))
+        echo "Attempt #$ATTEMPT failed, retrying..."
+    else
+        break
+    fi
+done
+
+
+printf "\n%.0s" {1..1}
+printf "\n%s${SKY_BLUE}Attempting to remove locally installed packages${RESET}\n" "${NOTE}"
+for file in ags hypridle hyprlock rofi wallust; do
+    if [ -f "/usr/local/bin/$file" ]; then
+        sudo rm "/usr/local/bin/$file"
+        echo "$file removed."
+    fi
+done
+
+printf "\n%.0s" {1..1}
+printf "\n%s${SKY_BLUE}Attempting to remove selected directories${RESET}\n" "${NOTE}"
+remove_directories /tmp/selected_directories.txt
+
+printf "\n%.0s" {1..1}
+echo -e "$MAGENTA Hyprland and related components have been uninstalled.$RESET"
+echo -e "$YELLOW It is recommended to reboot your system now.$RESET"
+printf "\n%.0s" {1..1}

update-hyprland.sh

@@ -0,0 +1,522 @@
+#!/usr/bin/env bash
+# update-hyprland.sh
+# Manage and build just the Hyprland stack (Hyprland + companion apps/libs)
+# - Maintains a central tag file (hypr-tags.env) with versions
+# - Can fetch latest release tags from GitHub and update hypr-tags.env
+# - Can restore tags from a backup
+# - Can run a dry-run build (compile only) or install build of the stack
+#
+# Usage examples:
+#   chmod +x ./update-hyprland.sh
+#   ./update-hyprland.sh --dry-run                 # compile-only using current tags
+#   ./update-hyprland.sh --install                 # compile + install using current tags
+#   ./update-hyprland.sh --fetch-latest --dry-run  # refresh tags to latest, then dry-run
+#   ./update-hyprland.sh --set HYPRLAND=v0.51.1 --dry-run  # set one or more tags
+#   ./update-hyprland.sh --restore --dry-run       # restore most recent backup of tags and dry-run
+#   ./update-hyprland.sh --only hyprland,hyprutils --dry-run
+#   ./update-hyprland.sh --skip aquamarine --install
+#   ./update-hyprland.sh --with-deps --dry-run
+#   ./update-hyprland.sh --fetch-latest --via-helper   # use dry-run-build.sh for a summary-only run
+#
+# Notes:
+# - Requires curl; for --fetch-latest, jq is recommended (installed by 00-dependencies.sh)
+# - Works from repo root; do not cd into install-scripts/
+
+set -euo pipefail
+
+REPO_ROOT=$(pwd)
+TAGS_FILE="$REPO_ROOT/hypr-tags.env"
+LOG_DIR="$REPO_ROOT/Install-Logs"
+mkdir -p "$LOG_DIR"
+TS=$(date +%F-%H%M%S)
+SUMMARY_LOG="$LOG_DIR/update-hypr-$TS.log"
+
+# Default module order (core first, then Hyprland)
+DEFAULT_MODULES=(
+    xkbcommon
+    hyprutils
+    hyprlang
+    hyprtoolkit
+    wayland-protocols-src
+    aquamarine
+    hyprgraphics
+    hyprwayland-scanner
+    hyprland-protocols
+    hyprland-qt-support
+    hyprland-guiutils
+    hyprland
+)
+
+WITH_DEPS=0
+DO_INSTALL=0
+DO_DRY_RUN=0
+FETCH_LATEST=0
+RESTORE=0
+VIA_HELPER=0
+NO_FETCH=0
+ONLY_LIST=""
+SKIP_LIST=""
+SET_ARGS=()
+
+usage() {
+    sed -n '2,120p' "$0" | sed -n '/^# /p' | sed 's/^# \{0,1\}//'
+}
+
+ensure_tags_file() {
+    if [[ ! -f "$TAGS_FILE" ]]; then
+        echo "[INFO] Creating default tags file: $TAGS_FILE" | tee -a "$SUMMARY_LOG"
+        cat >"$TAGS_FILE" <<'EOF'
+HYPRLAND_TAG=v0.50.1
+AQUAMARINE_TAG=v0.9.2
+HYPRUTILS_TAG=v0.8.2
+HYPRLANG_TAG=v0.6.4
+HYPRGRAPHICS_TAG=v0.1.5
+HYPRWAYLAND_SCANNER_TAG=v0.4.5
+HYPRLAND_PROTOCOLS_TAG=v0.6.4
+HYPRLAND_QT_SUPPORT_TAG=v0.1.0
+HYPRLAND_QTUTILS_TAG=v0.1.4
+EOF
+    fi
+}
+
+backup_tags() {
+    ensure_tags_file
+    cp "$TAGS_FILE" "$TAGS_FILE.bak-$TS"
+    echo "[INFO] Backed up $TAGS_FILE to $TAGS_FILE.bak-$TS" | tee -a "$SUMMARY_LOG"
+}
+
+restore_tags() {
+    latest_bak=$(ls -1t "$TAGS_FILE".bak-* 2>/dev/null | head -n1 || true)
+    if [[ -z "$latest_bak" ]]; then
+        echo "[ERROR] No backup tags file found." | tee -a "$SUMMARY_LOG"
+        exit 1
+    fi
+    cp "$latest_bak" "$TAGS_FILE"
+    echo "[INFO] Restored tags from $latest_bak" | tee -a "$SUMMARY_LOG"
+}
+
+set_tags_from_args() {
+    ensure_tags_file
+    backup_tags
+    # load existing into assoc map
+    declare -A map
+    while IFS='=' read -r k v; do
+        [[ -z "$k" || "$k" =~ ^# ]] && continue
+        map[$k]="$v"
+    done <"$TAGS_FILE"
+    for kv in "${SET_ARGS[@]}"; do
+        key="${kv%%=*}"
+        val="${kv#*=}"
+        case "$key" in
+        HYPRLAND | hyprland) key=HYPRLAND_TAG ;;
+        AQUAMARINE | aquamarine) key=AQUAMARINE_TAG ;;
+        HYPRUTILS | hyprutils) key=HYPRUTILS_TAG ;;
+        HYPRLANG | hyprlang) key=HYPRLANG_TAG ;;
+        HYPRGRAPHICS | hyprgraphics) key=HYPRGRAPHICS_TAG ;;
+        HYPRWAYLAND_SCANNER | hyprwayland-scanner | hyprwayland_scanner) key=HYPRWAYLAND_SCANNER_TAG ;;
+        HYPRLAND_PROTOCOLS | hyprland-protocols | hyprland_protocols) key=HYPRLAND_PROTOCOLS_TAG ;;
+        HYPRLAND_QT_SUPPORT | hyprland-qt-support | hyprland_qt_support) key=HYPRLAND_QT_SUPPORT_TAG ;;
+        HYPRLAND_QTUTILS | hyprland-qtutils | hyprland_qtutils) key=HYPRLAND_QTUTILS_TAG ;;
+        esac
+        map[$key]="$val"
+    done
+    {
+        for k in "${!map[@]}"; do
+            echo "$k=${map[$k]}"
+        done | sort
+    } >"$TAGS_FILE"
+    echo "[INFO] Updated $TAGS_FILE with provided tags" | tee -a "$SUMMARY_LOG"
+}
+
+# Fetch latest release tags from GitHub for the stack
+fetch_latest_tags() {
+    ensure_tags_file
+    backup_tags
+
+    # Require curl; jq is preferred. Fallback to grep/sed if jq is missing.
+    if ! command -v curl >/dev/null 2>&1; then
+        echo "[ERROR] curl is required." | tee -a "$SUMMARY_LOG"
+        exit 1
+    fi
+
+    # Read existing to respect pinned values (only update keys set to 'auto' or 'latest')
+    declare -A existing
+    while IFS='=' read -r k v; do
+        [[ -z "$k" || "$k" =~ ^# ]] && continue
+        existing[$k]="$v"
+    done <"$TAGS_FILE"
+
+    declare -A repos=(
+        [HYPRLAND_TAG]="hyprwm/Hyprland"
+        [AQUAMARINE_TAG]="hyprwm/aquamarine"
+        [HYPRUTILS_TAG]="hyprwm/hyprutils"
+        [HYPRLANG_TAG]="hyprwm/hyprlang"
+        [HYPRGRAPHICS_TAG]="hyprwm/hyprgraphics"
+        [HYPRWAYLAND_SCANNER_TAG]="hyprwm/hyprwayland-scanner"
+        [HYPRLAND_PROTOCOLS_TAG]="hyprwm/hyprland-protocols"
+        [HYPRLAND_QT_SUPPORT_TAG]="hyprwm/hyprland-qt-support"
+        [HYPRLAND_QTUTILS_TAG]="hyprwm/hyprland-qtutils"
+    )
+
+    declare -A tags
+
+    for key in "${!repos[@]}"; do
+        repo="${repos[$key]}"
+        url="https://api.github.com/repos/$repo/releases/latest"
+        echo "[INFO] Fetching latest tag for $repo" | tee -a "$SUMMARY_LOG"
+        body=$(curl -fsSL "$url" || true)
+        if [[ -z "$body" ]]; then
+            echo "[WARN] Empty response for $repo; leaving $key unchanged" | tee -a "$SUMMARY_LOG"
+            continue
+        fi
+        if command -v jq >/dev/null 2>&1; then
+            tag=$(printf '%s' "$body" | jq -r '.tag_name // empty')
+        else
+            tag=$(printf '%s' "$body" | grep -m1 '"tag_name"' | sed -E 's/.*"tag_name"\s*:\s*"([^"]+)".*/\1/')
+        fi
+        if [[ -n "$tag" ]]; then
+            tags[$key]="$tag"
+        else
+            echo "[WARN] Could not parse tag for $repo; leaving $key unchanged" | tee -a "$SUMMARY_LOG"
+        fi
+    done
+
+    # Merge into existing file
+    declare -A map
+    while IFS='=' read -r k v; do
+        [[ -z "$k" || "$k" =~ ^# ]] && continue
+        map[$k]="$v"
+    done <"$TAGS_FILE"
+
+    for k in "${!tags[@]}"; do
+        # Only override if pinned value is 'auto' or 'latest'
+        if [[ "${existing[$k]:-}" =~ ^(auto|latest)$ ]] || [[ -z "${existing[$k]:-}" ]]; then
+            map[$k]="${tags[$k]}"
+        fi
+    done
+
+    {
+        for k in "${!map[@]}"; do
+            echo "$k=${map[$k]}"
+        done | sort
+    } >"$TAGS_FILE"
+
+    echo "[INFO] Refreshed tags written to $TAGS_FILE" | tee -a "$SUMMARY_LOG"
+}
+
+# Build runner using module scripts. Uses env vars from TAGS_FILE.
+run_stack() {
+    # shellcheck disable=SC1090
+    source "$TAGS_FILE"
+    # Export tags so child scripts inherit them
+    export HYPRLAND_TAG AQUAMARINE_TAG HYPRUTILS_TAG HYPRLANG_TAG HYPRGRAPHICS_TAG HYPRWAYLAND_SCANNER_TAG HYPRLAND_PROTOCOLS_TAG HYPRLAND_QT_SUPPORT_TAG HYPRLAND_QTUTILS_TAG WAYLAND_PROTOCOLS_TAG
+
+    # Optionally install dependencies (not dry-run)
+    if [[ $WITH_DEPS -eq 1 ]]; then
+        echo "[INFO] Installing dependencies via 00-dependencies.sh" | tee -a "$SUMMARY_LOG"
+        if ! "$REPO_ROOT/install-scripts/00-dependencies.sh"; then
+            echo "[ERROR] Dependencies installation failed." | tee -a "$SUMMARY_LOG"
+            exit 1
+        fi
+    fi
+
+    # Build module list based on --only/--skip
+    local modules
+    if [[ -n "$ONLY_LIST" ]]; then
+        IFS=',' read -r -a modules <<<"$ONLY_LIST"
+    else
+        modules=("${DEFAULT_MODULES[@]}")
+    fi
+    if [[ -n "$SKIP_LIST" ]]; then
+        IFS=',' read -r -a _skips <<<"$SKIP_LIST"
+        local filtered=()
+        for m in "${modules[@]}"; do
+            local skip_it=0
+            for s in "${_skips[@]}"; do
+                [[ "$m" == "$s" ]] && {
+                    skip_it=1
+                    break
+                }
+            done
+            [[ $skip_it -eq 0 ]] && filtered+=("$m")
+        done
+        modules=("${filtered[@]}")
+    fi
+
+    # Ensure core prerequisites are installed before hyprland on install runs
+    # Order: wayland-protocols-src, hyprland-protocols, hyprutils, hyprlang, aquamarine, hyprland
+    if [[ $DO_INSTALL -eq 1 ]]; then
+        # Auto-fetch latest tags for Hyprland stack unless disabled
+        if [[ $NO_FETCH -eq 0 ]]; then
+            # Detect whether hyprland is part of the run
+            need_fetch=0
+            for m in "${modules[@]}"; do
+                [[ "$m" == "hyprland" ]] && need_fetch=1
+            done
+            if [[ $need_fetch -eq 1 ]]; then
+                echo "[INFO] Auto-fetching latest tags for Hyprland stack" | tee -a "$SUMMARY_LOG"
+                fetch_latest_tags
+            fi
+        fi
+        local has_hl=0 has_aqua=0 has_wp=0 has_utils=0 has_lang=0 has_hlprot=0
+        for m in "${modules[@]}"; do
+            [[ "$m" == "hyprland" ]] && has_hl=1
+            [[ "$m" == "aquamarine" ]] && has_aqua=1
+            [[ "$m" == "wayland-protocols-src" ]] && has_wp=1
+            [[ "$m" == "hyprland-protocols" ]] && has_hlprot=1
+            [[ "$m" == "hyprutils" ]] && has_utils=1
+            [[ "$m" == "hyprlang" ]] && has_lang=1
+        done
+        if [[ $has_hl -eq 1 ]]; then
+            # ensure each prerequisite is present
+            [[ $has_wp -eq 0 ]] && modules=("wayland-protocols-src" "${modules[@]}")
+            [[ $has_hlprot -eq 0 ]] && modules=("hyprland-protocols" "${modules[@]}")
+            [[ $has_utils -eq 0 ]] && modules=("hyprutils" "${modules[@]}")
+            [[ $has_lang -eq 0 ]] && modules=("hyprlang" "${modules[@]}")
+            [[ $has_aqua -eq 0 ]] && modules=("aquamarine" "${modules[@]}")
+
+            # Reorder to exact sequence before hyprland
+            # Remove existing occurrences and rebuild in correct order
+            local tmp=()
+            local inserted_wp=0 inserted_hlprot=0 inserted_utils=0 inserted_lang=0 inserted_aqua=0
+            for m in "${modules[@]}"; do
+                if [[ "$m" == "wayland-protocols-src" ]]; then
+                    if [[ $inserted_wp -eq 0 ]]; then
+                        tmp+=("wayland-protocols-src")
+                        inserted_wp=1
+                    fi
+                elif [[ "$m" == "hyprland-protocols" ]]; then
+                    if [[ $inserted_hlprot -eq 0 ]]; then
+                        # ensure wayland-protocols-src before hyprland-protocols
+                        if [[ $inserted_wp -eq 0 ]]; then
+                            tmp+=("wayland-protocols-src")
+                            inserted_wp=1
+                        fi
+                        tmp+=("hyprland-protocols")
+                        inserted_hlprot=1
+                    fi
+                elif [[ "$m" == "hyprutils" ]]; then
+                    if [[ $inserted_utils -eq 0 ]]; then
+                        # ensure protocols before utils
+                        if [[ $inserted_wp -eq 0 ]]; then
+                            tmp+=("wayland-protocols-src")
+                            inserted_wp=1
+                        fi
+                        if [[ $inserted_hlprot -eq 0 ]]; then
+                            tmp+=("hyprland-protocols")
+                            inserted_hlprot=1
+                        fi
+                        tmp+=("hyprutils")
+                        inserted_utils=1
+                    fi
+                elif [[ "$m" == "hyprlang" ]]; then
+                    if [[ $inserted_lang -eq 0 ]]; then
+                        # ensure utils before lang
+                        if [[ $inserted_utils -eq 0 ]]; then
+                            if [[ $inserted_wp -eq 0 ]]; then
+                                tmp+=("wayland-protocols-src")
+                                inserted_wp=1
+                            fi
+                            if [[ $inserted_hlprot -eq 0 ]]; then
+                                tmp+=("hyprland-protocols")
+                                inserted_hlprot=1
+                            fi
+                            tmp+=("hyprutils")
+                            inserted_utils=1
+                        fi
+                        tmp+=("hyprlang")
+                        inserted_lang=1
+                    fi
+                elif [[ "$m" == "aquamarine" ]]; then
+                    if [[ $inserted_aqua -eq 0 ]]; then
+                        # ensure lang before aquamarine
+                        if [[ $inserted_lang -eq 0 ]]; then
+                            if [[ $inserted_utils -eq 0 ]]; then
+                                if [[ $inserted_wp -eq 0 ]]; then
+                                    tmp+=("wayland-protocols-src")
+                                    inserted_wp=1
+                                fi
+                                if [[ $inserted_hlprot -eq 0 ]]; then
+                                    tmp+=("hyprland-protocols")
+                                    inserted_hlprot=1
+                                fi
+                                tmp+=("hyprutils")
+                                inserted_utils=1
+                            fi
+                            tmp+=("hyprlang")
+                            inserted_lang=1
+                        fi
+                        tmp+=("aquamarine")
+                        inserted_aqua=1
+                    fi
+                elif [[ "$m" == "hyprland" ]]; then
+                    # ensure all prerequisites already present
+                    if [[ $inserted_wp -eq 0 ]]; then
+                        tmp+=("wayland-protocols-src")
+                        inserted_wp=1
+                    fi
+                    if [[ $inserted_hlprot -eq 0 ]]; then
+                        tmp+=("hyprland-protocols")
+                        inserted_hlprot=1
+                    fi
+                    if [[ $inserted_utils -eq 0 ]]; then
+                        tmp+=("hyprutils")
+                        inserted_utils=1
+                    fi
+                    if [[ $inserted_lang -eq 0 ]]; then
+                        tmp+=("hyprlang")
+                        inserted_lang=1
+                    fi
+                    if [[ $inserted_aqua -eq 0 ]]; then
+                        tmp+=("aquamarine")
+                        inserted_aqua=1
+                    fi
+                    tmp+=("hyprland")
+                else
+                    tmp+=("$m")
+                fi
+            done
+            modules=("${tmp[@]}")
+        fi
+    fi
+
+    declare -A results
+
+    for mod in "${modules[@]}"; do
+        local script="$REPO_ROOT/install-scripts/$mod.sh"
+        echo "\n=== $mod ===" | tee -a "$SUMMARY_LOG"
+        [[ -f "$script" ]] || {
+            echo "[WARN] Missing $script" | tee -a "$SUMMARY_LOG"
+            results[$mod]="MISSING"
+            continue
+        }
+        chmod +x "$script" || true
+        if [[ $DO_DRY_RUN -eq 1 ]]; then
+            if DRY_RUN=1 "$script"; then results[$mod]="PASS"; else results[$mod]="FAIL"; fi
+        else
+            if "$script"; then results[$mod]="INSTALLED"; else results[$mod]="FAIL"; fi
+        fi
+    done
+
+    {
+        echo "\nSummary:"
+        for mod in "${modules[@]}"; do
+            printf "%-24s %s\n" "$mod" "${results[$mod]:-SKIPPED}"
+        done
+        echo "\nLogs under: $LOG_DIR. This run: $SUMMARY_LOG"
+    } | tee -a "$SUMMARY_LOG"
+
+    # Non-zero on any FAILs
+    local failed=0
+    for mod in "${modules[@]}"; do
+        [[ "${results[$mod]:-}" == FAIL ]] && failed=1
+    done
+    return $failed
+}
+
+# Parse args
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+    -h | --help)
+        usage
+        exit 0
+        ;;
+    --with-deps)
+        WITH_DEPS=1
+        shift
+        ;;
+    --dry-run)
+        DO_DRY_RUN=1
+        shift
+        ;;
+    --install)
+        DO_INSTALL=1
+        shift
+        ;;
+    --fetch-latest)
+        FETCH_LATEST=1
+        shift
+        ;;
+    --restore)
+        RESTORE=1
+        shift
+        ;;
+    --via-helper)
+        VIA_HELPER=1
+        shift
+        ;;
+    --no-fetch)
+        NO_FETCH=1
+        shift
+        ;;
+    --only)
+        ONLY_LIST=${2:-}
+        shift 2
+        ;;
+    --skip)
+        SKIP_LIST=${2:-}
+        shift 2
+        ;;
+    --set)
+        shift
+        while [[ $# -gt 0 && "$1" != --* ]]; do
+            SET_ARGS+=("$1")
+            shift
+        done
+        ;;
+    *)
+        echo "Unknown argument: $1"
+        exit 2
+        ;;
+    esac
+done
+
+# Validate options
+if [[ $DO_INSTALL -eq 1 && $DO_DRY_RUN -eq 1 ]]; then
+    echo "[ERROR] Use either --dry-run or --install, not both." | tee -a "$SUMMARY_LOG"
+    exit 2
+fi
+
+ensure_tags_file
+
+# Apply tag operations
+if [[ $RESTORE -eq 1 ]]; then
+    restore_tags
+fi
+if [[ ${#SET_ARGS[@]} -gt 0 ]]; then
+    set_tags_from_args
+fi
+if [[ $FETCH_LATEST -eq 1 ]]; then
+    fetch_latest_tags
+fi
+
+# Run the stack
+if [[ $DO_DRY_RUN -eq 0 && $DO_INSTALL -eq 0 ]]; then
+    echo "[INFO] No build option specified. Defaulting to --dry-run." | tee -a "$SUMMARY_LOG"
+    DO_DRY_RUN=1
+fi
+
+# If using helper, delegate to dry-run-build.sh for summary-only output
+if [[ $VIA_HELPER -eq 1 ]]; then
+    if [[ $DO_INSTALL -eq 1 ]]; then
+        echo "[ERROR] --via-helper cannot be combined with --install (helper is dry-run only)." | tee -a "$SUMMARY_LOG"
+        exit 2
+    fi
+    # shellcheck disable=SC1090
+    source "$TAGS_FILE"
+    export HYPRLAND_TAG AQUAMARINE_TAG HYPRUTILS_TAG HYPRLANG_TAG HYPRGRAPHICS_TAG HYPRWAYLAND_SCANNER_TAG HYPRLAND_PROTOCOLS_TAG HYPRLAND_QT_SUPPORT_TAG HYPRLAND_QTUTILS_TAG WAYLAND_PROTOCOLS_TAG
+    helper="$REPO_ROOT/dry-run-build.sh"
+    if [[ ! -x "$helper" ]]; then
+        echo "[ERROR] dry-run-build.sh not found or not executable at $helper" | tee -a "$SUMMARY_LOG"
+        exit 1
+    fi
+    args=()
+    [[ $WITH_DEPS -eq 1 ]] && args+=("--with-deps")
+    [[ -n "$ONLY_LIST" ]] && args+=("--only" "$ONLY_LIST")
+    [[ -n "$SKIP_LIST" ]] && args+=("--skip" "$SKIP_LIST")
+    echo "[INFO] Delegating to dry-run-build.sh ${args[*]}" | tee -a "$SUMMARY_LOG"
+    "$helper" "${args[@]}"
+    exit $?
+fi
+
+run_stack