Skip to content

Dependencies

João Dias edited this page Dec 20, 2025 · 50 revisions

ℹ️ Notice: package names that are listed below are from the Arch Linux repos. Some can also have the same name in your distro's package repo, but others may not. You can check which packages are available for your distro before applying the dotfiles (you can build any if needed);

📦 Needed Packages

  • hyprland: of course 😝
  • hypridle: idle daemon for Hyprland
  • hyprlock: lock screen for Hyprland
  • curl: fetch stuff from http(s), it is used to fetch the installation script(you may not remove it after installation)
  • git: version control system, used in the installation(you probably don't want to remove it too)
  • jq: json interpreter, used in the installation process and update script(you should also not remove it after installation)
  • hyprpaper: wallpaper daemon for Hyprland
  • gobject-introspection: GObject Introspection libraries support
  • hyprpicker: color picker for Hyprland
  • kitty: terminal emulator with GPU acceleration that supports image rendering! 🐱 (You need this to open terminal windows in Hyprland in the first time)
  • procps-ng: process locating tools
  • cliphist: clipboard manager
  • socat: socket communication support for the shell(makes CLI calls faster)
  • ttf-nerd-fonts-symbols-mono: nerd font symbols-only font(for some icon glyphs)
  • wireplumber: policy manager for pipewire
  • glycin: image processing library (used in wallpapers plugin)
  • glycin-gtk4: library that better integrates glycin with gtk4
  • networkmanager: network managing tool. enable NetworkManager service on systemd after installing it with sudo systemctl enable NetworkManager for the network to work correctly.
  • pipewire: Audio server
  • hyprpolkitagent: polkit agent for Hyprland (if it's not working, use polkit-gnome)
  • gjs: GnomeJS, GObject Bindings for JavaScript
  • typescript: the TypeScript compiler
  • ibus: input bus, allows composing special characters in linux apps(GTK4 now needs this for accents and special character composing)
  • aylurs-gtk-shell-git: cli to compile colorshell
  • libastal-meta: astal libraries(bluetooth, network, mpris...)
  • dart-sass: compile the sass stylesheets(needed at runtime)
  • python-pywal16: color scheme generator used in the shell
  • hyprshot: screenshot tool for Hyprland
  • hyprsunset: blue light filters for Hyprland
  • pnpm: package manager for node, used at compile-time

Quick Install

Before running the command below, ensure you have yay installed, or replace it with your preferred one of the AUR helpers.
This is the command to install all of the packages above (will only work with Arch Linux or an Arch-based distro!):

yay -Syu --needed git gobject-introspection ttf-nerd-fonts-symbols-mono curl uwsm hyprland hypridle hyprlock hyprpaper socat hyprpicker kitty cliphist wireplumber networkmanager pipewire dart-sass glycin glycin-gtk4 ibus procps-ng hyprpolkitagent jq pnpm gjs typescript aylurs-gtk-shell-git libastal-meta python-pywal16 hyprshot hyprsunset wf-recorder overskride 
sudo systemctl enable --now NetworkManager

🌟 Optional

  • uwsm: the universal wayland session manager, recommended way to start Hyprland
  • pavucontrol: dedicated volume manager app
  • overskride: dedicated bluetooth app
  • wf-recorder: screen recording(needed for the recording feature in the shell)

You can install all of them with your distro's package manager, or build them yourself if needed. Click the package name to go to their official source code.

💡 Tips

If you can't find one of the listed packages in your package manager, here are some tips to get it for your distro!

logo Fedora

On Fedora, if the package is not available through dnf, you can try searching in copr(Fedora's community repos). But remember to get a trustful one! Or you can try building your own package if you have time to do so, it would be amazing to the distro community!

Arch Linux and other Arch based distros

You can try searching for the packages in the Official Arch Repos(pacman), or use any of the AUR Helpers(e.g.: yay or paru)

Clone this wiki locally