Hyprland 安装与使用指南

Hyprland 安装与使用指南

Debian-Hyprland 项目地址: https://gitcode.com/gh_mirrors/de/Debian-Hyprland

1. 安装指南

1.1 系统要求

• 操作系统: Debian 13 Trixie (Testing) 或 SID (unstable)，以及 Ubuntu 24.04 Noble Numbat。
• 权限要求: 不要以 sudo 或 root 用户运行安装脚本。
• 源配置: 编辑 /etc/apt/sources.list 文件，确保 deb-src 行未被注释。

1.2 安装步骤

1. 下载脚本: 将安装脚本下载到具有写权限的目录，例如用户主目录。
2. 编辑源列表: 使用以下命令编辑源列表文件，确保 deb-src 行未被注释。

   sudo nano /etc/apt/sources.list
   

3. 运行脚本: 运行安装脚本，按照提示完成安装。

1.3 注意事项

• 备份系统: 安装前建议使用 snapper 或 timeshift 备份系统。
• 登录管理器: 如果已安装 GDM，建议不要安装 SDDM，以免出现登录问题。
• NVIDIA 用户: 如果使用 NVIDIA GPU，建议在安装前卸载 nouveau 驱动。

2. 项目使用说明

2.1 启动 Hyprland

• 通过 TTY 启动: 在终端输入 Hyprland 启动。
• 通过登录管理器: 如果安装了 SDDM，可以通过登录管理器选择 Hyprland 会话启动。

2.2 配置文件

• 配置文件位置: Hyprland 的配置文件通常位于 ~/.config/hypr 目录下。
• 自定义配置: 可以根据需要修改配置文件，例如调整窗口管理、快捷键等。

2.3 常用快捷键

• 窗口管理: 使用 Super + 方向键 移动和调整窗口大小。
• 工作区切换: 使用 Super + 数字键 切换工作区。
• 应用启动: 使用 Super + 字母键 快速启动常用应用。

3. 项目 API 使用文档

3.1 API 概述

Hyprland 提供了丰富的 API，用于自定义和扩展其功能。API 文档可以在项目的 Wiki 中找到。

3.2 常用 API

• 窗口管理 API: 用于创建、移动和调整窗口大小。
• 工作区管理 API: 用于创建和管理工作区。
• 快捷键管理 API: 用于定义和绑定快捷键。

3.3 示例代码

以下是一个简单的示例，展示如何使用 Hyprland API 创建一个新窗口：

hyprctl dispatch exec "alacritty"

4. 项目安装方式

4.1 自动安装

• 脚本安装: 使用提供的安装脚本自动安装 Hyprland 及相关依赖。
• 配置文件: 安装过程中可以选择下载预配置的配置文件。

4.2 手动安装

• 依赖安装: 手动安装 Hyprland 所需的依赖包。
• 配置文件: 手动下载并配置 Hyprland 的配置文件。

4.3 安装后配置

• 网络管理: 安装完成后，如果需要网络管理工具，可以手动安装 network-manager-gnome。
• NVIDIA 配置: 如果使用 NVIDIA GPU，建议参考 Wiki 中的 NVIDIA 用户指南进行配置。

通过以上步骤，您可以顺利安装并使用 Hyprland，享受其强大的窗口管理功能。

Debian-Hyprland 项目地址: https://gitcode.com/gh_mirrors/de/Debian-Hyprland