HyprPanel 安装与配置指南

HyprPanel 安装与配置指南

HyprPanel A Bar/Panel for Hyprland with extensive customizability. 项目地址: https://gitcode.com/gh_mirrors/hy/HyprPanel

1. 项目基础介绍

HyprPanel 是一个为 Hyprland 窗口管理器设计的面板，具有高度的可定制性。它使用 GTK3 进行构建，提供了一个美观且功能丰富的用户界面，用于显示系统信息、接收通知等。

2. 项目使用的关键技术和框架

• GTK3: 用于构建图形用户界面的库。
• AGS (Automatic Graphite Setup): 是一个帮助创建类似 macOS 系统界面的小工具，为 HyprPanel 提供了图形渲染和动画支持。
• Nerdfonts: 特殊的字体，包含图标字符，用于显示面板上的图标。

3. 项目安装和配置的准备工作

在开始安装 HyprPanel 之前，请确保您的系统满足以下要求：

• 操作系统: Linux (推荐 Arch Linux 或基于 Arch 的发行版)
• Hyprland 窗口管理器: 已安装并配置好
• 必要的依赖: 包括 ags, wireplumber, libgtop, bluez, bluez-utils, networkmanager, dart-sass, wl-clipboard, upower, gvfs 等依赖包

安装步骤

步骤 1: 克隆项目仓库

打开终端，运行以下命令克隆 HyprPanel 的 GitHub 仓库：

git clone https://github.com/Jas-SinghFSU/HyprPanel.git

步骤 2: 安装依赖

根据您的操作系统，使用以下命令安装必要的依赖：

对于 Arch Linux 或基于 Arch 的发行版：

sudo pacman -S --needed wireplumber libgtop bluez bluez-utils btop networkmanager dart-sass wl-clipboard brightnessctl swww python upower pacman-contrib power-profiles-daemon gvfs
yay -S --needed aylurs-gtk-shell-git grimblast-git wf-recorder-git hyprpicker matugen-bin python-gpustat hyprsunset-git

步骤 3: 编译安装 HyprPanel

进入克隆的项目目录，编译并安装 HyprPanel：

cd HyprPanel
meson setup build
meson compile -C build
meson install -C build

步骤 4: 安装字体

HyprPanel 使用 Nerdfonts 显示图标。在项目的 scripts 目录下运行以下脚本来安装字体：

./scripts/install_fonts.sh

安装字体后，需要重启 HyprPanel 以使字体生效。

步骤 5: 启动 HyprPanel

在终端中运行以下命令来启动 HyprPanel：

hyprpanel

或者，将 hyprpanel 添加到 Hyprland 配置文件 hyprland.conf 中的 exec-once 指令，以便在启动 Hyprland 时自动启动 HyprPanel。

完成以上步骤后，您应该已经成功安装并配置了 HyprPanel。现在可以开始使用并自定义您的面板了！

HyprPanel A Bar/Panel for Hyprland with extensive customizability. 项目地址: https://gitcode.com/gh_mirrors/hy/HyprPanel