From a23551c7f25b7243cfac78971e5e2894fb10d048 Mon Sep 17 00:00:00 2001 From: "Celestial.y" Date: Tue, 7 Oct 2025 09:57:17 +0800 Subject: [PATCH] Add deps-info.md --- scriptdata/deps-info.md | 89 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 scriptdata/deps-info.md diff --git a/scriptdata/deps-info.md b/scriptdata/deps-info.md new file mode 100644 index 000000000..16ccd565d --- /dev/null +++ b/scriptdata/deps-info.md @@ -0,0 +1,89 @@ +## Status: WIP +This file was generated by AI (see [#2102](https://github.com/end-4/dots-hyprland/issues/2102)). +It still needs manual correction. + +## Information +Meta-packages (from 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. +- kde-material-you-colors (wrapper script path under $XDG_CONFIG_HOME/matugen/templates/kde/) + - Used by: switchwall.sh handle_kde_material_you_colors to sync KDE color scheme. + - Purpose: KDE scheme generation/synchronization. +- yay (or yay-bin from AUR) + - Used by: 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: 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 dist-arch/*; the above is aligned with how the code uses these tools.