Installation
HyprPanel has a few dependencies that need to be installed before you can use it. You can find a list of these dependencies below:
Dependencies
Bun
Bun is used to transpile and bundle HyprPanel. You can install it using the following command:
curl -fsSL https://bun.sh/install | bash && \
sudo ln -s $HOME/.bun/bin/bun /usr/local/bin/bun
Panel Dependencies
Required
pipewire
libgtop
bluez
bluez-utils
grimblast
gpu-screen-recorder
hyprpicker
btop
networkmanager
matugen
wl-clipboard
swww
dart-sass
brightnessctl
gnome-bluetooth-3.0
WARNING
HyprPanel will not run without the required dependencies.
Optional
## Used for Tracking GPU Usage in your Dashboard (NVidia only)
python
python-gpustat
## Only if a pywal hook from wallpaper changes applied through settings is desired
pywal
## To check for pacman updates in the default script used in the updates module
pacman-contrib
## To switch between power profiles in the battery module
power-profiles-daemon
Arch
To install the dependencies on Arch, you can use the following commands:
pacman:
sudo pacman -S pipewire libgtop bluez bluez-utils btop networkmanager dart-sass wl-clipboard brightnessctl swww python gnome-bluetooth-3.0 pacman-contrib power-profiles-daemon
AUR:
yay -S grimblast-git gpu-screen-recorder hyprpicker matugen-bin python-gpustat aylurs-gtk-shell-git
Fedora
Add solopasha/hyprland for most hyprland-related dependencies, and hues-sueh/packages for matugen. Both provide the swww package, so prioritise the former repo:
COPR
sudo dnf copr enable solopasha/hyprland
sudo dnf copr enable heus-sueh/packages
sudo dnf config-manager --save --setopt=copr:copr.fedorainfracloud.org:heus-sueh:packages.priority=200
DNF:
sudo dnf install pipewire libgtop2 bluez bluez-tools grimblast hyprpicker btop NetworkManager wl-clipboard swww brightnessctl gnome-bluetooth aylurs-gtk-shell power-profiles-daemon gvfs
bun:
bun install -g sass
flatpak:
flatpak install flathub --system com.dec05eba.gpu_screen_recorder
Optional Dependencies
pip:
sudo dnf install python python3-pip; pip install gpustat pywal
NixOS & Home Manager
Alternatively, if you're using NixOS and/or Home-Manager, you can setup AGS using the provided Nix Flake. First, add the repository to your Flake's inputs, and enable the overlay.
flake.nix
{
inputs.hyprpanel.url = "github:Jas-SinghFSU/HyprPanel";
# ...
outputs = { self, nixpkgs, ... }@inputs:
let
# ...
system = "x86_64-linux"; # change to whatever your system should be.
pkgs = import nixpkgs {
inherit system;
# ...
overlays = [
inputs.hyprpanel.overlay
];
};
in {
# ...
}
}
Once you've set up the overlay, you can reference HyprPanel with pkgs.hyprpanel
as if it were any other Nix package. This means you can reference it as a NixOS system/user package, a Home-Manager user package, or as a direct reference in your Hyprland configuration (if your configuration is managed by Home-Manager). The first three methods will add it to your $PATH
(first globally, second two user-only), however the final will not.
configuration.nix & home.nix
# configuration.nix
# install it as a system package
environment.systemPackages = with pkgs; [
# ...
hyprpanel
# ...
];
# or install it as a user package
users.users.<username>.packages = with pkgs; [
# ...
hyprpanel
# ...
];
# home.nix
# install it as a user package with home-manager
home.packages = with pkgs; [
# ...
hyprpanel
# ...
];
# or reference it directly in your Hyprland configuration
wayland.windowManager.hyprland.settings.exec-once = [
"${pkgs.hyprpanel}/bin/hyprpanel"
];
Installing NerdFonts
HyprPanel uses Nerdfonts to display icons. You can install them using the following command from within the HyprPanel directory:
# Installs the JetBrainsMono NerdFonts used for icons
./install_fonts.sh
If you install the fonts after installing HyperPanel, you will need to restart HyperPanel for the changes to take effect.
Running HyprPanel
Once you've installed the dependencies, you must put the contents of the HyprPanel
repository in your ~/.config/ags
directory. The command to do this is provided below.
If you already have something in that directory, it is recommended that you back it up with the following command:
# Moves the current ~/.config/ags directory to ~/.config/ags.bkup
mv $HOME/.config/ags $HOME/.config/ags.bkup
You can then install HyprPanel with the following command:
# Installs HyprPanel to ~/.config/ags
git clone https://github.com/Jas-SinghFSU/HyprPanel.git && \
ln -s $(pwd)/HyprPanel $HOME/.config/ags
Launching the panel
Once you've installed HyprPanel, you can launch it using the following command:
ags
Launching the panel on startup
To launch the panel on startup, you can add the following line to your ~/.config/hypr/hyprland.conf
file:
exec-once = ags
This will automatically launch HyprPanel on Hyprland startup.
WARNING
HyprPanel handles notifications through the AGS built-in notification service. If you're already using a notification daemon such as Dunst, Mako or SwayNC, you may have to stop them to prevent conflicts with HyprPanel.