安装 / 更新 / 卸载

安装

在开始前

以下仅提供用户层面的自定义。你必须自行配置好网络、蓝牙、显卡驱动（尤其是英伟达的）等。
推荐使用 EndeavourOS GNOME，因为这是作者使用的平台，能减少潜在的麻烦。（其他 Arch 系发行版也可以）（译注：原生 Arch Linux 实测完全可用）
若你仅有 8GiB 内存，你可能想配置 zram（或 SWAP），因为编译 Hyprland 耗费不少资源。

自动安装（仅 Arch 系发行版）

先克隆仓库，切换到 ii-ags 分支，再运行安装脚本：

t=~/.cache/dots-hyprland   # 避免把家目录当垃圾场
git clone https://github.com/end-4/dots-hyprland.git "$t" --filter=blob:none
git checkout ii-ags
"$t"/install.sh

为 NixOS 安装

当前，我们（还？）没有将配置提供为 flake。
但是你可以看看 end_4’s NixOS flake。
- 它包含了 home-manager 配置。你可能想查看 homes 文件夹。

为 Fedora 安装

看这里 https://github.com/EisregenHaha/fedora-hyprland
另请参阅此处 (较旧的讨论): https://github.com/end-4/dots-hyprland/discussions/840

手动安装（适用于各发行版）

克隆仓库并切换到其目录

t=~/.cache/dots-hyprland   # 避免把家目录当垃圾场
git clone https://github.com/end-4/dots-hyprland.git "$t" --filter=blob:none
cd "$t"

安装依赖的软件包：安装列于 scriptdata/dependencies.conf 中的所有软件包（部分来自 AUR）。对于 Arch Linux，你可以使用 AUR 助手，比如 yay。

将用户加入 video 与 input 组

sudo usermod -aG video,input "$(whoami)" # 若此命令出错，将 "$(whoami)" 替换为你的用户名

从源码构建 AGS（也有 AUR 包，但不够新）：运行 ./update-ags.sh 即可。
将目录 .config, .local 复制到你的家目录（在这之前注意检查与备份，因为这可能会意外地将你本来的配置文件覆盖掉）
用以下快捷键来开始使用
- Ctrl+Super+T ：选择一张图片作为壁纸
- Super+/ ：展示可用快捷键。开心地玩耍吧！

安装之后

自选项

手动导入

看看在目录 Extras 下是否有你感兴趣的。

浏览器的媒体集成

若想显示来自浏览器的媒体缩略图，获取扩展程序 “Plasma browser integration”

对于 Chromium
对于火狐

ZSH 的配色

将以下这行加入到你的 ~/.zshrc 中，以支持 zsh 的配色：

source ~/.config/zshrc.d/dots-hyprland.zsh

启动 Hyprland

要启动 Hyprland，可以使用 DM（显示管理器），也可以只使用 tty。

详情请参见 Hyprland wiki。

下面是一些额外提示。

如何在 `tty1` 登录后自动启动 Hyprland？

对于 ZSH 或 BASH，请在 ~/.zshrc 或 ~/.bashrc 的底部添加此行：

source ~/.config/zshrc.d/auto-Hypr.sh

对于 FISH，在 ~/.config/fish/config.fish 的底部添加此行：

source ~/.config/fish/auto-Hypr.fish

另附：如果你想通过 tty 启动 Hyprland，建议禁用 DM。

我是个新手。什么是 tty 和 DM？

这里有一个简短的介绍，虽然不完全正确，但可以让你快速理解。

你可以把“tty”看作是 Linux 系统的某种“基层”。通常有 7 个 tty： tty1 到 tty7。你可以按下 Ctrl+Alt+F<n> 切换到 tty<n> ，然后输入用户名和密码登录。

登录后，你就可以用命令启动图形环境，例如 Hyprland。实际上，大多数图形界面只能在登录后启动。

但如果我们希望登录界面本身就是图形化的呢？这就要提到 DM（Display Manager，显示管理器，也称为“LM”，即 Login Manager，登录管理器）就出现了。

一些常用的 DM：
- sddm：常配合 KDE Plasma 使用。
- gdm：常配合 Gnome 使用。
它在系统级别启用，并在系统启动后自动启动（此时尚未登录）。
- 在基于 systemd 的发行版中，DM 通常作为 systemd 服务启用。运行以下命令可查看已经启用的 DM。
```
grep 'ExecStart=' /etc/systemd/system/display-manager.service
```
  如果返回“没有那个文件或目录”，则说明没有启用 DM，或者这不是一个基于 systemd 的发行版。
它为你提供了一个图形界面，来登录和选择图形环境（如 Hyprland）。
- DM 如何知道哪些图形环境可用？
  - 通常，它会在路径 /usr/share/xsessions 中搜索 X11 的图形环境，在路径 /usr/share/wayland-sessions 中搜索 Wayland 的图形环境。
  - 这些目录下的桌面文件，就包含着图形环境的信息。

更新

之前自动安装的

cd 到仓库目录下。
运行 git pull 获取最新更新。
再次运行 ./install.sh，并跳过你不想要的步骤（尤其是 rsync ... 的那些，因为它们会覆盖位于目标路径下的你的所有文件）。

为了升级 AGS 本体（不含配置），运行 ./update-ags.sh 即可。

运行 ./install.sh -h 可查看更多用法。

之前手动安装的

cd 到仓库目录下。
运行 git pull 获取最新更新。
然后，与手动安装的过程类似，手动复制文件（夹）。