# 6.3.Wayfire 混成器

Wayfire 是款旨在轻量化和可定制的合成器。它提供了多种功能，并恢复了之前发布的 Compiz Fusion 桌面的一些元素，在现代硬件上看起来非常美观。要启动 Wayfire，首先需要安装必要的软件包：

```sh
# pkg install wayfire wf-shell alacritty swaylock-effects swayidle wlogout kanshi mako wlsunset
```

`alacritty` 包提供了一个终端仿真器，但并不是完全必需的，因为其他终端仿真器，如 `kitty` 和 XFCE-4 `Terminal`，在 Wayfire 合成器下也已经过测试并确认可以正常运行。Wayfire 配置相对简单，它使用一个文件，用户可以查看该文件并进行自定义。首先，将示例文件复制到运行时环境配置目录，然后编辑该文件：

```sh
% mkdir ~/.config/wayfire
% cp /usr/local/share/examples/wayfire/wayfire.ini ~/.config/wayfire
```

对于大多数用户来说，默认配置应该已经足够。在配置文件中，像著名的 `cube` 之类的项目已被预配置，并且有说明帮助用户理解可用的设置。几个值得注意的基本设置如下：

```ini
[output]
mode = 1920x1080@60000
position = 0,0
transform = normal
scale = 1.000000
```

在这个示例中，配置文件中的输出屏幕应该是列出的模式和赫兹。例如，模式应该设置为 `widthxheight@refresh_rate`。`position` 将输出放置在指定的像素位置，默认设置对于大多数用户应该没问题。`transform` 设置背景变换，`scale` 将输出缩放到指定的缩放因子。这些选项的默认设置通常是可以接受的；更多信息可以参见文档。

如前所述，Wayland 是新的协议，并非所有应用程序都已经更新为完全兼容此协议。目前，`sddm` 似乎不支持在 Wayland 中启动和管理合成器。在这些示例中，使用了 `swaylock` 实用程序。配置文件包含选项，用于运行 `swayidle` 和 `swaylock` 来管理空闲和屏幕锁定。

定义系统空闲时应采取的操作的选项如下：

```ini
idle = swaylock
```

锁定超时通过以下几行进行配置：

```ini
[idle]
toggle = <super> KEY_Z
screensaver_timeout = 300
dpms_timeout = 600
```

第一个选项将在 300 秒后锁定屏幕，再过 300 秒后，通过 `dpms_timeout` 选项将屏幕关闭。

最后需要注意的是 `<super>` 键。大多数配置都提到了这个键，它是键盘上的传统 `Windows` 键。大多数键盘上都有这个超级键；如果没有，可以在配置文件中重新映射。例如，要锁定屏幕，按住 super 键和 <kbd>shift</kbd> 键，再按 <kbd>escape</kbd> 键。除非映射发生了变化，否则这将启动 `swaylock` 应用程序。`swaylock` 的默认配置将显示一个灰色的屏幕，但该应用程序非常可定制并且文档齐全。此外，由于安装了 `swaylock-effects` 版本，还可以使用例如模糊效果等多种选项，如下所示：

```sh
% swaylock --effect-blur 7x5
```

此外，还有 `--clock` 参数，用于在锁屏时显示时钟和日期。当安装了 [x11/swaylock-effects](https://cgit.freebsd.org/ports/tree/x11/swaylock-effects/) 时，默认的 pam.d 配置已包括在内。它提供了默认的选项，适合大多数用户使用。更高级的选项可通过 PAM 文档获得更多信息。

此时，是时候测试 Wayfire 并检查它是否能在系统上启动了。只需输入以下命令：

```sh
% wayfire -c ~/.config/wayfire/wayfire.ini
```

合成器现在应该启动，并在屏幕上显示背景图像以及顶部的菜单栏。Wayfire 会尝试列出安装的兼容应用程序并呈现在下拉菜单中。例如，如果安装了 XFCE-4 文件管理器，它将在下拉菜单中显示出来。如果某个特定应用程序兼容且足够重要，它可以通过 wayfire.ini 配置文件映射到一个键盘快捷键。Wayfire 还提供了一个名为 Wayfire Config Manager 的配置工具，可以通过下拉菜单启动，也可以通过终端输入以下命令启动：

```sh
% wcm
```

通过此应用程序，可以启用、禁用或配置各种 Wayfire 配置选项，包括合成特殊效果。此外，为了提供更友好的用户体验，可以在配置文件中启用背景管理器、面板和停靠应用程序：

```ini
panel = wf-panel
dock = wf-dock
background = wf-background
```

> **警告**
>
> 通过 `wcm` 所做的更改将覆盖在 wayfire.ini 配置文件中的自定义更改。因此，强烈建议备份 wayfire.ini 文件，以便在需要时恢复任何重要的更改。

最后，wayfire.ini 中列出的默认启动器是 [x11/wf-shell](https://cgit.freebsd.org/ports/tree/x11/wf-shell/)，如果用户愿意，也可以用其他面板替换它。