dots-hyprland/sdata/deps-info.md

Status: WIP

This file was generated by AI (see #2102). It still needs manual correction.

Information

Meta-packages (from sdata/dist-arch/install-deps.sh)

• illogical-impulse-basic
  • Purpose: Core shell tooling used by scripts (general CLI utilities, build helpers, JSON processing, etc.).
• illogical-impulse-audio
  • Purpose: Audio stack (e.g., PipeWire/WirePlumber, mixers, control UIs) used by widgets and desktop integrations.
• illogical-impulse-backlight
  • Purpose: Screen brightness control utilities (e.g., brightnessctl).
• illogical-impulse-fonts-themes
  • Purpose: Fonts and themes used across the shell/widgets (Noto, emoji fonts, icon themes, GTK/Qt themes).
• illogical-impulse-kde
  • Purpose: KDE integration bits (dialogs, theming helpers, optional browser integration).
• illogical-impulse-portal
  • Purpose: Desktop portals (e.g., xdg-desktop-portal and Wayland compositor-specific portals).
• illogical-impulse-python
  • Purpose: Python 3 and libs for repo Python scripts and virtualenv activation.
• illogical-impulse-screencapture
  • Purpose: Screenshot/recording tools on Wayland (e.g., grim, slurp, wf-recorder or similar).
• illogical-impulse-toolkit
  • Purpose: General utilities used by scripts (jq, imagemagick, bc, etc.).
• illogical-impulse-widgets
  • Purpose: Runtime deps for Quickshell widgets and supporting tools used in the UI modules.
• illogical-impulse-hyprland
  • Purpose: Hyprland compositor and related tools (hyprland, hyprctl, hypridle, hyprlock, hyprcursor, portals).
• illogical-impulse-microtex-git
  • Purpose: MicroTeX-related setup used by this config (custom packaging).
• illogical-impulse-bibata-modern-classic-bin (optional)
  • Purpose: Bibata Modern Classic mouse cursor theme (installed only if not present).

Concrete dependencies inferred from repository scripts

• hyprland (provides hyprctl)
  • Purpose: Compositor
• jq
  • Used by: switchwall.sh (JSON parsing), multiple scripts reading config.json, hyprctl -j output.
  • Purpose: JSON parsing and transformation.
• matugen (AUR)
  • Used by: switchwall.sh to generate Material You colors from image or color input.
  • Purpose: Color extraction and scheme generation.
• python (python3) + virtualenv (python-virtualenv)
  • Used by: switchwall.sh activates $ILLOGICAL_IMPULSE_VIRTUAL_ENV and runs generate_colors_material.py.
  • Purpose: Color processing
• imagemagick (identify)
  • Used by: switchwall.sh to probe image width/height to suggest upscaling.
  • Purpose: Image metadata inspection.
• bc
  • Used by: switchwall.sh for simple arithmetic on cursor coordinates.
  • Purpose: Shell-friendly math.
• xdg-user-dirs (xdg-user-dir)
  • Used by: switchwall.sh to locate Pictures folder.
  • Purpose: XDG directories resolution.
• libnotify (notify-send)
  • Used by: switchwall.sh to interactively prompt actions (install/open apps) via notifications.
  • Purpose: Desktop notifications with actions.
• hyprpicker (AUR)
  • Used by: switchwall.sh for picking colors from screen when --color is passed without hex.
  • Purpose: On-screen color picker (Wayland).
• mpvpaper (AUR)
  • Used by: switchwall.sh to set video wallpapers per monitor.
  • Purpose: Video wallpaper playback under Wayland.
• ffmpeg
  • Used by: switchwall.sh to extract a frame from videos to derive colors and thumbnails.
  • Purpose: Video frame extraction and media handling.
• kitty
  • Used by: switchwall.sh to run interactive installs or external tools in a terminal (kitty -1 ...).
  • Purpose: Terminal emulator integration.
• kdialog (KDE)
  • Used by: switchwall.sh to open a file picker for choosing wallpapers.
  • Purpose: GUI file selection dialog.
• glib2 (gsettings) + dconf
  • Used by: switchwall.sh to set GNOME interface color-scheme and GTK theme.
  • Purpose: System settings manipulation.
• yay (or yay-bin from AUR)
  • Used by: sdata/dist-arch/install-deps.sh to build/install local PKGBUILDs and dependencies.
  • Purpose: AUR helper used by installer.
• base-devel, git, makepkg (core Arch tooling)
  • Used by: sdata/dist-arch/install-deps.sh and update.sh for building AUR/PKGBUILD packages and repository management.
  • Purpose: Build toolchain and VCS for packaging.

Notes

• Some Hyprland-adjacent packages appear in a legacy removal list as -git variants (e.g., hypridle, hyprlock, xdg-desktop-portal-hyprland). This suggests the meta-packages likely standardized on stable repo versions now.
• Exact package lists per meta-package should be verified against the PKGBUILD files in sdata/dist-arch/*; the above is aligned with how the code uses these tools.