hyprwm/hyprland-plugins
GitHub: hyprwm/hyprland-plugins
Hyprland 官方维护的插件合集，提供窗口美化、工作区管理、视觉特效等增强功能。
Stars: 1322 | Forks: 169
# hyprland-plugins
本仓库收录了 Hyprland 的官方插件。
# 插件列表
- borders-plus-plus -> 为窗口添加一或两个额外的边框
- csgo-vulkan-fix -> 修复 CS:GO 使用 `-vulkan` 时的自定义分辨率问题
- hyprbars -> 为窗口添加标题栏
- hyprexpo -> 添加类似 expo 的工作区总览
- hyprfocus -> hyprland 的 flashfocus
- hyprscrolling -> 为 hyprland 添加滚动布局
- hyprtrails -> 在移动的窗口后添加平滑轨迹
- hyprwinwrap -> xwinwrap 的克隆，允许将任何应用作为壁纸
- xtra-dispatchers -> 添加一些新的 dispatchers
# 安装
## 使用 `hyprpm` 安装
要安装这些插件，请在命令行运行：
```
hyprpm update
```
然后添加此仓库：
```
hyprpm add https://github.com/hyprwm/hyprland-plugins
```
接着使用以下命令启用所需的插件
```
hyprpm enable
```
有关配置选项，请参阅子目录中各自的 README。
更多详情请参见 [插件 wiki](https://wiki.hyprland.org/Plugins/Using-Plugins/#installing--using-plugins) 和 `hyprpm -h`。
## 在 Nix 上安装
要使用这些插件，建议您已在使用
[Hyprland flake](https://github.com/hyprwm/Hyprland)。
首先，将此 flake 添加到您的输入中：
```
inputs = {
# ...
hyprland.url = "github:hyprwm/Hyprland";
hyprland-plugins = {
url = "github:hyprwm/hyprland-plugins";
inputs.hyprland.follows = "hyprland";
};
# ...
};
```
`inputs.hyprland.follows` 确保插件始终使用您锁定的 Hyprland 版本构建，因此您永远不会遇到导致错误的版本不匹配问题。
完成后，您可以像这样使用 Home Manager 模块配置插件：
```
{inputs, pkgs, ...}: {
wayland.windowManager.hyprland = {
enable = true;
# ...
plugins = [
inputs.hyprland-plugins.packages.${pkgs.stdenv.hostPlatform.system}.hyprbars
# ...
];
};
}
```
如果您不使用 Home Manager：
```
{ lib, pkgs, inputs, ... }:
with lib; let
hyprPluginPkgs = inputs.hyprland-plugins.packages.${pkgs.stdenv.hostPlatform.system};
hypr-plugin-dir = pkgs.symlinkJoin {
name = "hyrpland-plugins";
paths = with hyprPluginPkgs; [
hyprexpo
#...plugins
];
};
in
{
environment.sessionVariables = { HYPR_PLUGIN_DIR = hypr-plugin-dir; };
}
```
并在 `hyprland.conf` 中添加
```
# 加载所有已安装的 plugins
exec-once = hyprctl plugin load "$HYPR_PLUGIN_DIR/lib/libhyprexpo.so"
```
# 贡献
欢迎提交带有修复的 issue 和 MR。
如果您想在此处添加您的插件，请预先联系 vaxry。
标签：C++, Home Manager, Hyprland, Nix Flake, NixOS, r/unixporn, UI美化, Wayland, 动态壁纸, 工作区管理, 平铺窗口, 开源, 插件, 数据擦除, 桌面特效, 桌面环境, 桌面自定义, 窗口管理器, 窗口装饰